Skip to content

Latest commit

 

History

History
163 lines (139 loc) · 3.48 KB

README.md

File metadata and controls

163 lines (139 loc) · 3.48 KB

MobTables

Ever wanted to change mob spawning easily? Then this is the right Plugin for you!

Features

  • Create custom rules for each mob in a familiar loottable like syntax
  • Disable the spawning of mobs not defined in the config

Configuration

Define when, where and how mobs should spawn.

Schema

spawning.yml

keepVanillaSpawning: false | true
pools:
  - rolls: 1 | number(min 1)
    conditions:
      ...conditions...
    entries:
      - type: PIGLIN | mob name in caps, like in spigot/ppaer
        chance: 0.2 | float always with . like 1.0 , from 0.0 to 1.0
        attributes:
          ...attributes...
        conditions:
          ...conditions...
  ...

Conditions

All conditions are combined with a logical AND and can be inverted with invert: true in their definition.

Biome

- type: biome
  biome: BASALT_DELTAS | biome name in caps, like in spigot/paper

Block

mode: single block

default offset is x = 0; y = -1; z = 0

- type: block
  filter:
    - GRASS_BLOCK | block name in caps, like in spigot/paper. Combined with OR
    - STONE
    ...
  offset: | optional
    x: 0
    y: -1
    z: 0

mode: volume

- type: block
  filter:
    - GRASS_BLOCK | block name in caps, like in spigot/paper. Combined with OR
    - STONE
    ...
  offset1: | pos1 like in /fill or worldedit, including this position
    x: -1
    y: -1
    z: -1
  offset2: | pos2 like in /fill or worldedit, including this position
    x: 1
    y: 1
    z: 1

Entitylimit

inverting can be used to only spawn when entity is present

- type: entity_limit
  range: 100 | block range to count mobs in
  limit: 10 | max amount (non inclusive) of mobs to exist for this to be true
  filter:
    - GHAST | mob name in caps, like in spigot/paper. Combined with OR
    ...

Attributes

Currently supported attributes to spawn mobs with. Open a issue if you want one added.

Size

Sets the size of slimes and magma cubes. Starts at 0.

- values:
    Size: 3 | int, min 0
  conditions:
    ...conditions...

IsImmuneToZombification

When set to true: Stops Piglins from converting into Zombiefied Piglins.

- values:
    IsImmuneToZombification: true | false
  conditions:
    ...conditions...

Ranges

Most integer inputs can be replaced with ranges, where a random value is picked from (all options have the same probability). This can be done in two ways, both do the same.

Option 1

...:
  from: 10 | min, inclusive
  to: 20 | max, inclusive

Option 2

...: 10..20 | min..max , both inclusive

Examples

Examples to base your config on

Spawn piglins in desserts

spawning.yml

keepVanillaSpawning: true
pools:
  - rolls: 1
    conditions:
      - type: biome
        biome: DESERT
    entries:
      - type: PIGLIN
        chance: 0.2

Spawn magmacubes on magma blocks

spawning.yml

keepVanillaSpawning: true
pools:
  - rolls: 1
    conditions:
      - type: block
        filter:
          - MAGMA_BLOCK
    entries:
      - type: MAGMA_CUBE
        chance: 1.0