GGE Warlords is a complete 3D Action RPG framework built with BabylonJS, featuring multiplayer support, GRUDA GEAR equipment system, character progression, combat, AI-powered NPCs, and cloud deployment on Puter.
📚 New to the project? Start with the Documentation Index for organized access to all guides, tutorials, and resources!
🚀 Ready to deploy? Check out the Deployment Master Plan for complete deployment instructions!
- 🎭 Multiple Scenes - Lobby, outdoor worlds, interiors, caves, and more
- ⚔️ Combat System - Spells, weapons, damage, and effects
- 🏃 Character Movement - Walk, sprint, roll, jump with physics
- 🛡️ GRUDA GEAR - Complete equipment system with T1-T8 tiers and rarity levels
- 🎯 Character Progression - Classes, races, skill trees, and leveling
- 🐎 Mount System - Rideable mounts with unique abilities
- 🔨 Crafting System - Gather resources and craft items
- 🎨 AI Material Generator - Create PBR materials from text descriptions (Press M)
- 🤖 AI NPCs - Dynamic dialogue and quest generation with Gemini/Puter AI
- 🔧 Level Builder - Visual terrain editing and object placement
- ⚙️ Admin Panel - Live configuration editing with server sync
- 📊 Persistent UI - FPS counter and debug info across scenes
- 🎮 Gamepad Support - Full controller input mapping
- 📱 Mobile Ready - Touch controls and responsive design
- 🌐 Multiplayer - Colyseus-powered real-time multiplayer (coming soon)
- ☁️ Cloud Deployment - Deploy to Puter Cloud for free
- 🔐 Authentication - GrudaChain blockchain authentication
Play in your browser instantly.
| Scene | URL |
|---|---|
| Outdoor | ?scene=outdoor |
| Lobby | ?scene=lobby |
| Inn | ?scene=inn |
| Builder | ?scene=builder |
| Debug Mode | &debug=true |
See all scenes in SceneManager.js.
# Clone the repository
git clone https://github.com/your-repo/3D-Action-RPG-JavaScript.git
cd 3D-Action-RPG-JavaScript
# Start the server (includes admin API)
node server.js
# Open in browser
# http://localhost:5500The included Express server provides:
- Static file serving
- Admin API for config management (
/api/configs) - Hot-reload support for configuration changes
# Python
python -m http.server 5500
# Node (npx)
npx serve .
# VS Code Live Server extensionAccess the admin panel at /admin or click the ⚙️ button in the lobby.
- Visual Config Editor - Edit all game settings with forms
- Live Preview - See JSON output in real-time
- Server Sync - Save changes directly to server
- Import/Export - Backup and restore configurations
- Connection Status - Real-time server health indicator
| File | Purpose |
|---|---|
config/global.json |
Debug, WebGPU, developer settings |
config/scenes.json |
Scene definitions and spawn points |
config/combat.json |
Spells, weapons, damage values |
config/movement.json |
Controls and movement speeds |
config/character.json |
Hero stats and enemy configs |
config/camera.json |
Camera settings and limits |
config/physics.json |
Gravity and physics properties |
config/graphics.json |
Post-processing and quality |
config/builder.json |
Builder tool settings |
config/assets.json |
Asset paths and references |
See docs/guides/CONFIG_GUIDE.md for details.
Press M to open the Material Forge panel. Generate PBR materials from natural language:
"shiny gold metal with scratches"
"glowing blue crystal"
"weathered stone with moss"
"animated lava flow"
- AI Chat Interface - Describe materials in plain English
- Template Library - Pre-built material starting points
- Material Library - Save and reuse your creations
- Live Preview - See materials on a 3D sphere
- Apply to Meshes - One-click application to selected objects
See src/ai/NMEAgent.js and src/ui/MaterialPanel.js.
├── admin/ # Admin panel (HTML/CSS/JS)
│ ├── index.html
│ ├── css/admin.css
│ └── js/adminApp.js
├── config/ # JSON configuration files
├── docs/ # Documentation
│ ├── guides/ # Feature guides
│ └── archive/ # Historical docs
├── src/
│ ├── ai/ # AI agents (NMEAgent)
│ ├── assets/ # Asset management
│ ├── character/ # Hero, enemies, health
│ ├── combat/ # Spells, weapons, damage
│ ├── config/ # ConfigManager
│ ├── lobby/ # Lobby scene
│ ├── scene/ # SceneManager, scenes
│ │ ├── gen/ # Procedural generation
│ │ └── scenes/ # Scene implementations
│ ├── ui/ # UI panels and components
│ └── utils/ # Utilities
├── lib/ # Babylon.js libraries
├── assets/ # 3D models, textures
├── shaders/ # Custom shaders
├── server.js # Express server with API
└── index.html # Main entry point
Access with ?scene=builder. Tools include:
| Tool | Function |
|---|---|
| Place | Place terrain cells |
| Raise | Raise/Lower/Flatten terrain |
| Models | Place 3D objects |
| Delete | Remove placed objects |
| Copy | Copy/paste sections |
| Material | AI material generation |
| Settings | Save/Load/Export |
📖 Complete Documentation Index - Master index of all documentation
- Startup Guide - Detailed setup and configuration
- Quick Start - Fast track to running the game
- Project Structure - Folder organization guide
- Admin Panel Guide - Using the admin panel
- Config Guide - All configuration files explained
- Combat System - Spells, weapons, damage
- Character System - Stats and movement
- Tile System Guide - Tile-based building system
- Builder Mode - Terrain editing
- Placement Tools - Object placement
- Scripting System - Custom scripts
- Race System - Character races
- Skill Trees - Class and weapon skills
- Action Bar - Ability hotkeys
- Persistent UI - Cross-scene UI
- Deployment Guide - Production deployment
- Troubleshooting - Common issues and fixes
- What's New - Recent updates
| Key | Action |
|---|---|
| W/A/S/D | Move |
| Space | Jump |
| Shift | Sprint |
| Q | Roll/Dodge |
| E | Interact |
| 1-4 | Spells |
| M | Material Panel |
| Esc | Menu |
- Left Click - Attack/Select
- Right Click - Secondary action
- Scroll - Zoom camera
- Drag - Rotate camera
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Submit a pull request
MIT License - See LICENSE file for details.