index.toml

The index file of the modpack, storing references to every file to be downloaded in the pack.

Example:

hash-format = "sha256"

[[files]]
file = "mod.toml"
hash = "a82d23948043048cef6208c8cc8bdac1ea42b6f8d6d73074ea0ab9a955f7ddf2"
metafile = true

Properties

Property	Type	Required	Description
files	object[]	Yes	The files listed in this index.
hash-format	string	Yes	A hashing format used to detect if a file has changed. You may use your own hash format, but the valid values here should be supported and expected for most packs, especially SHA-256 and Murmur2. Possible values are: md5, murmur2, sha256, sha512.

files

A single file in the index, to be downloaded by the modpack installer.

Properties

Property	Type	Required	Description
file	string	Yes	The path to the file to be downloaded, relative to this index file.
hash	string	Yes	The hash of the specified file, as a string. Binary hashes should be stored as hexadecimal, and case should be ignored during parsing. Numeric hashes (e.g. Murmur2) should still be stored as a string, to ensure the value is preserved correctly.
alias	string	No	The name with which this file should be downloaded, instead of the filename specified in the path. Not compatible with metafile, and may not be very well supported.
hash-format	string	No	The hash format (algorithm) for the hash of the specified file. Defaults to the hash format specified in the index - ideally remove this value if it is equal to the hash format for the index to save space. Possible values are: md5, murmur2, sha256, sha512.
metafile	boolean	No	True when this entry points to a .toml metadata file, which references a file outside the pack. Defaults to false when omitted.
preserve	boolean	No	When this is set to true, the file is not overwritten if it already exists, to preserve changes made by a user. Defaults to false when omitted.