Skip to main content

Group Loot (Need / Greed)

When several players team up, EliteMobs can distribute gear through a Need / Greed voting system. Each item is rolled among eligible players, and the winner receives it. Items whose loot policy requires Soulbind are bound to the winner when the Soulbind system is enabled.

When group loot triggers​

There are two ways a vote can start:

  • Party loot: when at least two members of the same party are online, in the same world, and within sharedProgressRange of the defeated Elite (128 blocks by default), normal Elite equipment, special Elite gear, and eligible custom items enter one vote for that party. Nearby members can participate even if they did not land the killing hit. Coins and Elite Scrolls remain personal.
  • Difficulty-specific dungeon loot: custom equipment with a matching difficultyID inside an instanced dungeon uses the original dungeon-wide vote for the boss's combat contributors. Custom items that are not equipment remain personal.

If fewer than two eligible players remain when a party item is being added, that item falls back to the normal personal delivery path. An already-created party vote can continue with one eligible player after somebody leaves; a dungeon pool created with fewer than two initial participants is scheduled for delivery on the next tick. Losing participants later does not itself shorten an existing timer. Instanced-dungeon boss lockouts are applied before a player is admitted to a vote.

Party votes can collect drops from multiple Elites during the same roll session. Eligibility is saved separately for each item, so someone who arrives later only sees and rolls on drops for which they were nearby and eligible.

A loot entry's permission and the custom item's own permission also limit each item's vote: only players allowed to receive the item are admitted to its roll and see it in the menu.

Normal generated equipment still requires an eligible direct attacker to deal at least 10% of the Elite's maximum health before the loot roll. That threshold does not apply separately to nearby party members admitted to the vote.

Voting on loot​

Players open the vote with /em loot or by clicking the prompt in chat. The command sets no permission node, so anyone can run it — the elitemobs.loot.command node declared in plugin.yml is never actually checked.

The menu has two columns:

  • Greed (left) — the default state. Items sit here until someone claims them. If you only want an item should nobody else need it, leave it on the greed side.
  • Need (right) — click an item to move it to your Need list. Everyone in the group is notified when you mark or unmark an item as Need.

The menu shows up to 20 items per page and adds previous/next arrows for larger pools. If several independent loot sessions overlap, running /em loot again cycles through them.

Need is a player's choice; the menu does not require the matching class or gear skill level. Winning an item does not bypass its equipment restrictions.

The normal voting window ends after 60 seconds without a new item. A new party drop refreshes that inactivity window, but lootVoteMaximumLifetimeSeconds in Party.yml puts a hard limit on the complete party session (120 seconds by default, minimum 60). Marking and unmarking items does not extend either timer; click an item in the greed column to need it, then click it in the need column to drop your claim.

How items are awarded​

When the timer runs out, each item is rolled independently:

  • If one or more players marked it as Need, the item is randomly awarded to one of those players.
  • If nobody needed it, it is randomly awarded among all currently online players eligible for that item (the greed roll).

The winner receives the item directly into their inventory, with overflow dropped at their feet and assigned to their UUID as owner. Soulbind applies when enabled and required by the item's loot policy. Everyone still active in the vote sees the winner message. A player who logs out or leaves the party is removed from that party's active vote. Moving away after admission does not itself remove eligibility. If nobody eligible remains online, the item drops at the session's saved Elite location when that world is still loaded; a party session uses the first Elite's location. Items limited by a permission, or custom items that are disabled or permission-restricted, are discarded instead of dropping where anyone could pick them up.

Pending votes are kept in memory. EliteMobs shutdown clears them without distributing the pending items, so let active votes finish before restarting or reinitializing the plugin.

Command and permission​

CommandPermissionDefaultDescription
/em loot(none set)--Opens the group-loot Need/Greed menu for your current pending loot

If you run /em loot with no loot to vote on, EliteMobs tells you there is nothing to vote on.