GodthroneRPG is a sophisticated turn-based role-playing game built with Kaplay, delivering an immersive pixel-art experience with deep strategic gameplay mechanics. Embark on epic quests, engage in tactical combat, and forge your legend in a world where every decision matters.
GodthroneRPG represents a modern take on classic turn-based RPGs, combining nostalgic gameplay elements with contemporary game design principles. Built on the robust Kaplay engine, the game features a modular architecture that supports complex gameplay systems while maintaining performance and extensibility.
The game emphasizes strategic decision-making, character progression, and immersive storytelling through its carefully crafted mechanics and atmospheric pixel-art presentation.
The following UML class diagram illustrates the core architecture and relationships within GodthroneRPG:
classDiagram
class GameEngine {
+Kaplay kaplay
+SceneManager sceneManager
+InputHandler inputHandler
+initialize()
+update()
+render()
}
class SceneManager {
+Scene currentScene
+Map~string, Scene~ scenes
+switchScene(sceneName: string)
+addScene(name: string, scene: Scene)
+getCurrentScene(): Scene
}
class Scene {
<<abstract>>
+string name
+boolean isActive
+enter()
+exit()
+update(deltaTime: float)
+render()
}
class ExplorationScene {
+Player player
+WorldMap worldMap
+Camera camera
+handleMovement()
+checkCollisions()
+triggerEvents()
}
class BattleScene {
+Player player
+Enemy[] enemies
+BattleSystem battleSystem
+UI battleUI
+initializeBattle()
+processTurn()
+checkBattleEnd()
}
class MenuScene {
+UI menuUI
+SaveSystem saveSystem
+displayMenu()
+handleMenuSelection()
}
class Character {
<<abstract>>
+string name
+Stats stats
+Inventory inventory
+Position position
+Sprite sprite
+takeDamage(amount: int)
+heal(amount: int)
+isAlive(): boolean
}
class Player {
+int experience
+int level
+Quest[] activeQuests
+gainExperience(amount: int)
+levelUp()
+addQuest(quest: Quest)
}
class Enemy {
+EnemyType type
+int reward
+AI aiController
+performAction(): Action
+dropLoot(): Item[]
}
class Stats {
+int health
+int maxHealth
+int mana
+int maxMana
+int attack
+int defense
+int speed
+int luck
+calculateDamage(attacker: Character): int
+applyBuff(buff: Buff)
}
class Inventory {
+Item[] items
+int maxCapacity
+addItem(item: Item): boolean
+removeItem(item: Item): boolean
+useItem(item: Item, target: Character)
+getItemCount(itemType: ItemType): int
}
class Item {
<<abstract>>
+string name
+string description
+ItemType type
+int value
+Sprite icon
+use(target: Character)
}
class HealingItem {
+int healingAmount
+use(target: Character)
}
class BuffItem {
+Buff buff
+int duration
+use(target: Character)
}
class WeaponItem {
+int attackBonus
+WeaponType weaponType
+use(target: Character)
}
class BattleSystem {
+Character[] participants
+TurnQueue turnQueue
+ActionProcessor actionProcessor
+initializeBattle(player: Player, enemies: Enemy[])
+processTurn()
+calculateTurnOrder()
+executeAction(action: Action)
}
class Action {
<<abstract>>
+Character actor
+Character[] targets
+execute()
+canExecute(): boolean
}
class AttackAction {
+int damage
+execute()
}
class UseItemAction {
+Item item
+execute()
}
class SkillAction {
+Skill skill
+int manaCost
+execute()
}
class WorldMap {
+Tile[][] tiles
+NPC[] npcs
+CollisionLayer collisionLayer
+EventTrigger[] eventTriggers
+getTileAt(x: int, y: int): Tile
+checkCollision(position: Position): boolean
}
class UI {
+UIElement[] elements
+boolean isVisible
+show()
+hide()
+update()
+render()
}
class SaveSystem {
+GameState currentState
+save(slot: int)
+load(slot: int): GameState
+deleteState(slot: int)
+hasState(slot: int): boolean
}
%% Relationships
GameEngine --> SceneManager
GameEngine --> InputHandler
SceneManager --> Scene
Scene <|-- ExplorationScene
Scene <|-- BattleScene
Scene <|-- MenuScene
ExplorationScene --> Player
ExplorationScene --> WorldMap
BattleScene --> Player
BattleScene --> Enemy
BattleScene --> BattleSystem
Character <|-- Player
Character <|-- Enemy
Character --> Stats
Character --> Inventory
Player --> Quest
Enemy --> AI
Inventory --> Item
Item <|-- HealingItem
Item <|-- BuffItem
Item <|-- WeaponItem
BattleSystem --> Action
Action <|-- AttackAction
Action <|-- UseItemAction
Action <|-- SkillAction
WorldMap --> Tile
WorldMap --> NPC
Scene --> UI
MenuScene --> SaveSystem
- 🚶 Dynamic Exploration: Navigate richly detailed environments with interactive elements
- 📊 Character Progression: Deep leveling system with customizable stat allocation
- 🎒 Advanced Inventory: Comprehensive item management with categorization and sorting
- 💬 Interactive Dialogue: Engaging conversations with NPCs that affect story outcomes
- 🏆 Achievement System: Track progress and unlock rewards for various accomplishments
- 🎯 Strategic Turn-Based Combat: Plan your moves carefully in tactical battles
- ⚡ Skill System: Unlock and master powerful abilities as you progress
- 🛡️ Equipment Management: Equip weapons, armor, and accessories for stat bonuses
- 🎲 Dynamic Damage Calculation: Combat outcomes influenced by stats, equipment, and RNG
- 👥 Party Formation: Build and manage a team of diverse characters
- 💾 Robust Save System: Multiple save slots with detailed progress tracking
- 🌍 Procedural Events: Random encounters and events that keep gameplay fresh
- 📈 Difficulty Scaling: Adaptive challenge that grows with player progression
- 🎵 Dynamic Audio: Immersive soundtrack that responds to game state
- ⚙️ Customizable Settings: Adjust graphics, audio, and gameplay preferences
- 🎮 Engine: Kaplay (JavaScript game development framework)
- 🎨 Graphics: Custom pixel-art sprites and animations
- 🔊 Audio: Web Audio API for dynamic sound management
- 💾 Storage: LocalStorage for save data persistence
- 📱 Compatibility: Cross-platform support (Desktop, Mobile, Web)
- Node.js (v16.0 or higher) - Download here
- npm (comes with Node.js) or yarn package manager
- Modern web browser with ES6+ support (Chrome 80+, Firefox 75+, Safari 13+)
-
Clone the repository:
git clone https://github.com/your-username/GodthroneRPG.git cd GodthroneRPG -
Install dependencies:
npm install # or yarn install -
Install development tools (optional):
npm install -g @kaplay/cli
Development Mode:
npm run dev
# or
yarn devProduction Build:
npm run build
npm run previewTesting:
npm run testAccess the game at http://localhost:5173/
GodthroneRPG/
├── 📁 src/
│ ├── 📁 scenes/ # Game scenes (exploration, battle, menu)
│ ├── 📁 entities/ # Character classes and game objects
│ ├── 📁 systems/ # Core game systems (battle, inventory, save)
│ ├── 📁 ui/ # User interface components
│ ├── 📁 utils/ # Utility functions and helpers
│ ├── 📁 data/ # Game data (items, enemies, maps)
│ └── 📄 main.js # Application entry point
├── 📁 assets/
│ ├── 📁 sprites/ # Character and environment sprites
│ ├── 📁 audio/ # Music and sound effects
│ ├── 📁 maps/ # Level data and tilesets
│ └── 📁 ui/ # UI graphics and fonts
├── 📁 docs/ # Documentation and guides
├── 📁 tests/ # Unit and integration tests
├── 📄 package.json # Project dependencies and scripts
├── 📄 vite.config.js # Build configuration
└── 📄 README.md # This file
Getting Started:
- Create your character and customize stats
- Complete the tutorial to learn basic mechanics
- Explore the starting village and accept your first quest
- Engage in battles to gain experience and loot
- Visit shops to upgrade equipment and buy supplies
Combat Tips:
- Study enemy patterns and weaknesses
- Balance offensive and defensive actions
- Manage your resources (health, mana, items) carefully
- Experiment with different skill combinations
- Save before challenging boss encounters
Progression Strategy:
- Focus on core stats that match your playstyle
- Keep a diverse inventory of healing and buff items
- Complete side quests for additional rewards
- Explore thoroughly to find hidden treasures
- Save frequently to preserve your progress
- 🌐 Multiplayer Mode: Online co-op and competitive battles
- 🏰 Guild System: Join guilds and participate in group activities
- 🎭 Character Classes: Specialized roles with unique abilities
- 🌟 Prestige System: End-game progression mechanics
- 📱 Mobile App: Native mobile version with touch controls
- 🎨 Mod Support: Community-created content and modifications
- 🌍 Expanded World: Additional regions and storylines
We welcome contributions from the community! Please read our Contributing Guide for details on:
- Code style and standards
- Development workflow
- Bug reporting process
- Feature request guidelines
- Pull request requirements
This project is licensed under the MIT License - see the LICENSE file for details.
⭐ Star this repository if you enjoy playing Godthrone RPG! ⭐