Skip to content

Repository files navigation


Table of Contents
  1. ModPack Dependency Visualizer
  2. Usage
  3. Limitations
  4. Further Work
  5. Contributing
  6. Donations
  7. License
  8. Contact
  9. Built With
  10. Acknowledgments

ModPack Dependency Visualizer

Don't you hate when you are making a modpack and after adding and removing mods for a while, you don't know if you left unnecessary mods? Well, this tool aims to solve this!

This project makes use of the manifest inside the minecraft mods in JAR format. This makes it possible to establish relations between the mods and generate a network graph, so you can clearly see which mods are left alone and how the connections are established. Here is an example of the Cobblemon ModPack [NeoForge]:

Cobblemon ModPack Graph

Usage

Graph icon

Go to the official website to use this app!

Once you load your mods, you may notice the nodes have different colors depending on the connections they have. Not all colors appear by default; some are toggled by double-clicking the node. Here is how it works:

  • ${\color{blue}\text{Blue}}$ indicates this mod is a Main mod. This means arrows can only go from this mod to another, but not the other way around.
  • ${\color{orange}\text{Orange}}$ indicates this mod is a Midpoint mod. This means arrows can go from this mod to another and vice versa.
  • ${\color{Yellow}\text{Yellow}}$ indicates this mod is a Dependency mod. This means arrows can only go to this mod, but there are no arrows coming from this mod.
  • ${\color{purple}\text{Purple}}$ indicates this mod is a Addon mod. This is a toggle for non-orphan-only nodes. Really useful when working with mods with massive addons such as the Create mod.
  • ${\color{red}\text{Red}}$ indicates this mod is an Orphan mod. This means this mod doesn't have any sort of connections with other mods. This doesn't necessarily mean it's a useless dependency, so it may need to be checked out.
  • ${\color{green}\text{Green}}$ indicates this mod is a Checked orphan mod. This is a toggle for orphan-only nodes. Useful when checking out useless dependencies.

Also, you can click any node and move it with its group around for organization. Finally, you can right click any node to search it on CurseForge, and read about it. If it's your first time loading the website, you'll be prompted with this little reminder:

How clicks work

New feature!

Edit Mode

Now you can enter Edit Mode, which allows you to connect nodes manually and modify relations between them! By default, the graph view will open in View Mode, which allows moving around and repositioning the nodes. You can change to Edit Mode by clicking the top right button.

In this mode instead of moving a node around when clicking on it, you can draw arrows from that node to another. Also, selecting an arrow and pressing the Delete key, will remove the selected arrow (this works in both modes). If you select a node instead, it'll delete all arrows related to that node.

You can always press Ctrl + Z to undo your changes, either adding or deleting an arrow!

Also you can now save your graphs on a JSON file. This can be done clicking on the new download icon right next to the total nodes count. You can then load the JSON file by dropping it onto the dropzone on the main page, just like a JAR file.

Roadmap

  • Base release.
  • Add the ability to mark orphan nodes as checked orphans.
  • Add the ability to mark non-orphan nodes if they are addons.
  • Search the mods on CurseForge / Modrinth from the nodes.
  • Edit mode for connecting nodes manually and modify relations.
  • Ability to undo changes on edit mode, either adding an arrow or removing one.
  • Add an option to save the graph as a file and load it later.

See the open issues for a full list of proposed features (and known issues).

Contributing

Any contributions you make are greatly appreciated!

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue explaining the problem. Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Donations

Feel free to buy me a coffee if you want to! I would highly appreciate your support and it will encourage this project to keep growing even more.

"Buy Me A Coffee"

License

Distributed under the GNU General Public License, version 3 or later. See the LICENSE file for more information.

Contact

You can contact me on my email arcbaedl@gmail.com.

Project Link: arcbra/ModPack-Dependency-Visualizer.

Current limitations

The manifest used to describe all the mod components in any format was standardized in Minecraft version 1.14. So if your modpack is in a version lower than 1.14, this tool may not work properly!

Built With

  • HTML
  • Typescript
  • CSSS

Acknowledgments

This project was heavily inspired by some other ModPack makers projects, and it's meant to complement them, so check them out!

I also want to express my gratitude to the libraries that made this project possible. Huge thanks to the vis.js and Progress Bar.js among others.

(back to top)

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages