This repository curates representative code samples from Cargo Shipper, a sci-fi crew-management and starship simulation game currently in development.
The showcased files demonstrate the project’s architecture and approach to AI behavior, mission control, ship systems, inventory/equipment handling, and event-driven design.
🎥 Gameplay Playlist:
Cargo Shipper Gameplay Demos (Alpha Build)
| Folder | Description |
|---|---|
| CrewAI/ | Crew behavior and AI role logic, including engineering, medical, and firefighting subsystems. |
| Missions/ | Mission sequencing framework with deterministic site generation, complications integration, and objective flow control. |
| ShipSystems/ | Ship AI and flight logic, including ShipBrain state transitions and autonomous navigation behaviors. |
| InventoryAndEquipment/ | Gear management, equipment lockers, and skill-based tool handling with reservation-safe retrieval. |
| EventsAndArchitecture/ | Core game bootstrap and event hub architecture linking services and UI systems. |
| Stubs/ | Minimal interface/class definitions that allow these showcase excerpts to compile cleanly and display with correct syntax highlighting. |
- Each
.Showcase.csfile is a trimmed excerpt of a larger system from the live project. - The goal is to highlight design clarity, modularity, and AI decision logic, not to provide full implementations.
- Internal systems, asset data, and editor scripts have been omitted or abstracted for safety and brevity.
- The optional
ShowcaseStubs.csfile is included only for clarity and syntax highlighting — the code compiles fine without it.
Each showcase corresponds to gameplay moments visible in the
Cargo Shipper Gameplay Demos (Alpha Build).
These samples are shared for architectural reference and educational review only.
Browse each folder for a focused excerpt:
- CrewAI: Autonomous role logic and AI behavior trees.
- Missions: Objective sequencing and deterministic event flow.
- ShipSystems: Ship AI, flight control, and tactical state logic.
- Inventory: Equipment management and locker reservation systems.
- Events: GameRoot bootstrap, service wiring, and event broadcasting.
- Deterministic + Emergent Gameplay: Seeded RNG scopes for reproducible yet varied encounters.
- Event-Driven Architecture: Decoupled systems communicate via lightweight domain events.
- AI Crew Autonomy: Engineers, medics, and gunners act independently based on skill and priority logic.
- System Interdependence: Ship systems, missions, and crew behavior interlock seamlessly.
- Diegetic UX: Game information appears on in-world panels and ship interfaces for immersion.
All source code in this repository is © 2025 Nigel Wallingford.
The code is provided for educational and portfolio review purposes only.
- You may view and reference these files for evaluation or learning.
- You may not copy, redistribute, or use them in derivative works without permission.
- All original rights to Cargo Shipper remain with the author.
Created by Nigel Wallingford
Software Engineer & Game Developer
Cargo Shipper is an original independent project currently in active development.