Systems

Kill Drops

Extra loot that any creature may drop when a player kills it - typically event candy from every mob. Rules are data in config/killdrops/*.json.


Configuration

{
  "rules": [
    {
      "id": "halloween-candy-anymob",
      "eventId": "halloween",
      "excludeCodes": ["alegacyevents:*", "game:butterfly-*", "game:bee-*"],
      "chance": 0.08,
      "items": [
        "alegacyevents:halloweencandy-candycorn",
        "alegacyevents:halloweencandy-caramelapple"
      ],
      "minQuantity": 1,
      "maxQuantity": 1
    }
  ]
}
FieldDefaultDescription
idnoneName used in log warnings
eventIdnoneOnly while this seasonal event is active
entityCodes[]Entity codes, wildcards allowed. Empty = every creature
excludeCodes[]Entities that never drop (wildcards allowed), for example creatures with their own loot
chance0.1Drop chance per kill
itemsrequiredItem (or block) codes; one is picked at random per drop. A rule without items is ignored
minQuantity, maxQuantity1, 1Stack size, random in range

Rules:

  • The killer must be a player. Players are never a source.
  • Each rule rolls independently, so several rules can drop from one kill.
  • The item spawns at the dead creature's position as a normal item entity.
  • An unknown item code logs a warning and skips the drop.

Press ESC to close