Loot Piles
NeoForge mod for Minecraft 1.21.1 that adds tiered scrap pile loot blocks with shared cooldowns and a performance-focused server architecture.
Features
- Five scrap pile tiers: Common, Uncommon, Rare, Epic, Legendary
- Right-click with an empty hand to search a pile and spawn loot
- Shared cooldown per block position (not per player)
- Central
SavedData cooldown manager — no ticking block entities
- Configurable cooldown durations via
config/lootpiles-server.toml
- Admin commands for spawning, resetting, and inspecting piles
- Blockbench block model with a 64×64 base texture and tier tinting (
tintindex: 0)
- Flattened depleted model when a pile is on cooldown, keeping the original tier color
- Tier-colored item names in inventory and JEI (
CUSTOM_NAME data components)
metal_scrap loot item- Optional JADE tooltips and JEI info pages (included in dev runs only)
Requirements
- Minecraft 1.21.1
- NeoForge 21.1.64+
- Java 21
Development
./gradlew build
./gradlew runClient
./gradlew runServer
- Client uses
run-client/ (singleplayer saves)
- Server uses
run-server/ (dedicated world + console)
- Dev username is always
Dev in NeoForge userdev
Test server OP setup
- Accept the EULA in
run-server/eula.txt (eula=true) on first launch
- Start the server:
.\gradlew.bat runServer
- Player
Dev is granted OP automatically on first run (dev/server/ops.json is copied)
- To grant OP manually from the server console:
op Dev
- Connect from the client: Multiplayer →
localhost (with online-mode=false)
Fixing invalidplayerdata on the client
This happens when a world under run/saves/ is corrupted (stats/advancements exist but playerdata/ is missing).
Fix: delete broken worlds and create a new one:
Remove-Item -Recurse -Force run\saves\Dev, run\saves\"New World"
# or delete everything:
Remove-Item -Recurse -Force run\saves\*
With the current Gradle setup, saves live under run-client/saves/ after running runClient.
JADE and JEI are loaded via localRuntime for local testing only.
Commands (OP level 2)
| Command |
Description |
/scrappile spawn <tier> [x y z] |
Place a scrap pile |
/scrappile reset all |
Clear all cooldowns in the current dimension |
/scrappile reset <x> <y> <z> |
Reset one pile |
/scrappile status <x> <y> <z> |
Show tier and cooldown status |
Alias: /lootpiles
Configuration
Server config file: config/lootpiles-server.toml
Default cooldowns (ticks):
| Tier |
Ticks |
Time |
| Common |
12000 |
10 min |
| Uncommon |
24000 |
20 min |
| Rare |
36000 |
30 min |
| Epic |
60000 |
50 min |
| Legendary |
120000 |
100 min |
Visual design
- Active pile: full Blockbench model (
scrap_pile.json) using lootpile_base.png (64×64 atlas)
- Depleted pile: flattened model (
scrap_pile_empty.json) switched via blockstate when depleted=true
- Tier colors: applied client-side through block tint index and item display names
| Tier |
Block tint |
Item name style |
| Common |
#909090 |
Gray |
| Uncommon |
#1EFF00 |
Green |
| Rare |
#0070DD |
Blue, bold |
| Epic |
#A335EE |
Purple, bold |
| Legendary |
#FF8000 |
Orange, bold, underlined |
Publishing (CurseForge)
Repository secrets
| Secret |
Description |
CURSEFORGE_TOKEN |
CurseForge API token |
CURSEFORGE_PROJECT_ID |
Numeric CurseForge project ID |
Release by tag
git tag v1.0.0
git push origin v1.0.0
The Publish Mod to CurseForge workflow builds the jar, uploads to CurseForge, and generates a GitHub release changelog when no per-version file exists.
Manual release
Run the Publish Mod to CurseForge workflow from the Actions tab and set the mod version input (e.g. 1.0.0).
Changelogs
Per-version changelogs live in docs/changelogs/<version>.md (for example docs/changelogs/1.0.0.md). When that file exists, it is uploaded to CurseForge as the release notes.
Version type is inferred automatically:
*-alpha → alpha*-beta → beta- otherwise → release
License
MIT — see LICENSE.
