Nyvarra Game Modules

A C++ game development module system for building a village builder game set in the swampy realm of Hollowfen, Vornak.

🎮 What This Is

This project contains standalone C++ modules that will eventually integrate into Unreal Engine. The modules are being developed independently to:

1. Learn C++ game development fundamentals
2. Test game logic without engine overhead
3. Build reusable modules that work anywhere
4. Integrate into Unreal when ready

🌳 Current Modules

Flora Module (Trees & Plants)

• TreeData - Data structures for tree species
• TreeDatabase - Catalog of all tree species in Hollowfen
• Tree (Coming soon) - Individual tree instances with growth, damage, harvesting

Species defined:

• 🫐 Blueberry Bush - Fast-growing shrub (5-year lifespan)
• 🌳 White Oak - Ancient hardwood (250-year lifespan, 3-4 generations)
• 🌲 Bald Cypress - Swamp giant (200-year lifespan, produces rare wood)
• 🪷 Lotus - Aquatic plant (3-year lifespan, medicinal & food)
• 🍄 Reishi Mushroom - Medicinal fungus (6-month lifespan)

📚 Documentation

• 01 - C++ Fundamentals - Learn C++ basics
• 02 - Project Structure - Understand the file layout
• 03 - Build System - How CMake works
• 04 - Compilation Process - Step-by-step compilation
• 05 - Module Relationships - How files connect
• 06 - Setup & Build - Installation instructions

🚀 Quick Start

Prerequisites

• C++ Compiler (Clang/GCC/MSVC)
• CMake 3.15+

Build

macOS/Linux:

mkdir build && cd build
cmake ..
make

Windows:

mkdir build && cd build
cmake ..
cmake --build . --config Release

Run example

cd build
./bin/example_tree_database

🎯 Project Goals

1. ✅ Phase 1 - Define tree species data structures (COMPLETE)
2. ⏳ Phase 2 - Create Tree class with lifecycle behaviors
3. ⏸️ Phase 3 - Integrate with Time & Weather systems
4. ⏸️ Phase 4 - Port to Unreal Engine

🌍 Game Setting

Hollowfen - A cursed swampland in Vornak where House Morrath must rebuild from ashes.

Read the full story: The Legend of Nyvarra

📖 Learning Resources

This project is designed for learning C++ game development. Each module is documented with:

• Comments explaining C++ concepts
• Comparisons to TypeScript (for web developers)
• Step-by-step explanations

🤝 Contributing

This is a learning project! Feel free to explore, modify, and learn from the code.

📝 License

Educational/Personal Project