Nyrds Wiki

User Tools

Site Tools

Trace: • mods
rpd:mods

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
rpd:mods [2018/12/10 20:19] – kwakonerpd:mods [2025/12/05 15:15] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== Modding ====== ====== Modding ======
  
 +===== How-to install custom mod =====
  
-=====  Basic Idea =====+Mods are typically packed in zip archives (sometime file extension changed to something like zipp if this is the case rename it to plain zip) 
 + 
 +To install mod on Remixed Dungeon manually: 
 + 
 +Android version >= 11 (requires remixed 32.1+) 
 + 
 +option 1 (If you delevoping mod): 
 +  * unpack mod archive to any directory under Downloads folder 
 +  * In game Mod -> Install local mod -> pick mod directory (refer to [[https://www.youtube.com/shorts/hJq-7vVaf4o|video]] if in doubt) 
 + 
 +option 2 (To install mod developed by someone else): 
 +  * place mod archive in rpd format on device 
 +  * navigate to it in file manager (refer to [[https://www.youtube.com/shorts/wyPVbAdbWXQ|video]] if in doubt) 
 +  * tap to open 
 +  * choose Remixed Dungeon app 
 +  * In app: confirm mod installation 
 + 
 +Android version < 11 
 + 
 +  * unpack mod archive to **Android/data/com.nyrds.pixeldungeon.ml/files/** 
 +  * done. 
 + 
 +===== How-to create custom mod ===== 
 + 
 +In order to be able to play your mod (or any other non-official mod), you need to place your modified files in a folder named the way you want your mod to be named (example: "My mod"). 
 + 
 +Don't forget to add at least minimal [[version.json]] file with something like {"version":1} as content. 
 + 
 +Place that folder into the "files" directory of the game. 
 + 
 +Approximate path on typical android system looks like this: 
 + 
 +**Android/data/com.nyrds.pixeldungeon.ml/files/** . 
 + 
 +===== Getting Started with Resource Modding ===== 
 + 
 +[[rpd:modding_getting_started|New to modding? Check out our getting started guide]] 
 + 
 +===== Non-Java Modding Approaches ===== 
 + 
 +Remixed Dungeon offers extensive modding capabilities without writing Java code. Focus on these approaches: 
 + 
 +==== Resource Overrides ==== 
 +  * Replace any game sprites, sounds, or music by placing new files in the matching directory structure 
 +  * No coding required - just replace the original files with your custom versions 
 + 
 +==== JSON Configuration ==== 
 +  * Modify game mechanics, item properties, mob stats, dungeon structure and more 
 +  * Create completely new content by defining it in JSON files 
 +  * All game text and localization can be changed through JSON 
 + 
 +==== Lua Scripting ==== 
 +  * Create custom behaviors for items, mobs, and game systems 
 +  * Implement new mechanics and effects without Java knowledge 
 +  * Hook into game events like item use, mob actions, and level events 
 + 
 +[[rpd:modding_non_java_techniques|Detailed guide to non-Java modding techniques]] 
 + 
 +===== Modding Tutorials ===== 
 + 
 +  * [[rpd:modding_getting_started|Getting Started]] - Your first simple mod 
 +  * [[rpd:modding_custom_items|Creating Custom Items]] - Making new weapons, armor, potions, and scrolls 
 +  * [[rpd:modding_custom_mobs|Creating Custom Mobs]] - Designing new creatures and enemies 
 +  * [[rpd:modding_custom_levels|Creating Custom Levels]] - Building new dungeon areas 
 +  * [[rpd:modding_ui_elements|Creating Custom UI Elements]] - Making interfaces for your mod 
 +  * [[rpd:modding_platform_abstraction|Platform Abstraction]] - Understanding cross-platform features 
 +  * [[rpd:mods_limitations|Possibilities and Limitations]] - What can and can't be done 
 + 
 +===== Basic Idea =====
   * Every PD flavors source has assets folder [[https://github.com/watabou/pixel-dungeon/tree/master/assets|vanilla for example]]   * Every PD flavors source has assets folder [[https://github.com/watabou/pixel-dungeon/tree/master/assets|vanilla for example]]
-  * Remixed can load game resources not only from apk assets but also from external storage ( typically located at  Android/data/com.nyrds.pixeldungeon.ml/files/ ), so mods can override some (or all) of its content (also it must contain version.json file ) +  * Remixed can load game resources not only from apk assets but also from external storage ( typically located at  Android/data/com.nyrds.pixeldungeon.ml/files/ ), so mods can override some (or all) of its content (also it must contain version.json file) 
-  * In Remixed [[https://github.com/NYRDS/pixel-dungeon-remix/tree/master/PixelDungeon/src/main/assets|assets]] contains not only graphics & music but also data such as Dungeon structure, levels description, animation sequences and so on.+  * In Remixed [[https://github.com/NYRDS/remixed-dungeon/tree/master/RemixedDungeon/src/main/assets|assets]] contains not only graphics & music but also data such as Dungeon structure, levels description, animation sequences and so on.
  
-So anyone can just provide different data set and that's it.+Each mod is resource overlay, that is they replace game assets such as textures, sounds, json configuration files and lua scripts while leaving java code intact.
  
-The most simple way to get a better view at Remixed view is to download one of the bundled mods and examine its structure. [[https://github.com/NYRDS/Maze-RPD-MOD|Maze]] is good to start from) +The simplest way to get a better view at Remixed is to download one of the bundled mods and examine its structure. [[https://github.com/NYRDS/Maze-RPD-MOD|Maze]] is good to start from.
  
-=====  Brief features list =====+===== Brief features list =====
  
 Maybe it's worth for you to check Remixed PD mods mechanics. It is far from complete, completely lacks documentation, full of bugs, etc. But at this point, it allows to do the following (without touching the java code): Maybe it's worth for you to check Remixed PD mods mechanics. It is far from complete, completely lacks documentation, full of bugs, etc. But at this point, it allows to do the following (without touching the java code):
Line 38: Line 107:
   * Create custom mobs with unique abilities   * Create custom mobs with unique abilities
   * Create custom spells   * Create custom spells
-  * Create custom items (this feature is pretty limited for now )+  * Create custom items 
 +  * Create custom buffs 
 +  * Create custom AI for mobs and NPC's
  
-In order to be able to play your mod (or any other non-official mod), you need to place your modified files in a folder named the way you want your mod to be named (example: "My mod"). Do not forget to add a version.json file with something like {"version":1} as content. 
- 
-Place that folder into the ”files” directory of the game. Approximate path on typical android system looks like this : **Android/data/com.nyrds.pixeldungeon.ml/files/** .  
  
 You can check how other mods are structured, to get a better idea. You can check how other mods are structured, to get a better idea.
Line 48: Line 116:
 ==== Existing mods ==== ==== Existing mods ====
  
-For example you can see : ( https://github.com/NYRDS/PD_mini-RPD-MOD )+For example, you can see : ( https://github.com/NYRDS/PD_mini-RPD-MOD )
  
 +  * [[rpd:mods:Remixed Additions]]
 +  * [[rpd:mods:Remixed RPG]]
 +  * [[rpd:mods:The Epic Dungeon]]
   * [[rpd:mods:Maze]]   * [[rpd:mods:Maze]]
-  * [[rpd:mods:The Fallen]] 
  
 ==== Gameplay with mods ==== ==== Gameplay with mods ====
Line 58: Line 128:
 ==== List of resources ==== ==== List of resources ====
   * assets (images, sounds, maps and dungeon layout):   * assets (images, sounds, maps and dungeon layout):
-  * https://github.com/NYRDS/pixel-dungeon-remix/tree/master/PixelDungeon/src/main/assets+  * https://github.com/NYRDS/remixed-dungeon/tree/master/RemixedDungeon/src/main/assets
  
   * res (texts):   * res (texts):
-  * https://github.com/NYRDS/pixel-dungeon-remix/tree/master/PixelDungeon/src/main/res/values+  * https://github.com/NYRDS/remixed-dungeon/tree/master/RemixedDungeon/src/main/res/values
  
   * example of a level:   * example of a level:
-  * https://github.com/NYRDS/pixel-dungeon-remix/blob/master/PixelDungeon/src/main/assets/levelsDesc/TestLevelGuts.json+  * https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/assets/levelsDesc/TestLevelGuts.json
  
   * example of a level created with modified Tiled:   * example of a level created with modified Tiled:
-  * https://github.com/NYRDS/pixel-dungeon-remix/blob/master/PixelDungeon/src/main/assets/levelsDesc/Town.json+  * https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/assets/levelsDesc/Town.json
  
   * Dungeon layout:   * Dungeon layout:
-  * https://github.com/NYRDS/pixel-dungeon-remix/blob/master/PixelDungeon/src/main/assets/levelsDesc/Dungeon.json+  * https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/assets/levelsDesc/Dungeon.json
  
   * Bestiary:   * Bestiary:
-  * https://github.com/NYRDS/pixel-dungeon-remix/blob/master/PixelDungeon/src/main/assets/levelsDesc/Bestiary.json+  * https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/assets/levelsDesc/Bestiary.json 
 + 
 +  * Hero initial stats & equipment: 
 +  * https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/assets/hero/initHeroes.json 
 + 
 +==== Additional Modding Guides ==== 
 + 
 +  * [[rpd:modding_quick_reference|Quick Reference]] - Fast solutions for common modding tasks 
 +  * [[rpd:modding_ui_elements|Creating Custom UI Elements]] - How to create custom interfaces for your mod 
 +  * [[rpd:modding_platform_abstraction|Platform Abstraction System]] - Understanding cross-platform modding
  
 ==== Tools ==== ==== Tools ====
rpd/mods.1544473153.txt.gz · Last modified: by kwakone