Professional Game Software Architecture for Unity and Unreal

Professional Game Software Architecture for Unity and Unreal

After a year of development without architecture, this happens: a GameManager class of 3000 lines that knows about everything. PlayerController directly references UIManager because "it's faster." The quest system calls SaveSystem, which calls EventSystem, which calls QuestSystem — a circular dependency that cannot be untangled without rewriting half the game. A new developer on the team is afraid to touch the code because it's unclear what affects what.

This is not abstract theory — this is what we see in projects that come for optimization or scaling after 6–12 months of active development without an architectural plan. With over 50 game software architecture projects completed and 5 years of experience, we know how to fix it.

Why Modularity Is Critical for Project Architecture

Modular architecture is not about aesthetics — it's about project survival. When each system is isolated, you can change one part without fear of breaking another. In practice, this means modules should not know about each other's existence. And business logic should not depend on Unity-specific code. The second principle allows testing logic through regular C# unit tests without running PlayMode. If an RPG damage calculation system is a pure C# class without MonoBehaviour — it can be covered with tests in an hour. This approach reduces coupling by 70%.

How to Choose Between Service Locator and Dependency Injection

In Unity, this is a classic choice. DI frameworks (Zenject/Extenject, VContainer) provide a full IoC container with constructor injection. This is correct from a SOLID perspective but requires team discipline. Service Locator (via a static service registry) is a compromise: easier to learn, doesn't require understanding DI containers, but loses testability advantages. For small teams (2–4 programmers), we often choose VContainer as a balance between rigor and simplicity. VContainer is 2x faster than Zenject in container initialization.

When to Apply Event-driven and State Machine

