Skip to main content

Bundle metadata

Every bundle carries a .bundles.toml file that the engine reads to identify it. The file sits at the bundle root and is named <bundleId>.bundles.toml.

Fields

mybundle.bundles.toml
[[bundles]]
bundleId = "mybundle"
version = "1.0.0"
displayName = "My Bundle"
displayURL = "https://example.com/my-bundle"
authors = "Your Name"
description = "What this bundle does."
dependencies = [
"mod:neoforge@26.1.0.1-beta"
]
FieldMeaning
bundleIdUnique id. Used as the namespace for Identifiers and the script package.
versionSemVer string MAJOR.MINOR.PATCH.
displayNameName shown in lists and menus.
displayURLLink shown in the bundle info.
authorsAuthor name or list.
descriptionShort summary.
dependenciesList of dependencies, like mod:neoforge@26.1.0.1-beta.

The bundle id is the namespace

bundleId becomes the namespace of every Identifier you create, so id("magic_gem") with bundle id mybundle resolves to mybundle:magic_gem. Two bundles with the same id collide, so keep ids unique.