// PLAY_NOW_ALPHA

🎮 Easiest Way to Play: Use third-party AI code assistants that support MCP (Model Context Protocol). Just clone the repo, configure the servers, and start playing!

Compatible Platforms

🤖 Claude Desktop

Official Anthropic desktop app with native MCP support

Features: Direct Claude integration, built-in MCP server management, native desktop experience

Download Claude Desktop →

🦘 KiloCode.ai

AI-powered coding assistant with MCP support

Features: Free models available, bring your own API key, VS Code extension

Visit KiloCode.ai →

🦙 RooCode.com

Full-featured AI development environment

Features: Free tier available, multiple AI providers, built-in MCP support

Visit RooCode.com →

Note: Claude Desktop has native MCP configuration. VS Code extensions (KiloCode/RooCode) require separate installation. Follow their respective setup guides, then return here to configure the MCP servers.

// PREREQUISITES

Before you begin, make sure you have:

  • Node.js: Version 16 or higher (Download here)
  • Git: For cloning the repository (Download here)
  • VS Code: With RooCode or KiloCode extension installed
  • AI Provider: API key for Claude, OpenAI, or use free models (depending on your platform)

Platform-Specific Setup

RooCode: Install from VS Code Marketplace or via CLI:

code --install-extension RooVeterinaryInc.roo-cline

KiloCode: Follow setup instructions at kilocode.ai

// INSTALLATION

1 Clone the Repository

git clone https://github.com/Mnehmos/rpg-mcp-servers.git cd rpg-mcp-servers

2 Install Game State Server

cd game-state-server npm install npm run build

3 Install Combat Engine Server

cd ../combat-engine-server npm install npm run build

4 Optional: Configure Environment Variables

Create .env files in each server directory if you want custom settings:

game-state-server/.env:

DATABASE_PATH=./data/my_rpg.db PORT=3001

combat-engine-server/.env:

PORT=3002

// CONFIGURATION

Configure MCP Settings

Add the following to your MCP settings file (location varies by platform):

Claude Desktop: Edit claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

RooCode: Typically at %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json

KiloCode: Check KiloCode documentation for MCP settings location

{ "mcpServers": { "rpg-game-state": { "name": "rpg-game-state-server", "command": "node", "args": ["dist/index.js"], "cwd": "PATH_TO_YOUR_PROJECT/rpg-mcp-servers/game-state-server", "enabled": true, "alwaysAllow": [ "create_character", "get_character", "get_character_by_name", "list_characters", "update_character", "add_item", "get_inventory", "remove_item", "update_item", "save_world_state", "get_world_state", "update_world_state", "create_npc", "create_npc_group", "get_npc", "list_npcs", "update_npc", "remove_npc", "create_encounter", "add_to_encounter", "get_encounter_state", "get_active_encounter", "start_turn", "end_turn", "next_turn", "consume_action", "end_encounter", "apply_damage", "save_story_progress", "add_quest", "get_active_quests", "update_quest_state", "assign_quest_to_character" ] }, "rpg-combat-engine": { "name": "rpg-combat-engine-server", "command": "node", "args": ["dist/index.js"], "cwd": "PATH_TO_YOUR_PROJECT/rpg-mcp-servers/combat-engine-server", "enabled": true, "alwaysAllow": [ "roll_dice", "roll_check", "attack_roll", "initiative_roll", "damage_roll", "saving_throw", "use_reaction", "use_legendary_action", "trigger_lair_action", "execute_multiattack", "initialize_battlefield", "place_creature", "move_creature", "check_line_of_sight", "get_area_effect_targets", "get_tactical_summary", "check_flanking", "check_height_advantage", "describe_battlefield", "describe_detailed_tactical_situation", "generate_battlefield_map", "get_combat_log", "clear_combat_log" ] } } }

⚠️ Important: Replace PATH_TO_YOUR_PROJECT with the actual path to your cloned repository!

// YOUR_FIRST_GAME

1 Restart Your Platform

Restart VS Code (or reload window) to ensure MCP servers are loaded.

2 Start a Conversation

Open your AI assistant (RooCode/KiloCode chat) and say:

"I want to create a new D&D 5e character and start an adventure!"

3 Let the AI Guide You

The AI will use the MCP tools to:

  • Create your character sheet
  • Roll for abilities and stats
  • Set up inventory and equipment
  • Initialize combat encounters
  • Generate battlefield visualizations

Example Commands to Try

  • "Create a level 5 elf ranger named Lyra"
  • "Roll initiative for combat"
  • "Show me the battlefield map"
  • "Attack the nearest enemy"
  • "Cast fireball at coordinates (10, 5)"

Features You Can Explore

  • Character Creation: Full D&D 5e character sheets with all abilities
  • Combat: 3D spatial combat with elevation, cover, and line of sight
  • Spellcasting: Complete spell system with slots and concentration
  • Inventory: Track items, equipment, and treasure
  • NPCs: Create allies and enemies with full stat blocks
  • World State: Persistent world that remembers your adventures
  • Quests: Track objectives and rewards

// NEED_HELP?

Resources

Tips for Best Experience

  • Be specific with your commands (e.g., "Roll 1d20+5 for attack" instead of "attack")
  • Ask the AI to show you the battlefield map frequently during combat
  • Use tactical commands like "check line of sight to goblin"
  • Save your progress with "save world state"
  • The AI can generate full campaign narratives and encounters!