Rewards Configuration

💎 Rewards Configuration

The r3ct_collector_rewards.json file is where you balance the mod's economy. You can adjust the Experience Points (XP) players get for submitting items, set up exciting Milestone Loot Boxes, and specify rewards for reaching 100% completion in a category.

File Location: config/r3ct_collector/r3ct_collector_rewards.json

---

📝 The JSON Structure

{
  "version": 2,
  "xpCommon": 10,
  "xpUncommon": 50,
  "xpRare": 100,
  "xpEpic": 500,
  "milestoneInterval": 100,
  "milestoneRewards": [
    { "item": "minecraft:diamond", "min_amount": 1, "max_amount": 3, "weight": 50, "color": "&b" },
    { "item": "minecraft:emerald", "min_amount": 5, "max_amount": 10, "weight": 100, "color": "&a" }
  ],
  "categoryRewards": {
    "minecraft:building_blocks": "minecraft:netherite_ingot",
    "minecraft:combat": "minecraft:enchanted_golden_apple",
    "modded_generic": "minecraft:diamond_block"
  }
}

---

🔍 Parameter Breakdown

🌟 XP Rarity System

When a player submits an item, the mod checks the item's inherent Vanilla Rarity (the color of its name) and grants XP based on these values:

• xpCommon (Integer): XP for standard items (White name). Default: 10.
• xpUncommon (Integer): XP for uncommon items (Yellow name). Default: 50.
• xpRare (Integer): XP for rare items (Aqua name). Default: 100.
• xpEpic (Integer): XP for epic items (Light Purple name). Default: 500.

🎁 Milestone Rewards

These are random loot drops given to players when they collect a certain amount of items.

• milestoneInterval (Integer): How often the reward triggers. If set to 100, the player gets a loot box at 100 items, 200 items, 300 items, etc. Set to 0 to disable this feature.
• milestoneRewards (Array): The loot pool for milestones.
  • item: Registry name of the reward item.
  • min_amount / max_amount: The random quantity range given.
  • weight: The drop chance. Higher weight = higher chance to be selected from the pool.
  • color (String, Optional): The visual color code for this reward in the in-game Info tab. Uses standard Minecraft formatting with & (e.g., &a for Green, &b for Aqua, &d for Light Purple). If omitted or invalid, it safely defaults to Blue.

🏆 Category Completion Rewards

These rewards are given when a player reaches 100% completion on a specific page/category.

• categoryRewards (Dictionary / Map): Links a Category ID to a Reward Item ID.
  • Left side: The Creative Tab ID (e.g., "minecraft:tools_and_utilities").
  • Right side: The item given as a reward (e.g., "minecraft:totem_of_undying").
• modded_generic: This is a fallback key! If a player completes a category from another mod that you didn't explicitly specify in this list, they will receive the item defined here.