How mkg789/robot_wars_game works
Robot Wars is a browser-based robot builder. Users choose a foundation, place compatible motors in generated mounting zones, assign wheels to motor shafts, and inspect or edit the assembled robot in a 3D viewport. The single React application coordinates the staged workflow and Zustand state; builder data and mounting calculations support it, while viewport components render the resulting parts. The README is empty, so capability coverage and relationships here rely on the supplied source excerpts and index; unsampled UI behavior is not inferred.
Main entry points: robot.types.ts Robot model types · App.tsx Build interface · RobotScene.tsx Robot scene · RobotObject.tsx Robot part renderer
Components 17
Build workflow
- Build interface
robot-wars/src/App.tsx - Robot state
robot-wars/src/store/robotStore.ts
Robot builder
- Robot model types
robot-wars/src/features/robot-builder/types/robot.types.ts - Foundation options
robot-wars/src/features/robot-builder/data/foundationModels.ts - Initial robot
robot-wars/src/features/robot-builder/data/initialRobot.ts - Mount points
robot-wars/src/features/robot-builder/data/mountingPoints.ts - Motor catalogue
robot-wars/src/features/robot-builder/data/motorCatalogue.ts - Wheel catalogue
robot-wars/src/features/robot-builder/data/wheelCatalogue.ts - Shaft mounting math
robot-wars/src/features/robot-builder/logic/mounting.ts - Motor mounting zones
robot-wars/src/features/robot-builder/logic/mountingZones.ts - Wheel positioning
robot-wars/src/features/robot-builder/logic/wheelMounting.ts
3D viewport
- Robot scene
robot-wars/src/components/viewport/RobotScene.tsx - Robot part renderer
robot-wars/src/components/viewport/RobotObject.tsx - Chassis geometry
robot-wars/src/components/viewport/ChassisModel.tsx - Motor geometry
robot-wars/src/components/viewport/MotorModel.tsx - Wheel geometry
robot-wars/src/components/viewport/WheelModel.tsx
Other components
- Robot builder user
Connections 28
- Robot builder user → Build interface: configures build
robot-wars/src/App.tsx - Build interface → Robot state: reads and updates
robot-wars/src/App.tsx - Build interface → Robot scene: renders scene
robot-wars/src/App.tsx - Build interface → Motor mounting zones: generates zones
robot-wars/src/App.tsx - Robot state → Motor mounting zones: generates zones
robot-wars/src/store/robotStore.ts - Robot state → Shaft mounting math: positions motor shafts
robot-wars/src/store/robotStore.ts - Robot state → Wheel positioning: positions wheels
robot-wars/src/store/robotStore.ts - Robot scene → Robot state: reads and updates
robot-wars/src/components/viewport/RobotScene.tsx - Robot scene → Robot part renderer: renders parts
robot-wars/src/components/viewport/RobotScene.tsx - Robot scene → Motor mounting zones: generates zones
robot-wars/src/components/viewport/RobotScene.tsx - Robot scene → Shaft mounting math: positions shafts
robot-wars/src/components/viewport/RobotScene.tsx - Robot scene → Wheel positioning: positions preview wheels
robot-wars/src/components/viewport/RobotScene.tsx - Robot part renderer → Chassis geometry: renders chassis
robot-wars/src/components/viewport/RobotObject.tsx - Robot part renderer → Motor geometry: renders motors
robot-wars/src/components/viewport/RobotObject.tsx - Robot part renderer → Wheel geometry: renders wheels
robot-wars/src/components/viewport/RobotObject.tsx - Robot part renderer → Wheel catalogue: looks up category
robot-wars/src/components/viewport/RobotObject.tsx - Build interface → Foundation options: reads choices
robot-wars/src/App.tsx - Build interface → Motor catalogue: reads choices
robot-wars/src/App.tsx - Build interface → Wheel catalogue: reads choices
robot-wars/src/App.tsx - Robot model types → Foundation options: types definitions
robot-wars/src/features/robot-builder/data/foundationModels.ts - Robot model types → Initial robot: types robot data
robot-wars/src/features/robot-builder/data/initialRobot.ts - Robot model types → Mount points: types mount data
robot-wars/src/features/robot-builder/data/mountingPoints.ts - Robot model types → Motor catalogue: types definitions
robot-wars/src/features/robot-builder/data/motorCatalogue.ts - Robot model types → Wheel catalogue: types definitions
robot-wars/src/features/robot-builder/data/wheelCatalogue.ts - Shaft mounting math → Wheel positioning: provides shaft offset
robot-wars/src/features/robot-builder/logic/wheelMounting.ts - Robot model types → Shaft mounting math: types parts
robot-wars/src/features/robot-builder/logic/mounting.ts - Robot model types → Motor mounting zones: types zones
robot-wars/src/features/robot-builder/logic/mountingZones.ts - Robot model types → Wheel positioning: types parts
robot-wars/src/features/robot-builder/logic/wheelMounting.ts