SpreadLoot

# SpreadLoot — Smart Loot Distribution System for Minecraft 1.21.1 (NeoForge)

SpreadLoot is a mod for NeoForge 1.21.1 that allows server administrators to organize resource collection and distribution. The mod automatically collects items from specially marked chests and distributes them to other chests according to configured rules.

Core Features

Chest Tagging

Take any item and rename it to the tool name (default: Reg).
Press Shift + Right Click on a chest, barrel, or shulker box to add it to the mod registry.
Each registered chest is bound to its owner (the player who tagged it).
Pressing Shift + Right Click again removes the tag.

Chest Types (by renaming)

Default Name | Role
---|---
Res / RareRes / EpicRes / LegRes | Resource sources. The mod takes items from these chests for distribution. Each category has its own weight.
Res+ | Plus chests. Their contents always go into every loot chest.
Loot | Target chests. The mod places collected resources into these chests.

Weight Categories

Res — weight 8
RareRes — weight 4
EpicRes — weight 2
LegRes — weight 1

Higher weight means items from this category appear more often.

Distribution Modes

Copy (copy) — items are placed in full stacks.
Random (random) — a random amount is taken from each stack.

Auto Cleanup

Every 60 minutes the mod checks all registered chests and removes destroyed ones.
Registry saves every 5 seconds.
All files are saved via temporary file with atomic move.

World Scanning

The /spreadloot scan <radius> command allows you to:
Scan all chunks within the radius.
Automatically register found chests with custom names.
Collect resources and distribute them to loot chests within the radius.

Permission System

The mod supports several admin levels:
1. Server operators (permission level 2+).
2. Singleplayer world owner or LAN host.
3. Trusted UUIDs — set via config or /spreadloot trust <player>.
4. Trusted name (fallback for offline mode).

Change Tracking

Loot chests — messages are visible to all players.
Sources — notifications are sent only to the tag owner.

/set Parameters

Parameter | Value | Description
---|---|---
min | number (0-64) | Minimum items per chest
max | number (0-64) | Maximum items per chest
mode | copy or random | Distribution mode
tool | name | Tool name for tagging
res | name | Res category name
resplus | name | Plus chest name
rareres | name | RareRes category name
epicres | name | EpicRes category name
legres | name | LegRes category name
loot | name | Target chest name

Configuration Files

The mod creates two JSON files in the world folder:

spreadloot_settings.json — all mod settings (names, weights, limits, trusted data).

spreadloot_registry.json — registry of all tagged chests with owner binding. If the main file is corrupted, the mod restores from backup.

Usage Example

1. Set names: /spreadloot set tool Finder, /spreadloot set loot Reward

2. Players take the Finder item, press Shift+Right Click on chests with resources — they get registered.

3. Extra items are placed into Res+ chests.

4. Empty chests named Reward are created.

5. Admin runs /spreadloot spread confirm — resources are distributed to Reward chests.

6. Players open Reward chests and collect the loot.