pairofdocs / gomule-d2r

Gomule-d2r

GoMule enabled for D2R which is a fork from the original app https://sourceforge.net/projects/gomule/

Original GoMule App

All credits go to Gohanman, Randall, Silospen, collaborators, ...

• Update: D2R support has been added to the official Gomule here https://gomule.sourceforge.io/

Original usage docs: https://managedway.dl.sourceforge.net/project/gomule/gomule/R0.31/GoMuleDocs.pdf

• Warning: Putting more than one Hellfire Torch into a character's personal stash causes the torches to disappear. D2R doesn't allow you to carry more than one torch in your combined inventory/personal stash. Issue by jongad
• Warning: Close D2R when using GoMule. D2R keeps character data open since it displays character gear in the menus and this prevents GoMule from saving files and moving items properly.
• Note: A work-in-progress Atma .d2x stash to D2R .d2i stash converter is available here https://pairofdocs.github.io/atma-stash-d2r/ and discussions are here

Install

1. Install Java Runtime Environment JRE (Windows x64 exe) following the instructions here or here for setting environment variables
2. Download the latest release zip and unzip it to a convenient location
3. Double click the app at gomule-d2r-version/gomule/GoMule.jar

• Alara Shade made this useful video on the installation and usage of the LoD version of GoMule https://youtu.be/ZyRUlZhZU0E?t=55

Pics

• Main Char
  

• Gems moved to the gems mule, runes to the runes mule and uniques to the uniques mule
  

• Moving multiple items
  

• Searching for items using the All stash filter
  

Test Save Files

• Sorc, mule, shared stash

Flavie Grail Report

• Full report

• Report Summary
  

• Report Summary Json

• Grail Tracking In-Game
  

Fixed/Changed

• Moving items between chars (pic)
• Annihilus and Torch charms inventory graphics fixed
• Reading + writing a shared stash .d2i file (pic)
• Changed from original gomule: stash is moved to the left hand side and char + inventory to the right hand side, consistent with how it appears in-game
• Changed from original gomule: an item icon now appears for a selected row in the stash view (pic)
• Merc item reading and moving
• Add grail stats to D2R's main menu panel json so stats appear in-game (details here)
• Reading a character corpse when the savefile has one
• Displaying tooltips for corpse items
• Add keyboard shortcuts for save-all (ctrl+s) and open-character-file (ctrl+o)
• Drop Calculator bug fixes (Colab with etale#9303 on discord) for super uniques (details on diabloii.net)
• Fixed rune drop chances. Thanks to 7551mn on reddit for pointing this out
• Add a darktheme option to the GUI. To enable, set line1 in gomule/arguments.txt to -darktheme
• Add a "Delete All" button to the Clipboard controls

Backup Save Files

WARNING: Back up important save files when using GoMule!

GoMule automatically creates backup directories in GoMule.backup/ each week by default. This can be changed to each day, month or never. Click on Preferences when the app is open to change this setting.

Building and Developing

• To build the GoMule app install JDK (either Java SE 11 (LTS) or Java SE 16) from here.
• Install ant from here following the instructions. Go through the Setup section and set up ANT_HOME, JAVA_HOME and add ANT_HOME/bin to your path
• In a terminal go to the directory gomule-d2r/gomule/ and run ant Jar-BuildAllOptimezed. This builds GoMule.jar
• Debugging with breakpoints using an IDE also lets you test the app (but doesn't create the java archive GoMule.jar)

Credits

• http://gomule.sourceforge.net/ for the original app
• https://github.com/d07RiV/d07riv.github.io for the save file converter and cracking the item Huffman encoding
• https://github.com/dschu012/d2s for the save file converter and editor
• https://user.xmission.com/~trevin/DiabloIIv1.09_File_Format.shtml for extensive details on the d2s file format

Copyrights

Diablo II and Diablo II: Resurrected are copyrighted by Blizzard Entertainment, Inc. All rights reserved. Diablo II, Diablo II: Resurrected and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc. in the U.S. and/or other countries.
All trademarks referenced here are the properties of their respective owners.

Note: For the sake of convenience some text files and dc6 image files that gomule requires are provided in the resources directory. These files are part of the Diablo II game series and are copyrighted by Blizzard Entertainment. They are provided only to save you the trouble of extracting them from the Diablo II game files. If you did not purchase a copy of Diablo II and Diablo II: Resurrected be advised that you may not have perimission to use these files.

This project and its maintainers are not associated with or endorsed by Blizzard Entertainment, Inc.