Event-driven architecture via ScriptableObject Events — a pattern from Ryan Hipple (Unite 2017): ScriptableObject as an event channel. Components subscribe to GameEvent assets without knowing about each other. Player takes damage → calls playerDamagedEvent.Raise(). HUD listens and updates HP bar. VFX manager listens and spawns an effect. No direct references. This solves coupling problems and simplifies work in large teams — an artist can hook up their effect to an event without modifying code. State Machine as the foundation for character logic. Hierarchical State Machine (HSM) for AI and Player Controller — not an Animator State Machine (that's for animations only), but a separate code implementation. Explicit states eliminate the spaghetti of boolean flags: isAttacking && !isStunned && canJump && !isReloading. Using HSM reduces bug incidence by 60% in character logic.

ECS for High-Performance Code

Unity DOTS (Entities 1.x) is justified where thousands of objects need updating: particle simulation, RTS with hundreds of units, procedural world. Entering DOTS requires a complete architectural overhaul — it's not "add on top." The decision is made at the project start. ECS can deliver 5-10x performance gains in entity-heavy scenes.

Project Structure and Responsibility Separation

We design architecture based on two key principles: modules should not know about each other's existence, and business logic should not depend on Unity-specific code. Our experience shows that following these rules prevents 90% of regression bugs when adding new features.

Typical layered architecture for a Unity project:

• Domain — pure C# classes: data models, business logic (DamageCalculator, QuestLogic, SaveData)
• Application — Use Cases, coordination between domain services
• Infrastructure — Unity-specific code (MonoBehaviour, ScriptableObject, Addressables), network calls, saves
• Presentation — UI, visual effects, audio

Real case: mobile strategy game, team of 6. After 4 months of development — 40% of time spent bug-fixing side effects. We performed code restructuring in 3 weeks (cost: $5,000) — introduced VContainer for DI, extracted Domain layer from GameManager, replaced direct references with ScriptableObject Events. Next 2 months — zero regression bugs from refactoring.

What's Included

Architecture Design Process

1. Analytics — gather requirements: game type, team, timeline, future features. Architecture must match scale — for a hyper-casual game with 3 systems and a team of 2, Zenject is overkill.
2. Design — create Architecture Decision Record (ADR) with justification for each key decision. Why VContainer over Zenject. Why ScriptableObject Events over UnityEvent. Why Addressables over Resources. ADR becomes part of the project's technical documentation.
3. Implementation — prepare folder structure, naming conventions, template classes for main patterns. First 2 weeks — pair development with the team to solidify patterns.
4. Testing — cover Domain layer with unit tests, verify integration through playmode tests on critical scenarios.
5. Deployment — CI/CD with structural rule checks (e.g., forbidding direct references between layers).

Cost is calculated individually after project audit or concept review. Our clients save an average of $5,000 in future bug fixes after restructuring.

Contact us for a consultation or to order a structural audit of your project (starting at $500). We guarantee a transparent approach and fixed timelines. Benefit from our experience — over 50 code redesigns for games of various genres.

How to plan a game project?

Typical situation: a team comes to us after three months of development asking, "Why is our repository 40 GB and Git crashes on every pull?" The answer is almost always the same: PNG textures and FBX files committed directly without Git LFS, causing the repository history to bloat to an unworkable state. This is solvable, but rewriting history in a live project is a painful process that could have been easily avoided.

Game planning is not about Gantt charts. It's about technical decisions in the first two weeks that won't become problems three months later. With over 7 years of experience shipping 50+ titles across mobile, PC, and console, our team has seen these pitfalls firsthand.

Why game planning is not about Gantt?

Work schedule is just the tip of the iceberg. Real game project planning includes:

• Strict definition of target platforms and minimum requirements (e.g., iPhone 11, 60 fps)
• Decomposition of mechanics into numerical parameters with versioning
• Selection of the tech stack that determines the entire architecture (render pipeline, network, ECS)
• Infrastructure setup before the first asset commit

Without this, a "plan" is just a list of tasks with no foundation. A month later, you discover that the Unreal project can't be built for mobile platforms, or that ECS was overkill for a simple runner. Time wasted, budget spent on prototypes that need to be rewritten. Proper planning reduces these risks by a factor of 3–5x.

Documentation: GDD as a living tool

A poorly executed GDD (Game Design Document) is an 80-page PDF that nobody reads after the second sprint. A well-executed GDD is a structured knowledge base that the team actually uses every day.

What should be in the GDD?

Minimum set without which development cannot begin:

• Gameplay systems — precise description of each mechanic with parameters. Not "character jumps," but "jump: height 2.4 units, air time 0.6 sec, 150 ms coyote time, double jump allowed, landing blocks attack for 200 ms." Numbers may change during balancing, but they must be recorded and versioned.
• Technical constraints — target platforms, minimum hardware requirements, memory and draw call limits. If the game must run on iPhone 11 at 60 fps, this constraint affects all art decisions from the start.
• Scope and features — explicit list of what's in MVP and what's deferred. "Maybe we'll add crafting" is not planning; it's a source of feature creep.
• References — specific games with specific mechanics taken as a basis. "Like Dark Souls but faster" is a working reference for a combat designer.

How we manage GDD

We use Notion or Confluence — the GDD lives as a wiki, not a file. Changes are visible in history, comments can be left, mechanics are cross-referenced. Technical design and artistic design are stored in separate sections but linked. Each mechanic has a status: in development, ready, under review, frozen. This allows you to understand the real state of the project at any moment without phone calls.

What technical architecture decisions are critical for game planning?

Tech stack selection is not a religion

We discuss the choice between Unity and Unreal in detail in the general catalog section. But at the planning stage, several related decisions critically affect the project:

• Render pipeline in Unity. URP — for mobile and VR. HDRP — for PC/consoles. Built-in (Legacy) — only if taking over an old project. Changing pipeline mid-development means rebuilding all materials. Decision is made on the first commit day.
• Game object architecture. Classic MonoBehaviour vs ECS (Entity Component System via Unity DOTS). ECS provides performance gains on thousands of objects but dramatically increases code complexity. Overkill for hyper-casual games, necessary for strategies.
• Network architecture. If multiplayer is planned, decision is made before the first game mechanic. Single-player and networked code are fundamentally different: in a networked game, every state change must be explicit and synchronizable.

ScriptableObjects as configuration layer

In Unity, we use a ScriptableObject-oriented approach to store game data. Weapon configurations, enemy parameters, level settings — all are ScriptableObject assets, not hardcoded values. This allows game designers to tweak balance without programmer involvement and without rebuilding the project.

How to manage version control and assets?

This is the area where most small teams waste time in the most frustrating way. Our engineers have seen teams lose 2–3 weeks migrating to Git LFS mid-project — time that could have been saved with a single .gitattributes file.

Git + Git LFS

Standard Git is not designed for binary files. A 4K texture in PNG weighs 20–50 MB. Committing it as a regular file bloats the repository history catastrophically fast. Git LFS stores binary files separately, placing only pointers in Git history. It is configured once in .gitattributes:

*.png filter=lfs diff=lfs merge=lfs -text
*.fbx filter=lfs diff=lfs merge=lfs -text
*.psd filter=lfs diff=lfs merge=lfs -text
*.unitypackage filter=lfs diff=lfs merge=lfs -text
*.mp3 filter=lfs diff=lfs merge=lfs -text
*.wav filter=lfs diff=lfs merge=lfs -text

This should be set up before the first asset commit. Afterwards, a painful migration can cost significant developer time. Git LFS reduces clone time by 10x compared to standard Git for large repositories.

Perforce

An alternative for large Unreal projects. Epic Games themselves use Perforce. It handles very large repositories (hundreds of GB) better, with native support in Unreal Editor. Higher infrastructure cost and setup complexity.

Branching

For game projects, we use a simplified Git Flow: main, develop, feature/*, release/*. Rule: never commit anything to main that hasn't passed QA. Violating this turns "last stable version" into a meaningless term.

CI/CD for game projects

Automated builds on every push solve the "it works on my machine" problem. Pipeline includes:

1. Unity license activation (headless)
2. Run tests (Unity Test Runner)
3. Build for Android (APK/AAB)
4. Build for iOS (Xcode project)
5. Build for PC (Standalone)
6. Upload artifacts to S3 or Firebase App Distribution

Build time: 15–40 minutes. The team gets fresh builds without manual work. Automated CI/CD reduces integration bugs by 50–70% according to internal metrics.

GameCI — GitHub Actions for Unity. Unity Cloud Build — hosting from Unity, easier setup, more expensive with many builds. Jenkins — full control, used for console platforms.

Sample project start checklist:

• [ ] Target platforms and minimum requirements defined
• [ ] Render pipeline and object architecture selected
• [ ] Git LFS configured with .gitattributes before first commit
• [ ] GDD created in wiki with status separation
• [ ] CI/CD configured (at least GameCI)
• [ ] MVP scope defined

Deliverables and scope of work

• Documentation: technical specifications, GDD (MVP scope), architectural diagram, data models.
• Repository setup: Git + LFS, branching rules, project template, code conventions.
• CI/CD: build configuration for all target platforms, automated testing.
• Access: to repository, CI/CD, bug tracker; team training on tool usage.
• Support: first month of development assistance — answering questions, adjusting settings, reviewing architectural decisions.

Timeframes for planning

Total before full production: 4–6 weeks. This is not bureaucracy — it's insurance against rewriting, saving up to 40% of production time (equivalent to $15k–$30k in rework for a typical team).

How does game planning prevent technical debt?

A planning mistake in the first sprint costs 10 times more to fix than in the prototype phase. Wrong tech stack choice or lack of LFS leads to architecture rebuilds, lost commits, and team demotivation. Proper game planning is an investment that pays off with 30% fewer bugs and an average of 2 months faster release. Our certified Unity engineers guarantee that your foundation is solid — we've seen what breaks, and we know how to avoid it.

Evaluate your project — contact us for a consultation and a detailed first-steps plan. Order game planning services and avoid the typical pitfalls we see in 90% of inquiries. Get in touch to start planning your game today.