Reward Boxes by Karl Karlmann

Reward Box Core – Technical Documentation

reward_box is a data-driven chest framework for Minecraft 1.20.1 (Forge). DataPacks control chest contents, textures, block-break drops, and player ownership locks.

1. Overview & Architecture

• Client/Server Separation: Server processes chest logic and loot generation. Client processes chest textures and 3D item rendering.
• Lazy Loot Generation: Loot generates only when a player opens the chest for the first time.

2. JSON Configuration

Store chest definitions in the following DataPack path:
data/<namespace>/reward_boxes/<box_name>.json

{
  "box_id": "stones:resonance_box",
  "texture": "stones:textures/entity/chest/resonance_chest.png",
  "lock_duration_seconds": 300,
  "break_drop_item": "minecraft:lapis_lazuli",
  "break_drop_count": 1,
  "guaranteed_items": [
    {
      "item": "minecraft:diamond",
      "count": 2
    }
  ],
  "vanilla_loot_pools": [
    {
      "loot_table": "minecraft:chests/simple_dungeon",
      "rolls": 3
    }
  ]
}

Parameter Specification

###3. Mechanics & Permission System
-Player Lock: The BlockEntity saves player UUID and name on block placement. Other players receive an action bar message with remaining lock time.

-Admin Bypass: Players in Creative mode or with permission level 2+ can open locked chests at any time.

-Item NBT Data: Chest items read properties from NBT tags BoxId (String) and RewardTier (Integer).

-Creative Tab & JEI/EMI: The Creative Tab dynamically lists all loaded JSON configurations with example tiers.