lpc-forge
v1.2.0
Published
Complete 2D RPG asset pipeline — character compositor, procedural map generator, and Godot 4 exporter. Built on Liberated Pixel Cup sprites.
Maintainers
Readme
⚔️ LPC Forge
Generate a complete 2D RPG from one command.
Characters · Maps · Enemy AI · Inventory · Dialog · Menus · SFX · Lighting · Particles · Godot 4.6
Website · Get Premium · Discord · Report Bug
What is LPC Forge?
LPC Forge generates playable 2D RPG projects for Godot 4.6 using Liberated Pixel Cup assets. Not just sprites — complete game projects with working systems you can customize.
Free tier gives you characters, maps, and a basic playable project. Premium ($10) gives you the full RPG game kit — inventory, dialog, enemy AI, menus, save/load, sound effects, lighting, particles, and more. All from one command.
# Free — character + map + basic project
lpc-forge init my-rpg
# Premium — complete playable RPG
lpc-forge init my-rpg --fullOpen in Godot → Press F5 → Play.
Quick Start
# Clone and install
git clone https://github.com/LaunchDay-Studio-Inc/lpc-forge.git
cd lpc-forge
npm install && npm run build
# Generate a free project
npx lpc-forge init my-rpg
# Open in Godot 4.6 → Import → Select my-rpg/project.godot → Press F5Free vs Premium
| Feature | Free | Premium ($10) | |---------|:----:|:-------------:| | Character Compositor (17 presets, custom specs) | ✅ | ✅ | | Map Generation (dungeon, cave, overworld, town, WFC, multifloor) | ✅ | ✅ | | Godot Project Scaffold (player controller, hitbox, camera, HUD) | ✅ | ✅ | | Batch Character Generation | ✅ | ✅ | | Enemy AI (patrol, chase, attack, flee, boss patterns) | — | ✅ | | Inventory System (grid UI, equip, stack, drag-drop, tooltips) | — | ✅ | | Dialog System (text box, choices, portraits, typing effect) | — | ✅ | | Menu System (main, pause, settings, game over, credits) | — | ✅ | | Save/Load (JSON, 3 slots, auto-save) | — | ✅ | | Scene Transitions (doors, stairs, fade, area loading) | — | ✅ | | Loot & Drop System (drop tables, item pickup, XP/gold drops) | — | ✅ | | Quest Tracker (objectives, markers, completion) | — | ✅ | | Day/Night Cycle (time-of-day modulation, lamp auto-on) | — | ✅ | | Full HUD (HP, MP, XP, gold, minimap, hotbar, buffs) | — | ✅ | | Sound Effects (45 procedural SFX: combat, UI, movement, magic) | — | ✅ | | Music Catalog (curated CC0 BGM tracks for every scene type) | — | ✅ | | UI Kit (panels, buttons, frames, tooltips, medieval theme) | — | ✅ | | Item Icons (swords, potions, scrolls, armor, food, keys) | — | ✅ | | Props (chests, barrels, torches, signs, wells, fences) | — | ✅ | | Character Portraits (auto-cropped, 3 sizes) | — | ✅ | | Lighting Presets (8 presets: dungeon, overworld, cave, boss arena) | — | ✅ | | Particle Effects (8 effects: rain, snow, fireflies, fire, magic) | — | ✅ | | Enemy Characters (skeleton, guard, thief — full spritesheets) | — | ✅ | | NPC Characters (merchant, healer, peasant — full spritesheets) | — | ✅ | | Autoload Wiring (systems auto-registered in project.godot) | — | ✅ | | Input Actions (inventory, interact, pause, quest log pre-configured) | — | ✅ |
Get Premium
# 1. Purchase at https://launchday.gumroad.com/l/lpc-forge-premium
# 2. Activate your license key
lpc-forge activate <your-license-key>
# 3. Generate a complete RPG
lpc-forge init my-rpg --full$10. One-time purchase. Unlimited projects. No subscription.
Commands
Free Commands
# Character compositor
lpc-forge character --preset paladin -o ./output
lpc-forge character --body female --hair plain:blonde --armor plate:gold
lpc-forge character --list-layers
# Batch generation
lpc-forge batch --presets warrior,mage,rogue -o ./output
# Map generation
lpc-forge map --type dungeon --width 50 --height 50 -o ./output
lpc-forge map --type overworld --seed "my-world" -o ./output
# List all presets
lpc-forge list
# Project scaffold (free tier)
lpc-forge init my-rpg --character warrior --map dungeonPremium Commands
# Full RPG project (all systems, all assets)
lpc-forge init my-rpg --full
# Individual premium generators
lpc-forge systems --list # Preview (free)
lpc-forge systems -o ./output # Generate (premium)
lpc-forge sfx --list # Preview (free)
lpc-forge sfx -o ./output # Generate (premium)
lpc-forge ui --list-themes # Preview (free)
lpc-forge ui -o ./output # Generate (premium)
lpc-forge lighting --list # Preview (free)
lpc-forge lighting -o ./output # Generate (premium)
lpc-forge particles --list # Preview (free)
lpc-forge particles -o ./output # Generate (premium)
lpc-forge icons -o ./output # Generate (premium)
lpc-forge props -o ./output # Generate (premium)
lpc-forge portrait --character warrior -o ./output # Generate (premium)
# License management
lpc-forge activate <key> # Activate license
lpc-forge activate --status # Check license status
lpc-forge activate --deactivate # Remove licenseWhat init --full Generates
my-rpg/
├── project.godot # Pre-configured with autoloads + input actions
├── sprites/
│ ├── warrior/ # Player character (8-dir, all animations)
│ ├── skeleton/ # Enemy character
│ ├── guard/ # Enemy character
│ ├── thief/ # Enemy character
│ ├── npc_merchant/ # NPC character
│ ├── npc_healer/ # NPC character
│ └── npc_peasant/ # NPC character
├── scripts/
│ ├── player.gd # State machine player controller
│ ├── enemy_ai.gd # Patrol/chase/attack FSM
│ ├── inventory_manager.gd # Grid inventory system (autoload)
│ ├── inventory_ui.gd # Drag-drop inventory UI
│ ├── dialog_manager.gd # Dialog system (autoload)
│ ├── dialog_box.gd # Text box with typing effect
│ ├── save_manager.gd # Save/load system (autoload)
│ ├── scene_manager.gd # Scene transitions (autoload)
│ ├── loot_manager.gd # Drop tables and item pickup (autoload)
│ ├── quest_manager.gd # Quest tracker (autoload)
│ ├── day_night.gd # Day/night cycle (autoload)
│ ├── menu_manager.gd # Menu system (autoload)
│ ├── hud.gd # Full HUD (autoload)
│ └── game_config.gd # Global game constants
├── dungeon.tscn # Generated dungeon map
├── tileset/ # Terrain tiles
├── ui/ # UI kit (panels, buttons, frames)
├── icons/ # Item icon sprites
├── props/ # Prop sprites
├── portraits/ # Character portraits (3 sizes)
├── lighting/ # 8 lighting preset scenes
├── particles/ # 8 particle effect scenes
├── sfx/ # 45 sound effects (.wav)
├── music/ # BGM tracks catalog
└── map_preview.png # Map overview imageOpen in Godot → Press F5 → Walk around, fight enemies, open inventory, talk to NPCs.
Character Presets
| Preset | Layers | Style |
|--------|--------|-------|
| warrior | Plate armor, longsword, brown hair | Classic RPG fighter |
| mage | Robe, staff, white hair | Spellcaster |
| rogue | Leather armor, dagger, black hair | Stealth class |
| ranger | Leather, bow, green hood | Ranged fighter |
| paladin | Gold plate, greatsword, blonde hair | Holy knight |
| necromancer | Dark robe, skull staff, bald | Dark magic |
| cleric | White robe, mace, brown hair | Healer |
| barbarian | Fur armor, battleaxe, red hair | Berserker |
| monk | Simple clothes, bo staff, shaved head | Martial arts |
| bard | Fancy clothes, lute, curly hair | Support class |
| ...and 7 more | | |
# See all presets
lpc-forge listMap Types
| Type | Algorithm | Features |
|------|-----------|----------|
| dungeon | BSP (Binary Space Partition) | Rooms, corridors, doors, spawn/treasure/boss POIs |
| cave | Cellular Automata | Organic caverns, varied openness |
| overworld | Multi-octave noise | Biomes, rivers, mountains, forests |
| town | District-based | Houses, shops, roads, town square |
| wfc | Wave Function Collapse | Pattern-based, highly varied |
| multifloor | Stacked BSP | Multi-level dungeons with stairs |
lpc-forge map --type dungeon --width 60 --height 60 --seed "my-dungeon" -o ./outputLicense & Credits
Tool License
LPC Forge (the CLI tool) is licensed under GPL-3.0-or-later. See LICENSE.
Asset Licenses
Character sprites use Liberated Pixel Cup assets under CC-BY-SA 3.0 and CC-BY-SA 4.0. Full artist credits in CREDITS.csv.
Premium assets include curated content from OpenGameArt.org under CC0/CC-BY-SA licenses. When distributing games made with LPC Forge, include the generated CREDITS.md file.
Premium License
LPC Forge Premium (the --full content pack, game systems, SFX presets, and curated assets) is sold separately at blueth.online. One-time purchase, unlimited projects, no subscription.
Contributing
See CONTRIBUTING.md. PRs welcome for the open-source core — character presets, map algorithms, export improvements.
Premium features (systems, SFX, UI, lighting, particles) are maintained by LaunchDay Studio.
Links
- 🌐 blueth.online — Blueth Plugin Marketplace
- 💬 Discord — Community & Support
- 🐛 Issues — Bug Reports
- 📖 LPC Wiki — Liberated Pixel Cup
Made by LaunchDay Studio 🚀
Stop spending weeks on placeholder art. Start building your game.
