Skip to content

mod.yml format

Properties

Name Type Optional Default Value Notes
id string Mod ID used internally and rarely displayed to the user (accepts uppercase characters for now, but not recommended)
name string id in mod.yml Mod Name that would be displayed to the user (defaults to id)
version string Mod version (type is string but you can specify number)
main string Main class of your mod (specify the class which extends BlueberryMod)
author string null If authors is present, author will be inserted at the last entry of the authors.
credit string null If credits is present, credit will be inserted at the last entry of the credits.
authors string list null If author is present, author will be inserted at the last entry of the authors.
credits string list null If credit is present, credit will be inserted at the last entry of the credits.
description string list null Must be string list, not string. 1 entry = 1 line
unloadable boolean false If true, user can click the Disable (equivalent to unload) button in mod list screen.
depends string set empty set Set of required mod ids (the mod will not load without satifying the depends)
softDepends string set empty set Set of optional mod ids (unlike depends, the mod can be loaded without satifying the softDepends)
source boolean false See Source mod
sourceDir string null See Source mod
include string null See Source mod

Very basic example

mod.yml
id: example_mod
name: ExampleMod # optional but recommended
version: 1.0.0
main: com.example.ExampleMod