Skip to content

Entities Configuration

TheIllusiveC4 edited this page Dec 31, 2020 · 2 revisions

Overview

The champions-entities.toml file is generated automatically when loading up a world with Champions for the first time. It is located in the serverconfig folder in your world save folder. This page will provide detailed explanations about the properties of the toml objects.

Note that this configuration file is only necessary to configure the settings for specific entities. No configuration is necessary to simply have a mob spawn as a champion in general.

TOML Fields

Entity

entity = <name of entity>

The entity field holds the entity name, in the format "modid:resourcelocation". This determines which entity this entry is applied to.

This is a required field.

Tier

minTier = <integer> maxTier = <integer>

The minTier and maxTier fields hold integer numbers for the minimum and maximum tier that this entity can spawn with. Note that a minimum tier of 0 means that they can spawn as non-champions.

Preset Affixes

presetAffixes = [<list of affixes>]

The presetAffixes field holds a list of affix identifier names that an entity will always spawn with if they are a champion. This will count towards the total number of affixes they can get and may even be higher than that number.

Affix List

affixList = [<list of affixes>]

The affixList field holds a list of affix identifier names that will be used with the affix permission field.

Affix Permission

affixPermission = "BLACKLIST/WHITELIST"

The affixPermission field determines whether the affix list field represents a blacklist or a whitelist.

Example

[[entities]]
  entity = "minecraft:creeper"
  minTier = 0
  maxTier = 4
  presetAffixes = []
  affixList = ["knocking", "wounding", "paralyzing", "molten"]
  affixPermission = "BLACKLIST"

From this configuration, the entity is given as the vanilla creeper. Creepers will spawn as either a non-champion or a champion with tier up to 4. It has no preset affixes and the Knocking, Wounding, Paralyzing, and Molten affixes are blacklisted from ever appearing on creepers.