Home›Java›Mods›Mining Reward

ModsJava

Mining Reward

by biduleking · on Modrinth

⬇ Download on Modrinth

Open in MC Java Mods Get it on Google Play →

Mining Rewards is a progression-focused NeoForge mod for Minecraft 1.21.1 that gives players structured goals for mining and farming each day.

It adds:

Tier-based rewards for blocks mined and crops harvested. Daily special challenges with extra XP rewards. Daily enhancement challenges that unlock temporary multipliers. A clean in-game UI to track progress, claimed tiers, and current objectives. The mod is fully configurable, so server owners can tune tiers, rewards, reset behavior, and challenge difficulty to fit their gameplay style.

Mining Rewards Mod - Configuration Guide

Overview

This guide explains how to configure the Mining Rewards mod for your modpack. All rewards, tiers, and mod behaviors are controllable via a JSON configuration file.

Configuration File

Location: config/miningrewards-config.json

The configuration file contains three main sections:

settings : General mod parameters
mining : Mining reward configuration
farming : Farming reward configuration

Settings Section (General Parameters)

Structure

"settings": {
    "resetType": "REAL_TIME",
    "realTimeResetHour": 6
}

Parameters

`resetType` (string)

Defines the type of daily reset for rewards.

Possible values:

"REAL_TIME" → Daily reset at a fixed real-world time (default)
"MINECRAFT_DAY" → Reset based on Minecraft day (24000 ticks ≈ 20 real minutes)

Examples:

Reset at 6 AM (real-world time):

"settings": {
    "resetType": "REAL_TIME",
    "realTimeResetHour": 6
}

Reset at midnight (real-world time):

"settings": {
    "resetType": "REAL_TIME",
    "realTimeResetHour": 0
}

Reset by Minecraft day:

"settings": {
    "resetType": "MINECRAFT_DAY",
    "realTimeResetHour": 6
}

Note: In MINECRAFT_DAY mode, the realTimeResetHour parameter has no effect but must remain present for JSON syntax.

`realTimeResetHour` (int)

The reset hour in REAL_TIME mode.

Values: 0 to 23 (24-hour format)

0 = Midnight
6 = 6 AM (default)
12 = Noon
18 = 6 PM

Mining Section (Mining Rewards)

Structure

"mining": {
    "tiers": [100, 200, 300, ...],
    "rewards": {
        "100": { ... },
        "200": { ... },
        ...
    }
}

Subsection `tiers` (Reward Tiers)

Array of integers defining block-mined thresholds to unlock rewards.

Example:

"tiers": [100, 200, 300, 500, 1000, 2000, 5000]

At 100 blocks mined → First reward unlocked
At 200 blocks mined → Second reward unlocked
At 1000 blocks mined → Fifth reward unlocked
Etc.

Subsection `rewards` (Reward Details)

Object containing reward details for each tier.

Structure of a reward:

"100": {
    "xp": 33,
    "pools": [
        {
            "options": [
                {
                    "item": "minecraft:coal",
                    "minCount": 8,
                    "maxCount": 18
                },
                {
                    "item": "minecraft:copper_ingot",
                    "minCount": 6,
                    "maxCount": 14
                }
            ]
        },
        {
            "options": [
                {
                    "item": "minecraft:redstone",
                    "minCount": 8,
                    "maxCount": 22
                }
            ]
        }
    ]
}

Reward Fields

Field	Type	Description
`xp`	int	Experience points granted when tier is unlocked
`pools`	array	Item groups (see details below)

Item Pools

A pool is a group of options from which the mod selects ONE randomly.

Each reward can have multiple pools. For each pool, one option is randomly selected.

Example with 2 pools:

"pools": [
    {
        "options": [
            {"item": "minecraft:coal", "minCount": 8, "maxCount": 18},
            {"item": "minecraft:copper_ingot", "minCount": 6, "maxCount": 14}
        ]
    },
    {
        "options": [
            {"item": "minecraft:redstone", "minCount": 8, "maxCount": 22},
            {"item": "minecraft:lapis_lazuli", "minCount": 7, "maxCount": 18}
        ]
    }
]

