warfactoryracine/docs/engines/designer

Designer-Engine Documentation

Engine Overview

Designer-Engine handles autonomous vehicle conception for AI companies and provides design assistance for players.

Key Responsibilities:

• Vehicle design generation (1-2 designs globally per tick)
• Component grid placement and validation
• Blueprint management and evolution
• AI-driven design optimization

Core Systems

Vehicle Design System

From systeme-militaire.md:

• Grid-based Component Placement: Irregular chassis shapes with precise component positioning
• Interface Mechanics: Pick/place with A/E rotation, R for snap toggle
• Template Support: Save/load vehicle blueprints
• Validation: Ensure design constraints (weight, power, armor coverage)

Design Evolution

From arbre-technologique.md:

• Progressive Evolution: T-72 → T-80 → T-90 design lineage
• Technology Integration: New components unlock through research
• Doctrine Adaptation: Designs adapt to military doctrine preferences

Performance Requirements

From architecture-technique.md:

• Design Rate: 1-2 vehicle designs globally per tick maximum
• Autonomous Operation: AI companies generate designs independently
• Player Assistance: Provide design suggestions and optimization

Engine Architecture

Core Classes

class DesignerEngine {
    // Design management (1-2 designs globally per tick)
    std::unique_ptr<VehicleDesign> createDesign(const std::string& type);
    void validateDesign(const VehicleDesign& design);
    void saveBlueprint(const VehicleDesign& design, const std::string& name);

    // Blueprint evolution
    void evolveBlueprintsFromExisting(); // T-72 → T-80 → T-90

    // Performance monitoring
    double getDesignRate() const;
    size_t getPendingDesigns() const;
};

Communication with Other Engines

• War-Engine: Receives combat effectiveness feedback for design optimization
• Economy-Engine: Gets cost constraints and production capabilities
• Intelligence-Engine: Receives reconnaissance data on enemy designs
• MacroEntity-Engine: Gets company design preferences and doctrine
• Event-Engine: Processes breakthrough events for new technologies

Key Design Documents

• systeme-militaire.md - Vehicle design system details
• arbre-technologique.md - Technology progression and design evolution
• architecture-technique.md - Performance specifications
• mecaniques-jeu.md - Research integration

Implementation Notes

• Focus on autonomous AI design generation
• Player assistance tools for design optimization
• Blueprint persistence and sharing system
• Technology integration from research breakthroughs