Loot Spawn Manager

A powerful Minecraft Forge 1.16.5 admin tool for coordinate-based loot spawning — DayZ/Tarkov style. Define points in the world, bind them to loot templates, and let the scheduler drop configurable items on configurable timers. Everything is driven from an in-game GUI; no commands required for day-to-day work.

Version: 0.0.9 · Minecraft: 1.16.5 · Forge: 36.2.42 · Java: 8

Highlights

• Coordinate-based spawning — points are world locations, not blocks
• 5 spawn modes — GROUND, RADIUS, ONLY_IF_EMPTY, REPLACE_OLD, ADDITIVE
• Two item-selection modes — chance (0–100% per item) or weighted pool
• Per-point custom loot — override a template's items on a single point
• Fast point creation — Wand (right-click) and Region Brush (bulk patterns)
• Interactive Map — see all spawn points on a zoomable coordinate grid; drag to reposition; filter by template
• Schedule windows — points active only during set hours (e.g. 22:00–06:00)
• Template priority — tiebreak when points are due at the same tick
• Live monitoring — event feed, per-point statistics, health check
• Safety — 10-level undo, one-click backup restore, admin log, permission delegation, confirmation dialogs for destructive ops
• Multi-admin awareness — other admins receive toast notifications when data changes
• Visual loot grid — toggle between list and icon-grid view in the template editor; hover for stats
• Per-template export — one click exports a template to exports/template_NAME.json without touching its group
• Scales — chunked sync (≤10 points/packet) supports tens of thousands of points
• 9 languages with hover tooltips on every control

Getting Started

1. Drop the JAR into your server's mods folder (server-side; clients also need it).
2. Join as an operator (OP level 2) — you get access automatically.
3. Press L (rebindable in Options → Controls) or run /lootmanager menu to open the GUI.

The basic flow

Group  →  Template  →  Items        (what spawns)
                    ↘  Spawn Point   (where it spawns)

1. Create a group (e.g. "Military Loot") — organizes templates.
2. Create a template inside it with a respawn timer.
3. Add items — type an ID, click From hand to grab your held item, or pick from live suggestions.
4. Create points — stand in the world and click "Create at Position", or use the Wand.
5. Bind points to the template. They start spawning on the timer.

In-Game Tools

GUI Map

• Main Menu — group list, search, stats badges, Tools button
• Group Detail — templates in a group, mass timer, duplicate [Copy], rename [R], export
• Template Detail — three sections: ⚡ Spawn Behavior · 🎲 Item Selection · 📦 Loot Pool
• Spawn Point List — card layout: status dot, name, badges, action icons; status filter, sort, search, dimension filter
• Map — top-down coordinate grid of all points; zoom with scroll wheel; pan by drag; click a point to open it; drag a point to move it; filter by template via legend
• Tools — Wand/Brush, Undo, Shift Points, Find-by-Item, Import, Live Events, Health Check, Backup Restore
• Add Item — live icon preview, validity border, From-hand button, suggestions
• Simulator — run N spawns, see item drop % with bars
• Particle Settings — type + visibility radius per template
• Confirm Dialog — modal overlay for all destructive operations (delete group/template/point, restore backup)

Spawn Modes

Item Selection

• Chance mode — each item rolled independently (0–100%). Realistic loot tables where items drop together.
• Weighted mode — pick maxWeightedPicks items from a weighted pool. Higher weight = more likely.

Per-point custom loot uses the point's own item list but inherits the bound template's mode and pick count.

Commands (/lootmanager or /lm)

/lm menu                                  Open the GUI
/lm reload                                Reload data from disk
/lm group create <name>
/lm template create <group> <name> <secs>
/lm template additem <template> <item> <min> <max> <chance>
/lm point create <name>                   At your position
/lm point bind <point> <template>
/lm point clear <name>
/lm point list
/lm timer set <template> <seconds>
/lm timer setall <group> <seconds>
/lm show all  |  /lm hide                  Particle visualization
/lm spawn test <point>
/lm perm grant <player> <0-3>             NONE / VIEW / EDIT / ADMIN
/lm perm revoke <player>
/lm perm list

Permissions

OP level 2+ is implicitly ADMIN. Delegate to non-OP moderators via /lm perm grant.

Data & Storage

config/lootmanager/
├── config.json          Tunables (region cap, packet size, save interval…)
├── groups.json          Group definitions
├── templates.json       Templates with items and settings
├── points.json          Points, bindings, custom loot, stats
├── permissions.json     Delegated permission levels
├── logs/                adminlog_YYYY-MM-DD.txt
├── backups/             Timestamped snapshots (20 kept)
├── exports/             Exported groups
└── imports/             Drop JSON files here for GUI import

config.json tunables (created with defaults on first run): maxRegionPoints (1000) · pointsPerPacket (10) · pointsFlushIntervalMs (30000) · scheduleSkipRetryMs (60000) · defaultParticleRadius (48). Edit and /lm reload — or restart — to apply.

• Atomic writes (.tmp → rename) prevent corruption.
• Point saves are debounced (~30 s) so high spawn rates don't thrash the disk; a full save runs on every admin action and on server stop.

Languages

🇬🇧 English · 🇺🇦 Ukrainian · 🇩🇪 German · 🇫🇷 French · 🇪🇸 Spanish · 🇧🇷 Portuguese (BR) · 🇨🇳 Chinese · 🇯🇵 Japanese · 🇵🇱 Polish

Hover any button or field for a translated explanation. To add a language, copy en_us.json and translate the values.

Building

Requires JDK 8 (Forge 1.16.5 does not build on newer JDKs).

$env:JAVA_HOME = "C:\Program Files\Java\jdk1.8.0_481"
.\gradlew build
# Output: build/libs/lootspawnmanager-0.0.9.jar

Performance & Scale

See CHANGELOG.md for version history and the roadmap below for planned work.

Roadmap (post-0.0.8)

• Save fully async
• DataManager split into focused services; unit test coverage
• Visual chest-grid loot editor
• Cross-dimension template binding
• Vanilla datapack loot-table import

License

Provided as-is for Minecraft server administrators.