Mob Drop Commands | MMO Skill Tree Docs

Overview

Mob Drop Commands run console commands and/or a native item drop when a player kills a mob. Use it to hand out custom items via another mod, award currency, trigger a broadcast, or spawn ground-item loot at the corpse. Each pool has its own chance, delay, and optional player-facing notification.

Opt-in, zero default pools

The mod ships with no default drop pools. This feature does nothing on a fresh install; a server owner must author entries in mob-drop-commands.json (or ship them in a pack) before any bonus drop fires. There is no on-by-default 5%-per-kill drop.

Override configmods/mmoskilltree/mob-drop-commands.json

The file stores your authored pools; there are no shipped defaults to override.

File Structure

{
  "schemaVersion": 2,
  "overrides": {
    "Trork_Warlord": {
      "disabled": false,
      "pools": [
        {
          "commands": ["give {player} Weapon_Longsword_Flame --quantity=1"],
          "chance": 0.05,
          "delay": 5,
          "notification": {
            "enabled": true,
            "color": "#4a9eff",
            "icon": "icon_loot",
            "primaryKey": "notify.mob_drop",
            "secondaryKey": "notify.mob_drop.hint"
          }
        },
        {
          "dropList": "trork_warlord_bonus_loot",
          "chance": 1.0,
          "delay": 0
        }
      ]
    }
  }
}

Each key under overrides is a mob pattern. Each mob has a list of pools; every pool rolls independently on kill. Setting disabled: true on a pattern suppresses all pools for it.

Pool Fields

Field	Default	Purpose
`commands`	`[]`	Optional. One or more console commands to run. See placeholders.
`dropList` Since 1.5.0	`null`	Optional. The id of a native Hytale `ItemDropList` asset. When set, the pool spawns that drop list's ground items at the corpse - no console command needed. A pool can set `dropList`, `commands`, or both.
`chance`	`1.0`	Roll threshold (0.0–1.0). 1.0 means always.
`delay`	`0`	Delay in ticks before commands run. Useful to sequence multiple drops.
`notification`	optional	Localized floating notification. See notifications.

Placeholders

Command strings may use these placeholders:

{player} - killer's username
{mob} - mob type identifier (e.g. Trork_Warlord)

Notifications

A notification block produces a floating cue for the killing player when the pool fires. The primaryKey and secondaryKey fields are localization keys resolved against the lang files.

Pattern Matching

Mob patterns follow the same longest-substring rule as Mob Kill XP. When a mob dies, its type identifier is compared against every pattern and the longest match wins. More specific patterns (e.g. Trork_Warlord) take priority over shorter ones (e.g. Trork).

All pools under the winning pattern roll independently.

No elite-tier filter today

The built-in Elite Mobs system was removed in 1.5.0. There is currently no server-side mob-tier qualifier a pool can filter on, so every pool under a matched pattern rolls on every kill of that mob, with no way to make a pool boss-only. Mob difficulty scaling now comes from the separate, optional MMO Mob Scaling companion mod; if it adds a rarity/tier concept, a future qualifier would consume it here.

Admin Dashboard

The admin dashboard has a Mob Drop Cmds page under /mmoadmin that lets you add, edit, and remove pools without hand-editing the JSON. Changes persist to mob-drop-commands.json and take effect on the next kill - no restart required.