Full Command-Line Interface Documentation
Summary
usage: enderchest [-h] [-v] action [arguments ...]
v0.1.3
syncing and linking for all your Minecraft instances
positional arguments:
action the action to perform. Options are:
craft
to create and configure a new EnderChest installation
craft shulker_box
to create and configure a new shulker box
place
to link (or update the links) from your instances to your EnderChest
gather minecraft
to register (or update the registry of) a Minecraft installation
gather enderchests
to register (or update the registry of) a remote EnderChest
inventory
to list the shulker boxes inside your Enderchest
inventory minecrafts
to list the minecraft instances registered with your Enderchest
inventory minecraft
to list the shulker boxes that the specified instance links to
inventory shulker_box
to list the minecraft instances that match the specified shulker box
inventory enderchests
to list the other EnderChest installations registered with this EnderChest
open
to pull changes from other EnderChests
close
to push changes to other EnderChests
arguments any additional arguments for the specific action. To learn more, try: enderchest {action} -h
options:
-h, --help show this help message and exit
-v, -V, --version show program's version number and exit
enderchest craft
usage: enderchest craft [-h] [--root ROOT_FLAG] [--verbose] [--quiet]
[--from COPY_FROM] [-r REMOTES]
[-i INSTANCE_SEARCH_PATHS] [--overwrite]
[root]
create and configure a new EnderChest installation
positional arguments:
root optionally specify your root minecraft directory. If
no path is given, the current working directory will
be used.
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
--from COPY_FROM provide the URI (e.g. rsync://deck@my-steam-
deck/home/deck/) of a remote EnderChest installation
that can be used to boostrap the creation of this one.
-r REMOTES, --remote REMOTES
provide the URI (e.g. rsync://deck@my-steam-
deck/home/deck/) of a remote EnderChest installation
to register with this one
-i INSTANCE_SEARCH_PATHS, --instance INSTANCE_SEARCH_PATHS
specify a folder to search for Minecraft installations
in
--overwrite if there's already an EnderChest installation in this
location, overwrite its configuration
enderchest craft shulker_box
usage: enderchest craft shulker_box [-h] [--root ROOT_FLAG] [--verbose]
[--quiet] [--priority PRIORITY]
[-i INSTANCES] [-t TAGS] [-e HOSTS]
[-l LINK_FOLDERS] [--overwrite]
[root] name
create and configure a new shulker box
positional arguments:
root optionally specify your root minecraft directory. If
no path is given, the current working directory will
be used.
name specify the name for this shulker box
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
--priority PRIORITY, -p PRIORITY
specify the link priority for this shulker box (higher
= linked later)
-i INSTANCES, --instance INSTANCES
only link instances with one of the provided names to
this shulker box
-t TAGS, --tag TAGS only link instances with one of the provided tags to
this shulker box
-e HOSTS, --enderchest HOSTS
only link instances registered to one of the provided
EnderChest installations with this shulker box
-l LINK_FOLDERS, --folder LINK_FOLDERS
specify the name of a folder inside this shulker box
that should be linked completely
--overwrite if there's already a shulker box with the specified
name, overwrite its configuration
enderchest place
usage: enderchest place [-h] [--root ROOT_FLAG] [--verbose] [--quiet]
[--keep-broken-links] [--keep-stale-links] [-k]
[--stop-at-first-failure | --ignore-errors | --errors {prompt,ignore,skip,skip-instance,skip-shulker-box,abort}]
[--absolute | --relative]
[root]
link (or update the links) from your instances to your EnderChest
positional arguments:
root optionally specify your root minecraft directory. If
no path is given, the current working directory will
be used.
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
--stop-at-first-failure, -x
stop linking at the first issue
--ignore-errors ignore any linking errors
--errors {prompt,ignore,skip,skip-instance,skip-shulker-box,abort}, -e {prompt,ignore,skip,skip-instance,skip-shulker-box,abort}
specify how to handle linking errors (default behavior
is to prompt after every error)
--absolute, -a use absolute paths for all link targets
--relative, -r use relative paths for all link targets
--keep-broken-links do not remove broken links from instances
--keep-stale-links do not remove existing links into the EnderChest, even
if the shulker box or instance spec has changed
-k Shorthand for the above cleanup options: -k will
--keep-stale-links, and -kk will --keep-broken-links
as well
enderchest gather minecraft
usage: enderchest gather minecraft [-h] [--root ROOT_FLAG] [--verbose]
[--quiet] [--official | --mmc]
[root] search_paths [search_paths ...]
register (or update the registry of) a Minecraft installation
positional arguments:
root optionally specify your root minecraft directory. If no
path is given, the current working directory will be used.
search_paths specify a folder or folders to search for Minecraft
installations
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
--official, -o specify that these are instances managed by the official
launcher
--mmc, -m specify that these are MultiMC-like instances
enderchest gather enderchests
usage: enderchest gather enderchests [-h] [--root ROOT_FLAG] [--verbose]
[--quiet]
[root] remotes [remotes ...]
register (or update the registry of) a remote EnderChest
positional arguments:
root optionally specify your root minecraft directory. If no
path is given, the current working directory will be used.
remotes provide URIs (e.g. rsync://deck@my-steam-deck/home/deck/)
of any remote EnderChest installation to register with
this one.Note: you should not use this method if the alias
(name) of theremote does not match the remote's hostname
(in this example,"my-steam-deck").
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
enderchest inventory
usage: enderchest inventory [-h] [--root ROOT_FLAG] [--verbose] [--quiet]
[root]
list the shulker boxes inside your Enderchest
positional arguments:
root optionally specify your root minecraft directory. If no
path is given, the current working directory will be used.
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
enderchest inventory minecrafts
usage: enderchest inventory minecrafts [-h] [--root ROOT_FLAG] [--verbose]
[--quiet]
[root]
list the minecraft instances registered with your Enderchest
positional arguments:
root optionally specify your root minecraft directory. If no
path is given, the current working directory will be used.
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
enderchest inventory minecraft
usage: enderchest inventory minecraft [-h] [--root ROOT_FLAG] [--verbose]
[--quiet]
[root] instance_name
list the shulker boxes that the specified instance links to
positional arguments:
root optionally specify your root minecraft directory. If no
path is given, the current working directory will be used.
instance_name The name of the minecraft instance to query
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
enderchest inventory shulker_box
usage: enderchest inventory shulker_box [-h] [--root ROOT_FLAG] [--verbose]
[--quiet]
[root] shulker_box_name
list the minecraft instances that match the specified shulker box
positional arguments:
root optionally specify your root minecraft directory. If no
path is given, the current working directory will be used.
shulker_box_name The name of the shulker box to query
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
enderchest inventory enderchests
usage: enderchest inventory enderchests [-h] [--root ROOT_FLAG] [--verbose]
[--quiet]
[root]
list the other EnderChest installations registered with this EnderChest
positional arguments:
root optionally specify your root minecraft directory. If no
path is given, the current working directory will be used.
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
enderchest open
usage: enderchest open [-h] [--root ROOT_FLAG] [--verbose] [--quiet]
[--dry-run] [--exclude EXCLUDE [EXCLUDE ...]]
[--timeout TIMEOUT] [--wait SYNC_CONFIRM_WAIT]
[root]
pull changes from other EnderChests
positional arguments:
root optionally specify your root minecraft directory. If
no path is given, the current working directory will
be used.
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
--dry-run Perform a dry run of the sync operation, reporting the
operations that will be performed but not actually
carrying them out
--exclude EXCLUDE [EXCLUDE ...], -e EXCLUDE [EXCLUDE ...]
Provide any file patterns you would like to skip
syncing
--timeout TIMEOUT, -t TIMEOUT
Set a maximum number of seconds to try to sync to a
remote chest before giving up and going on to the next
one
--wait SYNC_CONFIRM_WAIT, -w SYNC_CONFIRM_WAIT
The default behavior when syncing EnderChests is to
first perform a dry run of every sync operation and
then wait 5 seconds before proceeding with the real
sync. The idea is to give you time to interrupt the
sync if the dry run looks wrong. You can raise or
lower that wait time through this flag. You can also
modify it by editing the enderchest.cfg file.
enderchest close
usage: enderchest close [-h] [--root ROOT_FLAG] [--verbose] [--quiet]
[--dry-run] [--exclude EXCLUDE [EXCLUDE ...]]
[--timeout TIMEOUT] [--wait SYNC_CONFIRM_WAIT]
[root]
push changes to other EnderChests
positional arguments:
root optionally specify your root minecraft directory. If
no path is given, the current working directory will
be used.
options:
-h, --help show this help message and exit
--root ROOT_FLAG specify your root minecraft directory
--verbose, -v increase the amount of information that's printed
--quiet, -q decrease the amount of information that's printed
--dry-run Perform a dry run of the sync operation, reporting the
operations that will be performed but not actually
carrying them out
--exclude EXCLUDE [EXCLUDE ...], -e EXCLUDE [EXCLUDE ...]
Provide any file patterns you would like to skip
syncing
--timeout TIMEOUT, -t TIMEOUT
Set a maximum number of seconds to try to sync to a
remote chest before giving up and going on to the next
one
--wait SYNC_CONFIRM_WAIT, -w SYNC_CONFIRM_WAIT
The default behavior when syncing EnderChests is to
first perform a dry run of every sync operation and
then wait 5 seconds before proceeding with the real
sync. The idea is to give you time to interrupt the
sync if the dry run looks wrong. You can raise or
lower that wait time through this flag. You can also
modify it by editing the enderchest.cfg file.