Minimap & Match Engine is a high-performance, modular system engineered specifically for the Cowax MC multiplayer server environment. It combines a real-time interactive map rendering pipeline (powered by custom OpenGL matrix stacks) with a deterministic game mode state machine, zone capture mechanics, and a tactical death screen kit selection framework.
Note
Designed and built exclusively for Cowax MC.
| Tactical Fullscreen Map & Loadout Selector | In-Game Minimap Radar Overlay | Custom Settings & Tuning GUI |
|---|---|---|
 |
 |
 |
- Custom OpenGL Rendering: Utilizes low-level projection and transformation matrices for smooth real-time map zooming, panning, and rotation.
- Asynchronous Tile Caching: Offloads chunk scanning and tile generation to background worker threads, preventing main thread rendering hitches.
- Level of Detail (LOD): Implements dynamic LOD rendering techniques for high FPS under heavy server load.
- HUD & Radar: Customizable minimap HUD overlay featuring player position indicators, squad teammate markers, objective beacons, and zone progress meters.
- Deterministic State Machine: Manages multi-stage assault match flows, phase transitions, and capture order validation.
- Overtime & Wave Respawns: Configurable wave-based respawn timing systems and overtime mechanics.
- Base & Objective Control: Real-time zone capture progress calculation with packet synchronization.
- Interactive Map Overview: Fullscreen death screen GUI (
MapDeathScreen) allowing players to select active team spawn points and bases. - Kit Loadout Customization: Integrated primary/secondary weapon selection and attachment configuration panels.
- LuckPerms Integration: Server-side permission validation for donor kits and restricted loadouts.
- Custom Packet Pipeline: Bi-directional packet synchronization for real-time match state, teammate coordinates, and timer overlays.
- Performance Controls: Client-configurable minimap refresh rates, rendering distance, and LOD settings.
- Java: JDK 17 or higher
- Build Tool: Gradle (wrapper included)
- Mod Loader: Minecraft Forge 1.20.1 (MDK 47.2.0+)
git clone https://github.com/covalscy/minimapMod.git
cd minimapMod
./gradlew buildThe compiled output JAR will be generated in build/libs/.
This project is licensed under a Source-Available & Educational License. You are free to inspect and study the codebase for educational and evaluation purposes. Copying, extracting code for other projects, creating derivative works, or commercial distribution is strictly prohibited. See the LICENSE file for complete details.