Milsim Geoint

Milsim Geoint is a real-time strategy and geospatial intelligence military simulation game. It leverages CesiumJS to provide a high-fidelity 3D globe visualization where players command friendly forces, manage bases, and engage hostile threats.

Features

• 3D Globe Visualization: Full 3D map interface using CesiumJS.
• Unit Management: Command various units including Vipers (Fighters) and Scouts.
• Base Construction: Strategically build Airbases, Naval Bases, Outposts, and Oil Rigs.
• Resource Management: Manage Credits and Oil to fund your operations and unit production.
• Real-time Combat: Engage hostile units with air-to-air missiles.
• Comms Log: Monitor real-time events and alerts through a communications log.
• Dynamic Day/Night Cycle: (Implicit in Cesium's realistic rendering).

Getting Started

Prerequisites

• Node.js (v18 or higher recommended)
• npm or yarn

Installation

1. Clone the repository.

2. Install dependencies:

   npm install

3. Cesium Access Token: This project uses CesiumJS which requires an access token.

   • Create a .env file in the root directory.

   • Add your Cesium Ion Access Token:

     VITE_CESIUM_ION_TOKEN=your_cesium_token_here
     

Running the Development Server

To start the local development server:

npm run dev

Open your browser and navigate to the URL shown in the terminal (usually http://localhost:5173).

Building for Production

To build the application for production:

npm run build

This will compile the TypeScript code and bundle the assets into the dist directory.

How to Play

1. Placement Phase

• At the start of the game, you must place your National HQ (Alpha-1).
• Click on the map to deploy it. This establishes your presence and starts the resource generation.

2. Active Phase

• Economy:
  • Credits: Generated by Airbases and Naval Bases. Used for construction and production.
  • Oil: Generated by Oil Rigs. Used for unit production and fuel.
• Construction:
  • Use the sidebar to select buildings.
  • Airbase: Allows production of air units (Vipers). High cost, high credit income.
  • Naval Base: High cost, high credit income.
  • Outpost: Low cost, provides sensor coverage and spawns Scouts.
  • Oil Rig: Generates Oil.
• Unit Production:
  • Select an Airbase to produce units like the Viper fighter jet.
• Combat:
  • Select your units to view their sensor rings (White: Sensor, Red: Weapon Range).
  • Identify hostile contacts (Red markers).
  • Once a hostile is identified and within weapon range, use the "FIRE" button to launch missiles.
• Controls:
  • Left Click: Select Unit / Base / Place Building.
  • Right Click: Cancel Build / Deselect.
  • Map Navigation:
    • Left Click + Drag: Pan the map.
    • Right Click + Drag: Zoom in/out.
    • Middle Click + Drag: Tilt and rotate.
  • Escape: Pause / Resume the game.

Technologies Used

• React: UI Library.
• Vite: Build tool and development server.
• TypeScript: Type safety and developer experience.
• CesiumJS: 3D Globe and map visualization.
• Tailwind CSS: Utility-first CSS framework.
• Lucide React: Icon library.

License

MIT