SpreadLoot

💎 SpreadLoot — smart loot distribution for Minecraft 1.21.1 (NeoForge)

Automatically copies items from tagged source containers to receivers with configurable weight, quantity, and mode.

🏷️ Tagging
• Rename any item to the tool name (default: Reg).
• Shift + right‑click a container → apply/remove tag (owner = player).
• Foreign tags can only be removed by the owner or the server host.

📦 Container Roles (by custom name)
• Loot – receiver (contents replaced on distribution).
• Res (weight 8) or 1Res … 16Res – source with weight (1 = rare, 16 = frequent).
• 0Res and 17Res are ignored.

⚖️ Weight
Higher weight → higher chance for items from that source to appear in each receiver.

🔄 Distribution Modes
• copy – copies the exact quantity from the source (Res).
• random – picks a random amount between 1 and the source size.

⚙️ Settings (/spreadloot set)
• min/max (0–64) – limits per receiver.
• mode copy|random – distribution mode.
• tool / loot – custom names for the tagging tool and receivers.
• particles on|off – visual effects above tagged chests.
• protection on|off – prevents breaking, explosions, placing adjacent chests, hoppers, and rails underneath.

🛡️ Protection & Permissions
• Regular commands require OP level 2.
• Settings changes require host (level 4).
• Host can temporarily pause access for a specific player: /spreadloot pause on|off <player>

🌍 Scanning
/spreadloot scan <radius> – automatically discovers and processes tagged containers in loaded chunks within the given radius.

🧹 Auto‑cleanup
Removes outdated registry entries for containers that no longer exist or have been renamed.

💾 Data Management
• Atomic save to spreadloot_registry.json with an automatic backup.
• Settings stored in spreadloot_settings.json.
• Both files are saved in the world folder.

📢 Notifications
All key actions (tagging, distribution, errors) are broadcast to chat.

❓ Help: /sl help or /spreadloot help