Likely result:

Pool 1 → Random choice: Coal (8-18) OR Copper Ingot (6-14)
Pool 2 → Random choice: Redstone (8-22) OR Lapis Lazuli (7-18)

The player receives 1 item from Pool 1 + 1 item from Pool 2.

Item Options

Field	Type	Description
`item`	string	Minecraft registry ID of the item
`minCount`	int	Minimum quantity
`maxCount`	int	Maximum quantity

The actual quantity is randomly chosen between minCount and maxCount (inclusive).

Farming Section (Farming Rewards)

The structure of the farming section is identical to mining.

"farming": {
    "tiers": [25, 50, 100, 200, 500],
    "rewards": {
        "25": {
            "xp": 25,
            "pools": [
                {
                    "options": [
                        {"item": "minecraft:bone_meal", "minCount": 5, "maxCount": 15}
                    ]
                }
            ]
        },
        ...
    }
}

Common Minecraft Item IDs

Item	ID
Coal	`minecraft:coal`
Copper Ore	`minecraft:copper_ore`
Copper Ingot	`minecraft:copper_ingot`
Iron Ingot	`minecraft:iron_ingot`
Gold Ingot	`minecraft:gold_ingot`
Diamond	`minecraft:diamond`
Emerald	`minecraft:emerald`
Redstone	`minecraft:redstone`
Lapis Lazuli	`minecraft:lapis_lazuli`
Obsidian	`minecraft:obsidian`
Ender Pearl	`minecraft:ender_pearl`
Blaze Rod	`minecraft:blaze_rod`
Nether Star	`minecraft:nether_star`
Totem of Undying	`minecraft:totem_of_undying`
Experience Bottle	`minecraft:experience_bottle`
Bone Meal	`minecraft:bone_meal`
Amethyst Shard	`minecraft:amethyst_shard`
Ancient Debris	`minecraft:ancient_debris`
Netherite Scrap	`minecraft:netherite_scrap`

Use Cases / Examples

Configuration 1: Hardcore (Rare Rewards)

{
    "settings": {
        "resetType": "REAL_TIME",
        "realTimeResetHour": 6
    },
    "mining": {
        "tiers": [500, 1000, 2000, 5000],
        "rewards": {
            "500": {
                "xp": 100,
                "pools": [
                    {"options": [{"item": "minecraft:coal", "minCount": 10, "maxCount": 20}]}
                ]
            },
            "1000": {
                "xp": 200,
                "pools": [
                    {"options": [{"item": "minecraft:iron_ingot", "minCount": 5, "maxCount": 10}]}
                ]
            },
            "2000": {
                "xp": 500,
                "pools": [
                    {"options": [{"item": "minecraft:diamond", "minCount": 1, "maxCount": 3}]}
                ]
            },
            "5000": {
                "xp": 1000,
                "pools": [
                    {"options": [{"item": "minecraft:nether_star", "minCount": 1, "maxCount": 1}]}
                ]
            }
        }
    }
}

Configuration 2: Casual (Generous Rewards)

{
    "settings": {
        "resetType": "MINECRAFT_DAY",
        "realTimeResetHour": 0
    },
    "mining": {
        "tiers": [50, 100, 200, 400, 800],
        "rewards": {
            "50": {
                "xp": 25,
                "pools": [
                    {"options": [
                        {"item": "minecraft:coal", "minCount": 15, "maxCount": 40},
                        {"item": "minecraft:copper_ingot", "minCount": 10, "maxCount": 30}
                    ]}
                ]
            },
            "100": {
                "xp": 75,
                "pools": [
                    {"options": [{"item": "minecraft:iron_ingot", "minCount": 15, "maxCount": 50}]},
                    {"options": [{"item": "minecraft:gold_ingot", "minCount": 10, "maxCount": 30}]}
                ]
            },
            "200": {
                "xp": 200,
                "pools": [
                    {"options": [{"item": "minecraft:diamond", "minCount": 5, "maxCount": 15}]},
                    {"options": [{"item": "minecraft:emerald", "minCount": 3, "maxCount": 10}]}
                ]
            }
        }
    }
}

