MineMonopoly is a multiplayer online Monopoly game designed for extensive customization, allowing users to create and play on unique maps with custom rules. It targets game enthusiasts and developers looking to build bespoke board game experiences. The project offers a powerful, AI-assisted map editor and a low-latency P2P multiplayer architecture, significantly lowering the barrier to entry for custom game creation.

How It Works

The game employs a hybrid P2P architecture where a central server handles authentication and room routing, while core game logic executes independently within a Web Worker on the host client. Player-to-player communication is facilitated by WebRTC (PeerJS) for low-latency direct connections, with coturn providing STUN/TURN relay services for NAT traversal. A key differentiator is the integrated map editor, featuring a visual drag-and-drop interface for board design and event scripting. This editor also includes an MCP service that leverages AI to generate game content like characters, cards, and events from natural language prompts, streamlining custom gameplay development.

Quick Start & Requirements

• Primary Install: Clone the repository (git clone), then install dependencies using pnpm install.
• Prerequisites: Node.js 20+, pnpm 10.10.0+, MySQL 8.0+. Docker is recommended for deployment.
• Development: Run pnpm dev-client, pnpm dev-server, pnpm dev-editor for respective components.
• Docker Deployment: Configure docker/.env and run docker compose -f docker/docker-compose.yml up -d after creating a network (docker network create monopoly-network).
• Links: Project repository: https://github.com/FatPaper-1874/mine-monopoly

Highlighted Details

• Visual Map Editor: Intuitive drag-and-drop interface for creating game boards, configuring plots, and scripting events with TypeScript/JavaScript.
• AI-Assisted Content Generation: Built-in MCP service allows AI to generate game elements (characters, cards, events, modifiers) from natural language descriptions.
• Hybrid P2P Architecture: Central server for coordination, Web Worker for isolated game logic, and WebRTC for direct, low-latency player communication.
• Multi-Platform Support: Clients available for Web browsers and Windows (via Electron). The map editor is also a Windows application.

Maintenance & Community

The project welcomes contributions via Issues and Pull Requests, with detailed guidelines available in CONTRIBUTING.md. While specific community channels like Discord or Slack are not explicitly mentioned, the contribution process is outlined.

Licensing & Compatibility

The project is licensed under the GNU General Public License v3.0 (GPL v3). This is a strong copyleft license, meaning derivative works must also be licensed under GPL v3, potentially imposing restrictions on integration with closed-source or proprietary software.

Limitations & Caveats

A mobile client is planned but not yet developed. The map editor is currently limited to Windows platforms. The GPL v3 license may restrict its use in certain commercial or closed-source contexts.