Skip to content

Configuration Reference

Sokratis Fotkatzikis edited this page Nov 4, 2026 · 1 revision

Settings are stored in config/mobsettings-common.toml.

Setting Format Description
dropOnlyOnPlayerKill true / false Only give extra drops when a player gets the kill
removeDrops entity|item|[chance]|[dimension] Remove items from normal drops
extraDrops entity|item|[count]|[chance]|[looting]|[dimension] Add extra item drops
removeSpawns entity|[dimension]|[biome]|[percent] Remove or reduce natural biome spawns
addSpawns entity|[dimension]|[biome]|weight|[minGroup]|[maxGroup]|[useSpawnRules] Add natural biome spawns
spawnGroupSizes entity|[dimension]|[biome]|minGroup|[maxGroup] Change group size of existing spawns
attributeOverrides entity|[dimension]|attribute|value Change a mob's base attributes
damageModifiers entity|[dealt]|[taken]|[dimension] Multiply damage a mob deals and/or takes
experienceModifiers entity|[dimension]|multiplier Multiply the experience a mob drops
despawnRanges entity|range|[dimension] Set despawn distance from players
lightSpawnRestrictions entity|[minLight]|[maxLight]|[dimension]|[biome] Limit natural spawns by light level

Fields in [brackets] are optional: leave them off the end of a line, or write ? to skip one and set a later field. entity can be an entity ID, an entity tag (#namespace:tag), modid:* or *. biome can be a biome ID, a biome tag (#namespace:tag) or *.

See Writing Rules for the general syntax rules, and Custom Mob Drops, Custom Mob Spawning and Mob Stats and Behavior for detailed examples of each setting.

Applying Changes

  • removeSpawns, addSpawns and spawnGroupSizes apply after reloading the world (or restarting the server). The config screen will prompt you.
  • All other settings apply as soon as the config is saved.
  • Invalid entries are logged as a warning with the reason, so you can find out why a line isn't working.

Multiplayer

The server's config decides how mobs behave. Edit the config file on the server; the in-game screen edits your local copy.

Config Upgrades

Older config files are upgraded automatically the first time they load. Spawn and attribute lines without a dimension are rewritten with a * dimension and mean the same as before. The configVersion setting tracks this, so please don't edit it.

Clone this wiki locally