Configuration 3: Balanced with Progression

{
    "settings": {
        "resetType": "REAL_TIME",
        "realTimeResetHour": 8
    },
    "mining": {
        "tiers": [100, 250, 500, 1000, 2000, 4000],
        "rewards": {
            "100": {
                "xp": 40,
                "pools": [
                    {"options": [
                        {"item": "minecraft:coal", "minCount": 8, "maxCount": 18},
                        {"item": "minecraft:copper_ingot", "minCount": 6, "maxCount": 14}
                    ]}
                ]
            },
            "250": {
                "xp": 80,
                "pools": [
                    {"options": [{"item": "minecraft:iron_ingot", "minCount": 10, "maxCount": 25}]},
                    {"options": [{"item": "minecraft:redstone", "minCount": 10, "maxCount": 30}]}
                ]
            },
            "500": {
                "xp": 150,
                "pools": [
                    {"options": [{"item": "minecraft:gold_ingot", "minCount": 8, "maxCount": 20}]},
                    {"options": [{"item": "minecraft:lapis_lazuli", "minCount": 12, "maxCount": 28}]}
                ]
            }
        }
    }
}

Tips for Modpack Creators

1. Balance Rewards

Too generous → Breaks server economy
Too rare → Player frustration
Test in gameplay before release

2. Progression

Increase as tiers increase:

Experience points granted
Item quantities
Item value (coal → diamond → nether star)

3. Reset Type

REAL_TIME : Best for multiplayer servers (synchronized daily reset)
MINECRAFT_DAY : Best for solo experience (reset based on player progress)

4. Pool Variety

Use multiple pools to offer variety without overpowering:

"pools": [
    {"options": [/* Common option 1 */]},
    {"options": [/* Common option 2 */]},
    {"options": [/* Rare option */]}
]

5. Documentation

Add a note to your modpack explaining:

Mod purpose
How rewards work
How to modify config if needed

Troubleshooting

"Config not loaded"

• Verify file is in config/miningrewards-config.json • Check JSON syntax (no missing/extra commas) • Restart the client

Rewards don't change

• Did you save the JSON file? • Did you restart the client? • Is the tier threshold reached?

JSON Error

• Use a JSON validator: https://jsonlint.com/ • Check quotes (must be " not ")

Configuration Checklist

Valid JSON syntax
Tiers in ascending order
Rewards defined for each tier
Valid item IDs
minCount ≤ maxCount
XP consistent with difficulty
resetType correct (REAL_TIME or MINECRAFT_DAY)
File synced in /run/config/

Enjoy your modpack!

Verified by MCModsHub

Ships as miningrewards-neoforge-1.21.1-1.0.2.jar — drop this file into the mods folder
Download size: 101 KB
Download link checked 24 Aug 2026 — working

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.21

Mining Reward

Mining Rewards Mod - Configuration Guide

Overview

Configuration File

Settings Section (General Parameters)

Structure

Parameters

resetType (string)

realTimeResetHour (int)

Mining Section (Mining Rewards)

Structure

Subsection tiers (Reward Tiers)

Subsection rewards (Reward Details)

Reward Fields

Item Pools

Item Options

Farming Section (Farming Rewards)

Common Minecraft Item IDs

Use Cases / Examples

Configuration 1: Hardcore (Rare Rewards)

Configuration 2: Casual (Generous Rewards)

Configuration 3: Balanced with Progression

Tips for Modpack Creators

1. Balance Rewards

2. Progression

3. Reset Type

4. Pool Variety

5. Documentation

Troubleshooting

"Config not loaded"

Rewards don't change

JSON Error

Configuration Checklist

Explore more

`resetType` (string)

`realTimeResetHour` (int)

Subsection `tiers` (Reward Tiers)

Subsection `rewards` (Reward Details)