RPG

A top-down RPG game built with LÖVE (Love2D). Personal side project for learning game development.

What it is

A simple action RPG with:

• Top-down movement and combat
• Spell system with progression
• Dark caves with lighting effects
• Save/load system
• Toon-shaded art style
• Audio system (ambient sounds, spell casting, NPC voices, music)

Requirements

• LÖVE 11.4+

How to run

Windows

.\run.bat

PowerShell

.\run.ps1

Manual

love .

Controls

• WASD / Arrow Keys - Move
• E - Interact
• 1-5 - Cast spell (slot)
• B - Spellbook
• I - Inventory
• 6-0 - Use quick slot
• P - Player profile
• ESC / P - Pause
• F3 - Debug info (includes audio status)
• F12 - Dev mode

Dev Mode

Press F12 to toggle dev mode:

• Jump to any level
• Give yourself items/spells
• Reset progress (chests/enemies)
• Speed multiplier
• View debug info

Save Files

Save files are stored in your LOVE save directory:

• Windows: %APPDATA%\LOVE\rpg-game\
• macOS: ~/Library/Application Support/LOVE/rpg-game/
• Linux: ~/.local/share/love/rpg-game/

Save file: savegame.sav

Current Progress

• Overworld with village
• Combat system with health/damage/projectiles
• Class selection (Fire/Ice/Storm/Earth Mage)
• Spell system with progression and attack spells
• Inventory with quick slots, stacking, and usable items
• Quest progression
• Cave dungeon with dynamic lighting (lighting moved to src/systems/lighting.lua)
• Save/load with persistent world state
• Portal animations with player effects
• Start screen and player profile
• Spellbook and UI improvements
• Camera cutscenes and story progression
• Multiple levels with puzzle areas
• Defense trials with elemental hazards and resistance spells
• Healing strategy selection (Tank/Lifesteal/Soul Reaper)
• Skeleton spawn animations and combat arenas
• Audio system (ambient sounds, spell casting, NPC dialogue, music)
• Background music system with combat transitions
• Settings menu with adjustable music and SFX volume
• Visual effects for elemental hazards
• Trading system with gold currency and shop
• Sanctuary Village with animated fountain (extracted to src/maps/town.lua)
• The Restful Inn with interactive NPC and loot chests (extracted to src/maps/inn_interior.lua)
• Potion Shop with merchant, magical equipment, and toon-shaded interiors (extracted to src/maps/potion_shop_interior.lua)
• Cave Level 1 (extracted to src/maps/cave_level1.lua)
• Class Selection (extracted to src/maps/class_selection.lua)
• Defense Trials (extracted to src/maps/defense_trials.lua)
• Overworld map construction (extracted to src/maps/overworld.lua)
• More content and puzzles

License

MIT License - see LICENSE file for details.