====== Modding Possibilities ======

Remixed Dungeon provides extensive modding capabilities that allow you to create diverse modifications to the game. This guide describes what can be achieved through different modding methods.

===== What CAN be done without Java code changes =====

==== Resource Overrides ====
  * **Sprites and Graphics** - Replace any game sprites completely
  * **Sounds and Music** - Change all sound effects and background music
  * **Texts and Localization** - Modify all texts and add new languages

==== JSON Configuration ====
  * **Item Properties** - Stats, appearance, behavior of all items
  * **Mob Properties** - Stats, AI, drops, abilities of all creatures
  * **Dungeon Structure** - Level connections, room types, layout
  * **Level Content** - What mobs, items and features appear where
  * **Hero Properties** - Starting equipment, stats, abilities
  * **Spells and Abilities** - Custom spell mechanics
  * **Buffs and Effects** - Status effects and their properties
  * **UI Texts** - All in-game texts and descriptions
  * **Animations** - Custom animation sequences

==== Lua Scripts ====
  * **Custom Traps** - Create completely new trap mechanics
  * **Custom Level Actors** - Add new environmental elements
  * **Custom Mobs** - Design new creatures with unique behaviors
  * **Custom Spells** - Implement new magical abilities
  * **Custom Items** - Create items with unique effects
  * **Custom Buffs** - Add new status effects
  * **Custom AI** - Implement specialized AI for mobs and NPCs
  * **Game Logic** - Modify certain game mechanics

==== Map Creation ====
  * **Pre-designed Levels** - Create completely custom levels using [[Tiled]]
  * **Random Level Patterns** - Define new types of random levels
  * **Dungeon Layout** - Change how levels connect
  * **Special Areas** - Add unique branches and rooms

===== What CAN be done with Java modding (advanced) =====

==== Custom Classes ====
  * **New Item Types** - Complete new item classes with complex mechanics
  * **New Mob Types** - Completely new creatures with advanced AI
  * **New Game Systems** - Add entirely new mechanics to the game
  * **UI Extensions** - Create complex new UI systems
  * **Game State Extensions** - Add new persistent game data

==== Platform Integration ====
  * **Platform Services** - Integrate with platform-specific services
  * **Storage Extensions** - Custom data storage methods
  * **Input Handling** - New input methods or controls

===== Creating New Content =====

==== Items ====
With JSON and Lua, you can create:
  * **Weapons** - With custom damage, enchantments, and special effects
  * **Armor** - With custom defense, glyphs, and special effects
  * **Rings** - With custom persistent effects
  * **Potions** - With custom effects when drunk
  * **Scrolls** - With custom effects when read
  * **Wands** - With custom charges and effects
  * **Artifacts** - With custom progression and effects

==== Mobs ====
Create new creatures with:
  * **Custom Stats** - HP, damage, defense, speed
  * **Custom AI** - Special movement or attack patterns
  * **Special Abilities** - Unique attacks or effects
  * **Drops** - Custom treasure and equipment
  * **Visuals** - New sprites and animations

==== Levels ====
Design new areas with:
  * **Custom Layouts** - Unique room structures
  * **Special Features** - Unique level mechanics
  * **New Themes** - Different visual styles
  * **Custom Music** - Level-specific soundtracks

===== Advanced Techniques =====

==== Multi-File Mods ====
  * Organize complex mods in multiple subdirectories
  * Use version.json to define dependencies between mod components
  * Create mod "packages" with multiple interrelated components

==== Conditional Logic ====
  * Use game state to enable features conditionally
  * Implement progressive content that unlocks over time
  * Create features that adapt to player progress

==== Integration Techniques ====
  * Add content that feels native to the game
  * Use existing game mechanics as building blocks
  * Create synergies between different modded elements

===== Best Practices for Modding =====

==== Organization ====
  * Plan your mod structure before starting
  * Use clear naming conventions for all files
  * Document complex interactions in your mod

==== Compatibility ====
  * Design your mod to work with other popular mods
  * Avoid conflicting with standard game mechanics unnecessarily
  * Test your mod with various other modifications

==== User Experience ====
  * Provide clear in-game descriptions for new content
  * Balance new content with existing game mechanics
  * Consider the difficulty curve when adding content

With these possibilities in mind, you can create almost any kind of content that fits within the Roguelike framework of Remixed Dungeon.