module loot

🎁 Loot

The Loot module manages custom loot drops for killed entities, supporting visual loot boxes, holograms, particle effects, party roll modes, and entity filtering. It enhances the reward experience for players by making loot feel more dynamic and customizable.

---

📁 File Location

plugins/Divinity/modules/loot/settings.yml

---

🛠️ Configuration Example

command-aliases: loot,qloot

general:
  protect-drop: true
  time-to-loot: 300
  entity-blacklist:
  - ARMOR_STAND
  mythic-blacklist:
  - SkeletonKing123
  world-blacklist:
  - someworld
  - anotherworld
  region-blacklist:
  - mob_arena
  - myregion123
  spawn-reason-blacklist:
  - SPAWNER
  death-cause-blacklist:
  - LAVA

lootbox:
  skull-hash: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYWFhMzY4MzY1YjYwMzM3NWQ1Y2RkYTlkYWE5MjRiOTY0YjFmMTE4YTcyNTAxODdhNjk2YTA3ZmYxOGNmMDIifX19
  particles:
    static: SPELL_WITCH
    despawn: CLOUD
  holograms:
    enabled: true
    text:
    - '&f%entity%&7''s Loot'
    - '&6» &eTime: &6%time%'
    - '&6» &eOwner: &6%owner%'

party:
  drop-modes:
    roll-time: 15

💡 Note: The skull-hash field defines the visual appearance of the lootbox using a custom player head texture.
You can generate skull hashes using websites like:
• https://minecraft-heads.com
• https://minecraft.tools/en/skull.php

---

🔑 Key Sections

⚙️ general

• protect-drop: If true, only the killer (or party members) can loot it.
• time-to-loot: Duration (in seconds) before loot despawns.
• *_blacklist: Prevents loot drops based on:
  • entity-blacklist: Blocks entities like ARMOR_STAND.
  • mythic-blacklist: Blocks MythicMob names.
  • world-blacklist, region-blacklist: Disables loot in specific areas.
  • spawn-reason-blacklist: Filters by spawn type (e.g., SPAWNER).
  • death-cause-blacklist: Blocks loot from causes like LAVA.

🎁 lootbox

• skull-hash: Sets a custom head texture for the loot container.
• particles: Visual effects for spawn (static) and despawn (despawn).
• holograms: Floating text showing mob name, timer, and owner.

👫 party.drop-modes

• roll-time: Duration for party loot roll bidding.

---

💬 Commands & Permissions

Command	Description	Permission
/loot help	Show help page	divinity.loot.help
/loot reload	Reload the module	divinity.loot.reload