enderchest 0.1.0rc1

syncing and linking for all your Minecraft instances

EnderChest

A system for managing your minecraft installations across instances and installations

In a Nutshell

EnderChest is a command-line utility for selectively sharing Minecraft assets (configurations, mods, worlds, etc.)...

1. ...across different computers
2. ...across different instances on the same computer
3. ...across server and client installations

Installation

EnderChest is written for Python 3.11 or greater, but should otherwise run on any architecture or operating system.

The latest release can be installed from github via pip:

$ python -m pip install --user git+https://github.com/OpenBagTwo/EnderChest.git@release

Full installation instructions can be found on GitHub Pages.

Usage

EnderChest is a command-line utility. With your enderchest virtual environment activated, run the following command to get an overview of the available actions:

$ enderchest --help

and use:

$ enderchest <verb> --help

(e.g. enderchest place --help)

for further details on running each of those commands.

Full documentation, including tutorials, examples and full CLI docs, can be found on GitHub Pages.

Quick-Start Guide

To get started, navigate your terminal to the directory where you'd like to store your EnderChest. Then run:

$ enderchest craft

which will take you through a guided setup.

Once your EnderChest is set up (and you've hopefully registered a few instances), run

$ enderchest craft shulker_box <name>

for a guided setup of your first shulker box. Run this command again (with a different name) to create a new shulker box.

Now move whatever Minecraft assets (mods, configs, worlds) you want into that shulker box and run:

$ enderchest place

to create symlinks from your registered instance.

If you've set up your EnderChest to sync with other remote installations, you can push your local changes by running:

$ enderchest close

To pull in any changes from other installations, run:

$ enderchest open

and then

$ enderchest place

to update your symlinks.

More detailed usage instructions can be found on GitHub Pages.

Contributing

If you're interested in helping develop this project, have a look at the repo backlog and then read through the contributor's guide.

License

This project--the executable, source code and all documentation are published under the GNU Public License v3, and any contributions to or derivatives of this project must be licensed under compatible terms.