This tool does the complicated bits for the itzg/minecraft-server and itzg/bungeecord Docker images.
NOTE The following documentation may not always be up-to-date. Please be sure to use
-hor--helpafter any subcommand to view the current usage.
Usage: mc-image-helper [-hs] [--debug] [COMMAND]
--debug Enable debug output. Can also set environment variable
DEBUG_HELPER
-h, --help Show this usage and exit
-s, --silent Don't output logs even if there's an error
Commands:
asciify Converts UTF-8 on stdin to ASCII by escaping Unicode
characters
assert Provides assertion operators for verifying container
setup
compare-versions Used for shell scripting, exits with success(0) when
comparison is satisfied or 1 when not
find Specialized replacement for GNU's find
get Download a file
hash Outputs an MD5 hash of the standard input
install-forge Downloads and installs a requested version of Forge
interpolate Interpolates existing files in one or more directories
java-release Outputs the Java release number, such as 8, 11, 17
maven-download Downloads a maven artifact from a Maven repository
modrinth Automates downloading of modrinth resources
patch Patches one or more existing files using JSON path
based operations
sync Synchronizes the contents of one directory to another.
sync-and-interpolate Synchronizes the contents of one directory to another
with conditional variable interpolation.
yaml-path Extracts a path from a YAML file using json-path syntax
vanillatweaks Downloads Vanilla Tweaks resource packs, data packs, or
crafting tweaks given a share code or pack file
For patch command see below for a description of PatchSet and PatchDefinition JSON schemas.
For install-curseforge and install-modrinth-modpack commands, refer to the exclude/include file schema.
Usage: mc-image-helper asciify
Converts UTF-8 on stdin to ASCII by escaping Unicode characters
Usage: mc-image-helper assert [COMMAND]
Provides assertion operators for verifying container setup
Commands:
fileExists
fileNotExists
jsonPathEquals
propertyEquals
Usage: mc-image-helper compare-versions <leftVersion> <comparison>
<rightVersion>
Used for shell scripting, exits with success(0) when comparison is satisfied or
1 when not
<leftVersion>
<comparison>
<rightVersion>
Usage: mc-image-helper curseforge-files [-h] [--disable-api-caching]
[--api-base-url=<apiBaseUrl>]
[--api-key=<apiKey>]
[--default-category=<slugCategory>]
[--game-version=<gameVersion>]
[--mod-loader=<modLoaderType>] [-o=DIR]
[[--api-cache-ttl=OPERATION=DURATION]...
[--api-cache-default-ttl=DURATION]]
[[--connection-pool-max-idle-timeout=DUR
ATION]
[--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeo
ut=DURATION]
[--http-response-timeout=DURATION]] [REF
[,REF...]...]
Download and manage individual mod/plugin files from CurseForge
[REF[,REF...]...] Can be <project ID>|<slug>':'<file ID>, <project
ID>|<slug>'@'<filename matcher>, <project
ID>|<slug>, project page URL, file page URL,
'@'<filename with ref per line>
If not specified, any previous mod/plugin files are
removed
--api-base-url=<apiBaseUrl>
Allows for overriding the CurseForge Eternal API used
Can also be passed via CF_API_BASE_URL
--api-cache-default-ttl=DURATION
Set default/fallback TTL in ISO-8601 duration format.
Default: P2D
--api-cache-ttl=OPERATION=DURATION
Set individual operation TTLs
--api-key=<apiKey> An API key allocated from the Eternal developer
console at https://console.curseforge.com/
Can also be passed via CF_API_KEY
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--default-category=<slugCategory>
When providing slugs, a category is required to
qualify those
--disable-api-caching
--game-version=<gameVersion>
The Minecraft version
Can also be passed via VERSION
-h, --help
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--mod-loader=<modLoaderType>
One of Any, Forge, Cauldron, LiteLoader, Fabric,
Quilt, NeoForge
-o, --output-directory=DIR
--tls-handshake-timeout=DURATION
Default: PT30S
Usage: mc-image-helper find [-hq] [--delete] [--delete-empty-directories]
[--fail-no-matches] [--only-shallowest]
[--output-count-only] [--stop-on-first]
[--format=<format>] [--max-depth=N] [--min-depth=N]
[--exclude-name=glob[\s*,\s*glob...]]...
[--name=glob[\s*,\s*glob...]]... [-t=<type>[\s*,
\s*<type>...]]... startDir...
Specialized replacement for GNU's find
startDir... One or more starting directories
--delete Deletes the matched entries. When searching for
directories, each directory and its contents will
be recursively deleted.
--delete-empty-directories
Deletes a traversed directory if it becomes empty
after matching files/directories within it were
deleted
--exclude-name=glob[\s*,\s*glob...]
One or more glob patterns to exclude by looking at
name part of the path. If a pattern matches a
directory's name, then its entire subtree is
excluded.
--fail-no-matches
--format=<format> Applies a format when printing each matched entry.
Supports the following directives
%% a literal %
%h leading directory of the entry
%P path of the entry relative to the starting point
-h, --help
--max-depth=N Unlimited depth if negative
--min-depth=N Minimum match depth where 0 is a starting point
--name=glob[\s*,\s*glob...]
One or more glob patterns to match name part of the
path
--only-shallowest
--output-count-only
-q, --quiet
--stop-on-first
-t, --type=<type>[\s*,\s*<type>...]
Valid values: file, directory
Usage: mc-image-helper get [-hz] [--exists] [--log-progress-each]
[--output-filename] [--skip-existing]
[--apikey=<apikeyHeader>] [--json-path=<jsonPath>]
[--json-value-when-missing=<jsonValueWhenMissing>]
[-o=FILE|DIR] [--prune-depth=<pruneDepth>]
[--retry-count=<retryCount>]
[--retry-delay=<retryDelay>]
[--uris-file=<urisFile>]
[--accept=<acceptContentTypes>[\s*,
\s*<acceptContentTypes>...]]... [--prune-others=GLOB
[\s*,\s*GLOB...]]... [URI[\s*,\s*URI...]...]
Download a file
[URI[\s*,\s*URI...]...]
The URI of the resource to retrieve. When the
output is a directory, more than one URI can be
requested.
--accept=<acceptContentTypes>[\s*,\s*<acceptContentTypes>...]
Specifies the accepted content type(s) to use with
the request
--apikey=<apikeyHeader>
Specifies the accept header to use with the request
--exists Test if the given URIs are retrievable
-h, --help Show this usage and exit
--json-path=<jsonPath>
Extract and output a JsonPath from the response
--json-value-when-missing=<jsonValueWhenMissing>
Defines the value that is output when the requested
JSON path does not exist. An empty value results
in a non-zero exit code.
--log-progress-each Output a log as each URI is being retrieved
-o, --output=FILE|DIR Specifies the name of a file or directory to write
the downloaded content. If a directory is
provided, the filename will be derived from the
content disposition or the URI's path. If not
provided, then content will be output to standard
out.
--output-filename Output the resulting filename
--prune-depth=<pruneDepth>
When using prune-others, this specifies how deep to
search for files to prune
--prune-others=GLOB[\s*,\s*GLOB...]
When set and using an output directory, files that
match the given glob patterns will be pruned if
not part of the download set. For example *.jar
--retry-count=<retryCount>
--retry-delay=<retryDelay>
in seconds
--skip-existing Do not retrieve if the output file already exists
--uris-file=<urisFile>
A file that contains a URL per line
-z, --skip-up-to-date Skips re-downloading a file that is up to date
Usage: mc-image-helper github [COMMAND]
Commands:
download-latest-asset From the latest release, downloads the first matching
asset, and outputs the downloaded filename
Usage: mc-image-helper hash
Outputs an MD5 hash of the standard input
Usage: mc-image-helper install-curseforge [-h] [--disable-api-caching]
[--force-reinstall-modloader] [--force-synchronize]
[--overrides-skip-existing] [--api-base-url=<apiBaseUrl>]
[--api-key=<apiKey>] [--downloads-repo=DIR] [--file-id=<fileId>]
[--filename-matcher=STR] [--missing-mods-filename=<missingModsFilename>]
[--modpack-manifest=PATH] [--modpack-page-url=URL] [--modpack-zip=PATH]
[-o=DIR] [--results-file=FILE] [--set-level-from=<levelFrom>]
[--slug=<slug>] [--ignore-missing-files=<ignoreMissingFiles>[,
|<nl><ignoreMissingFiles>...]]...
[--overrides-exclusions=<overridesExclusions>[NL or ,
<overridesExclusions>...]]... [[--exclude-include-file=FILE|URI]
[[--exclude-mods=PROJECT_ID|SLUG[,|<ws>PROJECT_ID|SLUG...]]...
[--force-include-mods=PROJECT_ID|SLUG[,|<ws>PROJECT_ID|SLUG...]]...]]
[[--connection-pool-max-idle-timeout=DURATION]
[--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeout=DURATION]
[--http-response-timeout=DURATION]]
[[--api-cache-ttl=OPERATION=DURATION]...
[--api-cache-default-ttl=DURATION]] [COMMAND]
Downloads, installs, and upgrades CurseForge modpacks
--api-base-url=<apiBaseUrl>
Allows for overriding the CurseForge Eternal API
used
--api-cache-default-ttl=DURATION
Set default/fallback TTL in ISO-8601 duration
format.
Default: P2D
--api-cache-ttl=OPERATION=DURATION
Set individual operation TTLs
--api-key=<apiKey> An API key allocated from the Eternal developer
console at https://console.curseforge.com/
Can also be passed via CF_API_KEY
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--disable-api-caching
--downloads-repo=DIR A local directory that will supply pre-downloaded
mod and modpack files that are marked disallowed
for automated download. The subdirectories mods,
modpacks, and worlds will also be consulted
accordingly.
--exclude-include-file=FILE|URI
A JSON file that contains global and per modpack
exclude/include declarations. See README for
schema.
--exclude-mods=PROJECT_ID|SLUG[,|<ws>PROJECT_ID|SLUG...]
For mods that need to be excluded from server
deployments, such as those that don't label as
client
--file-id=<fileId>
--filename-matcher=STR Substring to select specific modpack filename
--force-include-mods=PROJECT_ID|SLUG[,|<ws>PROJECT_ID|SLUG...]
Some mods incorrectly declare client-only support,
but still need to be included in a server deploy.
This can also be used to selectively override
exclusions.
--force-reinstall-modloader
--force-synchronize
-h, --help
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--ignore-missing-files=<ignoreMissingFiles>[,|<nl><ignoreMissingFiles>...]
These files will be ignored when evaluating if the
modpack is up to date
--missing-mods-filename=<missingModsFilename>
--modpack-manifest=PATH
Similar to --modpack-zip but provide the manifest.
json from the modpack.
Can be a local file path or a URL to a manifest.
--modpack-page-url=URL URL of a modpack page such as
https://www.curseforge.
com/minecraft/modpacks/all-the-mods-8or a file's
page
https://www.curseforge.
com/minecraft/modpacks/all-the-mods-8/files/42483
90
--modpack-zip=PATH Path to a pre-downloaded modpack client zip file
that can be used when modpack author disallows
automation.
Can also be passed via CF_MODPACK_ZIP
-o, --output-directory=DIR
--overrides-exclusions=<overridesExclusions>[NL or ,
<overridesExclusions>...]
Excludes files from the overrides that match these
ant-style patterns
* : matches any non-slash characters
** : matches any characters
? : matches one character
--overrides-skip-existing
When enabled, existing files will not be replaced
by overrides content from the modpack
--results-file=FILE A key=value file suitable for scripted environment
variables. Currently includes
SERVER: the entry point jar or script
--set-level-from=<levelFrom>
When WORLD_FILE, a world file included the modpack
will be unzipped into a folder under 'saves' and
referenced as 'LEVEL' in the results file.
When OVERRIDES and the overrides contains a world
save directory (contains level.dat), then that
directory will be referenced as 'LEVEL' in the
results file.
In either case, existing world data will be
preserved and skipped if it already exists.
Valid values: WORLD_FILE, OVERRIDES
--slug=<slug> The short-URL identifier
--tls-handshake-timeout=DURATION
Default: PT30S
Commands:
schemas Output relevant JSON schemas
Usage: mc-image-helper install-fabric-loader [-h] [--output-directory=DIR]
[--results-file=FILE] [--from-local-file=FILE | --from-url=URL |
[[--minecraft-version=VERSION] [--installer-version=VERSION]
[--loader-version=VERSION]]]
Provides a few ways to obtain a Fabric loader with simple cleanup of previous
loader instances
--from-local-file=FILE
--from-url=URL
-h, --help
--installer-version=VERSION
By default the latest installer version is used
--loader-version=VERSION
By default the latest launcher version is used
--minecraft-version=VERSION
--output-directory=DIR
--results-file=FILE A key=value file suitable for scripted environment
variables. Currently includes
SERVER: the entry point jar or script
Usage: mc-image-helper install-forge [-h] [--force-reinstall]
[--minecraft-version=VERSION]
[--output-directory=DIR]
[--results-file=FILE]
[--forge-installer=<installer> |
[--forge-version=<version>]]
[[--connection-pool-max-idle-timeout=DURATI
ON] [--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeout=
DURATION]
[--http-response-timeout=DURATION]]
Downloads and installs a requested version of Forge
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--force-reinstall
--forge-installer=<installer>
Use a local forge installer
--forge-version=<version>
A specific Forge version or to auto-resolve the
version provide 'latest' or 'recommended'.
Default value is recommended
-h, --help
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--minecraft-version=VERSION
'latest', which is the default, or a specific
version
--output-directory=DIR
--results-file=FILE A key=value file suitable for scripted environment
variables. Currently includes
SERVER: the entry point jar or script
--tls-handshake-timeout=DURATION
Default: PT30S
Usage: mc-image-helper install-modrinth-modpack [--force-modloader-reinstall]
[--force-synchronize] [--api-base-url=<baseUrl>]
[--default-exclude-includes=FILE|URI] [--default-version-type=TYPE]
[--game-version=<gameVersion>] [--loader=<loader>]
[--output-directory=DIR] --project=<modpackProject>
[--results-file=FILE] [--version=<version>]
[--exclude-files=<excludeFiles>[,|<nl><excludeFiles>...]]...
[--force-include-files=<forceIncludeFiles>[,
|<nl><forceIncludeFiles>...]]...
[--ignore-missing-files=<ignoreMissingFiles>[,
|<nl><ignoreMissingFiles>...]]...
[--overrides-exclusions=<overridesExclusions>[NL or ,
<overridesExclusions>...]]...
[[--connection-pool-max-idle-timeout=DURATION]
[--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeout=DURATION]
[--http-response-timeout=DURATION]]
Supports installation of Modrinth modpacks along with the associated mod loader
--api-base-url=<baseUrl>
Default: https://api.modrinth.com
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--default-exclude-includes=FILE|URI
A JSON file that contains global and per modpack
exclude/include declarations. See README for
schema.
--default-version-type=TYPE
Valid values: release, beta, alpha
Default: release
--exclude-files=<excludeFiles>[,|<nl><excludeFiles>...]
Files to exclude, such as improperly declared
client mods. It will match any part of the file's
name/path.
--force-include-files=<forceIncludeFiles>[,|<nl><forceIncludeFiles>...]
Files to force include that were marked as
non-server mods. It will match any part of the
file's name/path.
--force-modloader-reinstall
--force-synchronize
--game-version=<gameVersion>
Applicable Minecraft version
Default: (any)
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--ignore-missing-files=<ignoreMissingFiles>[,|<nl><ignoreMissingFiles>...]
These files will be ignored when evaluating if the
modpack is up to date
--loader=<loader> Valid values: fabric, forge, quilt, neoforge
Default: (any)
--output-directory=DIR
--overrides-exclusions=<overridesExclusions>[NL or ,
<overridesExclusions>...]
Excludes files from the overrides that match these
ant-style patterns
* : matches any non-slash characters
** : matches any characters
? : matches one character
--project=<modpackProject>
One of
- Project ID or slug
- Project page URL
- Project file URL
- Custom URL of a hosted modpack file
- Local path to a modpack file
--results-file=FILE A key=value file suitable for scripted environment
variables. Currently includes
SERVER: the entry point jar or script
--tls-handshake-timeout=DURATION
Default: PT30S
--version, --version-id=<version>
Version ID, name, or number from the file's metadata
Default chooses newest file based on game version,
loader, and/or default version type
Usage: mc-image-helper install-neoforge [-h] [--force-reinstall]
[--minecraft-version=VERSION]
[--neoforge-version=<version>]
[--output-directory=DIR]
[--results-file=FILE]
[[--connection-pool-max-idle-timeout=DUR
ATION]
[--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeo
ut=DURATION]
[--http-response-timeout=DURATION]]
Downloads and installs a requested version of NeoForge
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--force-reinstall
-h, --help
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--minecraft-version=VERSION
'latest', which is the default, or a specific
version to narrow NeoForge version selection
--neoforge-version=<version>
A specific NeoForge version, 'latest', or 'beta'.
Default value is latest
--output-directory=DIR
--results-file=FILE A key=value file suitable for scripted environment
variables. Currently includes
SERVER: the entry point jar or script
--tls-handshake-timeout=DURATION
Default: PT30S
Usage: mc-image-helper install-paper [--check-updates] [--base-url=<baseUrl>]
[-o=<outputDirectory>]
[--results-file=FILE] [--url=<downloadUrl>
| [[--project=<project>] [--build=<build>]
[--channel=<channel>]
[--version=<version>]]]
[--connection-pool-max-idle-timeout=DURATIO
N | [--tls-handshake-timeout=DURATION] |
--connection-pool-pending-acquire-timeout=D
URATION |
[--http-response-timeout=DURATION]]
Installs selected PaperMC
--base-url=<baseUrl>
--build=<build>
--channel=<channel>
--check-updates Check for updates and exit with status code 0 when
available
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
-o, --output-directory=<outputDirectory>
--project=<project>
--results-file=FILE A key=value file suitable for scripted environment
variables. Currently includes
SERVER: the entry point jar or script
--tls-handshake-timeout=DURATION
Default: PT30S
--url=<downloadUrl> Use a custom URL location
--version=<version> May be 'latest' or specific version
Usage: mc-image-helper install-purpur [--base-url=<baseUrl>]
[-o=<outputDirectory>]
[--results-file=FILE]
[--url=<downloadUrl> |
[[--version=<version>]
[--build=<build>]]]
[--connection-pool-max-idle-timeout=DURATI
ON | [--tls-handshake-timeout=DURATION] |
--connection-pool-pending-acquire-timeout=
DURATION |
[--http-response-timeout=DURATION]]
Downloads latest or selected version of Purpur
--base-url=<baseUrl>
--build=<build>
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
-o, --output-directory=<outputDirectory>
--results-file=FILE A key=value file suitable for scripted environment
variables. Currently includes
SERVER: the entry point jar or script
--tls-handshake-timeout=DURATION
Default: PT30S
--url=<downloadUrl> Use a custom URL location
--version=<version> May be 'latest' or specific version
Usage: mc-image-helper install-quilt [-h] [--force-reinstall]
[--loader-version=VERSION]
[--minecraft-version=VERSION]
[--output-directory=DIR]
[--repo-url=<repoUrl>]
[--results-file=FILE] [--installer-url=URL
| --installer-version=VERSION]
[[--connection-pool-max-idle-timeout=DURATI
ON] [--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeout=
DURATION]
[--http-response-timeout=DURATION]]
Installs Quilt mod loader
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--force-reinstall
-h, --help
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--installer-url=URL
--installer-version=VERSION
Default uses latest
--loader-version=VERSION
Default uses latest
--minecraft-version=VERSION
'latest', 'snapshot', or specific version
--output-directory=DIR
--repo-url=<repoUrl> Default: https://maven.quiltmc.
org/repository/release
--results-file=FILE A key=value file suitable for scripted environment
variables. Currently includes
SERVER: the entry point jar or script
--tls-handshake-timeout=DURATION
Default: PT30S
Usage: mc-image-helper interpolate [-h] ([--replace-env-prefix=<prefix>]
[--replace-env-excludes=FILENAME[,
FILENAME...]]...
[--replace-env-exclude-paths=PATH[,
PATH...]]... --replace-env-file-suffixes=PATH
[,PATH...] [--replace-env-file-suffixes=PATH
[,PATH...]]...) [DIRECTORY...]
Interpolates existing files in one or more directories
[DIRECTORY...]
-h, --help Show this usage and exit
--replace-env-exclude-paths=PATH[,PATH...]
Destination paths that will be excluded from processing
--replace-env-excludes=FILENAME[,FILENAME...]
Filenames (without path) that should be excluded from
processing.
--replace-env-file-suffixes=PATH[,PATH...]
Filename suffixes (without dot) that should be
processed. For example: txt,json,yaml
--replace-env-prefix=<prefix>
Only placeholder variables with this prefix will be
processed.
Default: CFG_
Usage: mc-image-helper java-release
Outputs the Java release number, such as 8, 11, 17
Usage: mc-image-helper manage-users [-fh] [--existing=<existingFileBehavior>]
[--mojang-api-base-url=<mojangApiBaseUrl>]
[--output-directory=<outputDirectory>]
[--playerdb-api-base-url=<playerdbApiBaseUrl
>] -t=<type>
[--user-api-provider=<userApiProvider>]
[--version=<version>]
[[--connection-pool-max-idle-timeout=DURATIO
N] [--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeout=D
URATION]
[--http-response-timeout=DURATION]] [INPUT[,
INPUT...]...]
[INPUT[,INPUT...]...] One or more Mojang usernames, UUID, or ID (UUID
without dashes); however, when offline, only
UUID/IDs can be provided.
When input is a file, only one local file path or
URL can be provided
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--existing=<existingFileBehavior>
Select the behavior when the resulting file already
exists
Allowed: SYNCHRONIZE, MERGE, SKIP
-f, --input-is-file
-h, --help
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--mojang-api-base-url=<mojangApiBaseUrl>
--output-directory=<outputDirectory>
--playerdb-api-base-url=<playerdbApiBaseUrl>
-t, --type=<type> Allowed: JAVA_WHITELIST, JAVA_OPS
--tls-handshake-timeout=DURATION
Default: PT30S
--user-api-provider=<userApiProvider>
Allowed: mojang, playerdb
--version=<version> Minecraft game version. If not provided, assumes
JSON format
Usage: mc-image-helper maven-download [-h] [--print-filename] [--skip-existing]
[--skip-up-to-date] -a=<artifact>
[--classifier=<classifier>] -g=<group>
[--output-directory=<outputDirectory>]
[--packaging=<packaging>]
[-r=<mavenRepo>] [-v=<version>]
[[--connection-pool-max-idle-timeout=DURAT
ION] [--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeout
=DURATION]
[--http-response-timeout=DURATION]]
Downloads a maven artifact from a Maven repository
-a, -m, --module, --artifact=<artifact>
--classifier=<classifier>
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
-g, --group=<group>
-h, --help
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--output-directory=<outputDirectory>
--packaging=<packaging>
--print-filename
-r, --maven-repo=<mavenRepo>
--skip-existing
--skip-up-to-date
--tls-handshake-timeout=DURATION
Default: PT30S
-v, --version=<version> A specific version, 'release', or 'latest'
Default: release
Usage: mc-image-helper mcopy [-hz] [--file-is-listing] [--skip-existing]
[--glob=GLOB] [--scope=<manifestId>] --to=<dest>
SRC[,|<nl>SRC...]...
Multi-source file copy operation with with managed cleanup. Supports
auto-detected sourcing from file list, directories, and URLs
SRC[,|<nl>SRC...]... Any mix of source file, directory, or URLs.
Can be optionally comma or newline separated.
--file-is-listing Source files or URLs are processed as a line
delimited list of sources.
For remote listing files, the contents must all be
file URLs.
--glob=GLOB When a source is a directory, this filename glob
will be applied to select files.
-h, --help
--scope, --manifest-id=<manifestId>
If managed cleanup is required, this is the
identifier used for qualifying manifest filename
in destination
--skip-existing
--to, --output-directory=<dest>
-z, --skip-up-to-date
Usage: mc-image-helper modrinth [--skip-existing] [--skip-up-to-date]
[--allowed-version-type=<defaultVersionType>]
[--api-base-url=<baseUrl>]
[--download-dependencies=<downloadDependencies>]
--game-version=<gameVersion> --loader=<loader>
[--output-directory=DIR]
[--world-directory=<worldDirectory>]
[--projects=id|slug[,|<nl>id|slug...]]...
[[--connection-pool-max-idle-timeout=DURATION]
[--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeout=DURAT
ION] [--http-response-timeout=DURATION]]
Automates downloading of modrinth resources
--allowed-version-type=<defaultVersionType>
Valid values: release, beta, alpha
--api-base-url=<baseUrl>
Default: https://api.modrinth.com
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--download-dependencies=<downloadDependencies>
Default is NONE
Valid values: NONE, REQUIRED, OPTIONAL
--game-version=<gameVersion>
Applicable Minecraft version
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--loader=<loader> Valid values: fabric, quilt, forge, neoforge, bukkit,
spigot, paper, pufferfish, purpur, bungeecord,
velocity, datapack
--output-directory=DIR
--projects=id|slug[,|<nl>id|slug...]
Project ID or Slug
--skip-existing
--skip-up-to-date
--tls-handshake-timeout=DURATION
Default: PT30S
--world-directory=<worldDirectory>
Used for datapacks, a path relative to the output
directory or an absolute path
Default: world
Usage: mc-image-helper network-interfaces [--include-loopback]
[--check=<ifNameToCheck>]
Provides simple operations to list network interface names and check existence
--check=<ifNameToCheck>
--include-loopback
Usage: mc-image-helper patch [-h] [--patch-env-prefix=<envPrefix>] FILE_OR_DIR
Patches one or more existing files using JSON path based operations
Supports the file formats:
- JSON
- JSON5
- Yaml
- TOML, but processed output is not pretty
FILE_OR_DIR Path to a PatchSet json file or directory containing
PatchDefinition json files
-h, --help Show this usage and exit
--patch-env-prefix=<envPrefix>
Only placeholder variables with this prefix will be
processed
Default: CFG_
Usage: mc-image-helper resolve-minecraft-version
[[--connection-pool-max-idle-timeout=DURATION]
[--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeout=DURATION]
[--http-response-timeout=DURATION]] <inputVersion>
Resolves and validate latest, snapshot, and specific versions
<inputVersion>
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations. Parsed
from ISO-8601 format. Default: PT30S
--tls-handshake-timeout=DURATION
Default: PT30S
Usage: mc-image-helper set-properties [--escape-unicode]
[--definitions=<propertyDefinitionsFile>]
[-p=<String=String>]... <propertiesFile>
Maps environment variables to a properties file
<propertiesFile>
--definitions=<propertyDefinitionsFile>
JSON file of property names to PropertyDefinition
mappings
--escape-unicode
-p, --custom-property, --custom-properties=<String=String>
Key=value pairs of custom properties to set
Usage: mc-image-helper show-all-subcommand-usage
Renders all of the subcommand usage as markdown sections for README
Usage: mc-image-helper sync [-h] [--skip-newer-in-destination] <src> <dest>
Synchronizes the contents of one directory to another.
<src> source directory
<dest> destination directory
-h, --help Show this usage and exit
--skip-newer-in-destination
Skip any files that exist in the destination and have a newer
modification time than the source.
Usage: mc-image-helper sync-and-interpolate [-h] [--skip-newer-in-destination]
([--replace-env-prefix=<prefix>] [--replace-env-excludes=FILENAME[,
FILENAME...]]... [--replace-env-exclude-paths=PATH[,PATH...]]...
--replace-env-file-suffixes=PATH[,PATH...]
[--replace-env-file-suffixes=PATH[,PATH...]]...) <src> <dest>
Synchronizes the contents of one directory to another with conditional variable
interpolation.
<src> source directory
<dest> destination directory
-h, --help Show this usage and exit
--replace-env-exclude-paths=PATH[,PATH...]
Destination paths that will be excluded from processing
--replace-env-excludes=FILENAME[,FILENAME...]
Filenames (without path) that should be excluded from processing.
--replace-env-file-suffixes=PATH[,PATH...]
Filename suffixes (without dot) that should be processed. For
example: txt,json,yaml
--replace-env-prefix=<prefix>
Only placeholder variables with this prefix will be processed.
Default: CFG_
--skip-newer-in-destination
Skip any files that exist in the destination and have a newer
modification time than the source.
Usage: mc-image-helper test-logging-levels
Usage: mc-image-helper vanillatweaks [--force-synchronize]
[--base-url=<baseUrl>]
[--output-directory=DIR]
[--world-subdir=<worldSubdir>]
[--pack-files=FILE[,|<nl>FILE...]]...
[--share-codes=CODE[,|<nl>CODE...]]...
[[--connection-pool-max-idle-timeout=DURATI
ON] [--tls-handshake-timeout=DURATION]
[--connection-pool-pending-acquire-timeout=
DURATION]
[--http-response-timeout=DURATION]]
Downloads Vanilla Tweaks resource packs, data packs, or crafting tweaks given a
share code or pack file
--base-url=<baseUrl>
--connection-pool-max-idle-timeout=DURATION
--connection-pool-pending-acquire-timeout=DURATION
--force-synchronize
--http-response-timeout=DURATION
The response timeout to apply to HTTP operations.
Parsed from ISO-8601 format. Default: PT30S
--output-directory=DIR
--pack-files=FILE[,|<nl>FILE...]
--share-codes=CODE[,|<nl>CODE...]
--tls-handshake-timeout=DURATION
Default: PT30S
--world-subdir=<worldSubdir>
Usage: mc-image-helper yaml-path [--file=<yamlFile>] <yamlPath>
Extracts a path from a YAML file using json-path syntax
<yamlPath> A YAML/JSON path in to query. Leading root anchor, $,
will be added if not present
--file=<yamlFile> A YAML file to query
patches: array of PatchDefinition
Example
{
"patches": [
{
"file": "/data/paper.yml",
"ops": [
{
"$set": {
"path": "$.verbose",
"value": true
}
},
{
"$set": {
"path": "$.settings['velocity-support'].enabled",
"value": "${CFG_VELOCITY_ENABLED}",
"value-type": "bool"
}
},
{
"$put": {
"path": "$.settings",
"key": "my-test-setting",
"value": "testing"
}
}
]
}
]
}file: Path to the file to patchfile-format: optional If non-null, declares a specifically supported format name: json, yaml. Otherwise, the file format is detected by the file's suffix.ops: array of PatchOperation
Example:
{
"file": "/data/paper.yml",
"ops": [
{
"$set": {
"path": "$.verbose",
"value": true
}
},
{
"$set": {
"path": "$.settings['velocity-support'].enabled",
"value": "${CFG_VELOCITY_ENABLED}",
"value-type": "bool"
}
},
{
"$put": {
"path": "$.settings",
"key": "my-test-setting",
"value": "testing"
}
}
]
}Each patch operation object contains a single key that one is one of the following sections and then an object within each. For example { "$set" : { ... } }.
The $set operation can set an existing field to a new value. If a new field needs to be added, use the $put operation.
$set
Example:
{
"$set": {
"path": "$.verbose",
"value": true
}
}The $put operation can add or update a field with the given key within an object.
$putpath: The JSON path to the object containing key to setkey: The key to setvalue: The value to set. If the given value is a string, variable placeholders of the form${...}will be replaced from the environment variables and the resulting string can be converted by setting value-type.value-type: optional see below
Example:
{
"$put": {
"path": "$.settings",
"key": "my-test-setting",
"value": "testing"
}
}One of the following identifiers or can be prefixed with list of to indicate a list of the identified type:
- int : integer/whole value
- float : numerical value with an optional decimal part
- bool : boolean value of
trueorfalse - auto : where the text value is attempted to be converted into one of the above
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Mods Exclude/Include File Content",
"type": "object",
"additionalProperties": false,
"properties": {
"globalExcludes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Mods by slug|id to exclude for all modpacks"
},
"globalForceIncludes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Mods by slug|id to force include for all modpacks"
},
"modpacks": {
"type": "object",
"additionalProperties": {
"$ref": "#/definitions/ExcludeIncludes"
},
"description": "Specific exclude/includes by modpack slug"
}
},
"definitions": {
"ExcludeIncludes": {
"type": "object",
"additionalProperties": false,
"properties": {
"excludes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Mods by slug|id to exclude for this modpack"
},
"forceIncludes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Mods by slug|id to force include for this modpack"
}
}
}
}
}
![@dependabot[bot]](/~https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
