In English

Daily Mining Objective

A Forge 1.20.1 mod that adds daily mining and farming challenges with tiered rewards, enhancement multipliers, and a real-time 6 AM reset.

Dependency : resourceful lib

Free usage in modpack.

Overview

Daily Mining Objective turns your Minecraft sessions into a daily progression loop.
Complete mining and farming objectives, climb reward tiers, and unlock powerful multipliers through hardcore enhancement challenges.

Features

• Daily mining challenge progression
• Daily farming challenge progression
• Tier-based rewards with random loot pools
• Special daily challenge tabs for mining and farming
• Enhancement challenges with multipliers: x2, x5, x10, x15, x30
• Persistent player data and client/server sync
• Clean in-game UI with dedicated tabs for each system
• Real-time daily reset at 06:00 local time

How It Works

1. Mine blocks and harvest crops to progress through daily tiers.
2. Claim rewards as you complete objectives.
3. Complete special daily challenges for bonus gains.
4. Clear enhancement challenges to unlock stronger multipliers.
5. Come back the next day for a fresh challenge rotation.

Why Use This Mod

• Adds clear short-term goals to survival gameplay
• Makes routine mining/farming more rewarding
• Introduces RPG-like progression without breaking vanilla feel
• Encourages daily play sessions with meaningful resets

Compatibility

• Minecraft: 1.20.1
• Loader: Forge

Quick Summary

Daily Mining Objective is a daily progression mod focused on mining, farming, challenge completion, and multiplier-based power growth.

EN FRANCAIS

Daily Mining Objective

Un mod Forge 1.20.1 qui ajoute des défis quotidiens de minage et d’agriculture, des récompenses par paliers, des multiplicateurs d’amélioration, et un reset réel à 06:00.

Dépendence : resourceful lib

Libre d'utilisation dans les modpacks.

Présentation

Daily Mining Objective transforme tes sessions Minecraft en boucle de progression quotidienne.
Complète des objectifs de minage et d’agriculture, monte dans les paliers de récompenses, et débloque de puissants multiplicateurs via des défis d’amélioration hardcore.

Fonctionnalités

• Progression quotidienne en minage
• Progression quotidienne en agriculture
• Récompenses par paliers avec pools d’objets aléatoires
• Onglets dédiés pour les défis miniers et agricoles
• Défis d’amélioration avec multiplicateurs : x2, x5, x10, x15, x30
• Sauvegarde des données joueur et synchronisation client/serveur
• Interface en jeu claire avec onglets dédiés
• Reset quotidien réel à 06:00 (heure locale)

Comment ça fonctionne

1. Mine des blocs et récolte des cultures pour progresser dans les paliers quotidiens.
2. Récupère tes récompenses en validant les objectifs.
3. Termine les défis spéciaux journaliers pour gagner des bonus.
4. Réussis les défis d’amélioration pour augmenter ton multiplicateur.
5. Reviens le lendemain pour une nouvelle rotation de défis.

Pourquoi installer ce mod

• Ajoute des objectifs clairs à chaque session de jeu
• Rend le minage et le farm plus motivants
• Apporte une progression type RPG sans casser l’esprit vanilla
• Encourage un rythme de jeu quotidien avec des resets utiles

Compatibilité

• Minecraft : 1.20.1
• Loader : Forge

Résumé rapide

Daily Mining Objective est un mod de progression quotidienne centré sur le minage, l’agriculture, les défis et la montée en puissance via multiplicateurs.

MODPACKS CREATOR

Mining Rewards Mod - Configuration Guide

Vue d'ensemble

Ce guide explique comment configurer le mod Mining Rewards pour votre modpack. Toutes les récompenses, paliers et comportements du mod sont contrôlables via le fichier de configuration JSON.

Fichier de Configuration

Localisation : config/miningrewards-config.json

Le fichier de configuration contient trois sections principales :

• settings : Paramètres généraux du mod
• mining : Configuration des récompenses minières
• farming : Configuration des récompenses agricoles

Section Settings (Paramètres Généraux)

Structure

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

Paramètres

resetType (string)

Définit le type de reset quotidien pour les récompenses.

Valeurs possibles :

• "REAL_TIME" → Reset à une heure fixe de la journée réelle (défaut)
• "MINECRAFT_DAY" → Reset basé sur le jour Minecraft (24000 ticks ≈ 20 minutes réelles)

Exemples :

Reset à 6h du matin (heure réelle) :

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

Reset à minuit (heure réelle) :

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

Reset par jour Minecraft :

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

Note : En mode MINECRAFT_DAY, le paramètre realTimeResetHour n'a aucun effet mais doit rester présent.

realTimeResetHour (int)

L'heure du reset en mode REAL_TIME.

Valeurs : 0 à 23 (format 24h)

• 0 = Minuit
• 6 = 6h du matin (défaut)
• 12 = Midi
• 18 = 6h du soir

Section Mining (Récompenses Minières)

Structure

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

Sous-section tiers (Paliers)

Tableau d'entiers définissant les seuils de blocs minés pour débloquer les récompenses.

Exemple :

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

• À 100 blocs minés → Déblocage de la première récompense
• À 200 blocs minés → Déblocage de la deuxième récompense
• À 1000 blocs minés → Déblocage de la cinquième récompense
• Etc.

Sous-section rewards (Récompenses)

Objet contenant les détails des récompenses pour chaque palier.

Structure d'une récompense :

"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
                }
            ]
        }
    ]
}

Champs d'une récompense

Pools d'objets

Un pool est un groupe d'options parmi lequel le mod en sélectionne UNE au hasard.

Chaque récompense peut avoir plusieurs pools. Pour chaque pool, une seule option est choisie aléatoirement.

Exemple avec 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}
        ]
    }
]

Résultat probable :

• Pool 1 → Choix aléatoire : Coal (8-18) OU Copper Ingot (6-14)
• Pool 2 → Choix aléatoire : Redstone (8-22) OU Lapis Lazuli (7-18)

Le joueur reçoit donc 1 objet du Pool 1 + 1 objet du Pool 2.

Options d'objets

La quantité réelle est choisie aléatoirement entre minCount et maxCount (inclus).

Section Farming (Récompenses Agricoles)

La structure de la section farming est identique à celle de mining.

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

IDs d'Objets Minecraft Courants

Cas d'Usage / Exemples

Configuration 1 : Hardcore (Récompenses Rares)

{
    "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 (Récompenses Généreuses)

{
    "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 : Équilibré avec 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}]}
                ]
            }
        }
    }
}

4. Variété dans les Pools

Utilisez plusieurs pools pour offrir de la variété sans rendre trop OP :

"pools": [
    {"options": [/* Option courante 1 */]},
    {"options": [/* Option courante 2 */]},
    {"options": [/* Option rare */]}
]

Bon modpack !

In english :

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

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

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

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}]}
                ]
            }
        }
    }
}

4. Pool Variety

Use multiple pools to offer variety without overpowering:

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

Enjoy your modpack!

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

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

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

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!