Configuration

Configuration

CobbleHunts's configuration is split into three main files, located in config/cobblehunts/. This allows for detailed customization of the mod's mechanics.

After editing any of these files, use /hunts reload to apply the changes without a server restart.

1. config.jsonc - Main Settings

This file controls the core mechanics, timers, and behavior of the mod.

Setting	Type	Description
debugEnabled	Boolean	Toggles detailed logging in the console for troubleshooting.
globalHuntsEnabled	Boolean	Enables or disables the server-wide Global Hunts.
soloHuntsEnabled	Boolean	Enables or disables the per-player Solo Hunts.
activeGlobalHuntsAtOnce	Integer	The number of Global Hunts that can be active at the same time.
globalTimeLimit	Integer	Duration of a Global Hunt in seconds.
globalCooldown	Integer	Cooldown in seconds after a Global Hunt ends before a new one starts.
solo[Difficulty]TimeLimit	Integer	Duration in seconds for each solo difficulty tier (e.g., soloEasyTimeLimit).
solo[Difficulty]Cooldown	Integer	Cooldown in seconds for each solo difficulty tier (e.g., soloEasyCooldown).
autoAcceptSoloHunts	Boolean	If true, players will automatically receive a new solo hunt when their cooldown ends.
autoTurnInOnCapture	Boolean	If true, a hunt will automatically complete the moment a matching Pokémon is captured.
takeMonOnTurnIn	Boolean	If true, the Pokémon is taken from the player's party upon hunt completion.
rewardMode	String	Determines reward logic. "weight" gives one random reward, "percentage" gives every reward that passes its chance check.
permissions	Object	Configure the default permission levels for commands.

2. pokemon_pools.jsonc - Pokémon Pools

This file defines which Pokémon can be assigned for hunts. Each hunt type and difficulty has its own list.

Structure of a Pokémon Entry:

{
  "species": "pikachu",
  "form": "Normal",
  "aspects": [],
  "chance": 1.0,
  "gender": "female",
  "nature": "Timid",
  "ivRange": "2"
}

• species: The Pokémon species ID (e.g., "rattata").

• form: (Optional) The specific form, if applicable.

• aspects: (Optional) A list of aspects, like "shiny".

• chance: The weighted chance for this Pokémon to be selected from the pool.

• gender: (Optional) Can be "male", "female", or "random". Required for Normal tier and up.

• nature: (Optional) A specific nature required. Required for Medium and Hard tiers.

• ivRange: (Optional) The number of perfect (31) IVs required. Required for Hard tier.

3. loot_pools.jsonc - Reward Pools

This file defines the rewards given for completing hunts.

There are two types of rewards: command and item.

Command Reward Example:

{
  "type": "command",
  "command": "eco give %player% 100",
  "chance": 1.0,
  "serializableItemStack": {
    "itemStackString": "{\"id\":\"minecraft:paper\",\"count\":1,\"components\":{\"minecraft:custom_name\":\"\\\"§aMoney Reward: $100\\\"\"}}"
  }
}

• type: Must be "command".

• command: The command to execute. Use %player% as a placeholder for the player's name.

• chance: The weighted chance or percentage chance for this reward to be given.

• serializableItemStack: An item to display in the rewards GUI. This is for display only.

Item Reward Example:

{
  "type": "item",
  "serializableItemStack": {
    "itemStackString": "{\"id\":\"minecraft:diamond\",\"count\":5}"
  },
  "chance": 0.5
}

• type: Must be "item".

• serializableItemStack: The actual item and NBT data to be given to the player.

• chance: The weighted/percentage chance for this reward.