CobbleHunts

CobbleHunts is a Fabric mod that adds a complete Pokémon hunting system to Cobblemon. Engage your server with server-wide Global Hunts for community collaboration or challenge individual players with tiered Solo Hunts. With deep customization for Pokémon, rewards, and timers, you can create the perfect hunting experience for your community.

Dependencies

• Fabric API
• Fabric Language Kotlin
• Cobblemon
• E-Utils (EverlastingUtils)

Features

• Dual Hunt System: Features both server-wide Global Hunts for community engagement and tiered Solo Hunts (Easy, Normal, Medium, Hard) for individual player progression.
• Deep Customization: Define exactly which Pokémon can appear in hunts, including specific forms, aspects (like shiny), genders, natures, and even required perfect IVs.
• Flexible Rewards: Create unique loot tables for each hunt type. Give players items, run commands (like adding economy money), or both. Use a weighted system for a single random reward or a percentage system to give multiple rewards.
• Intuitive Player GUI: Players can view all active hunts, accept missions, and turn in their catches through a clean and easy-to-use interface.
• Powerful Admin Tools: A full suite of commands lets you reload configs live, manage player cooldowns, and even revert a mistaken turn-in.
• In-Game Editors: Admins can use the /hunts editor GUI to manage the Pokémon and reward pools without ever leaving the game.

Commands

The primary command is /hunts. All permission nodes are fully configurable in the config file.

Configuration Highlights

CobbleHunts uses a multi-file configuration system located in config/cobblehunts/ for maximum organization. After editing, use /hunts reload to apply changes.

config.jsonc - Core Settings

This file governs the fundamental behavior of the hunting system.

pokemon_pools.jsonc - Defining Hunt Targets

This file is where you specify which Pokémon can appear in hunts. You can create distinct pools for Global Hunts and each of the four Solo Hunt tiers.

Each Pokémon entry allows for precise targeting:

• species: The ID of the Pokémon (e.g., "pikachu").
• form: (Optional) Specify a form, like "alolan".
• aspects: (Optional) A list of required aspects, like "shiny".
• chance: A weighted value that determines how likely this Pokémon is to be selected from the pool.
• gender: (Optional) For higher difficulties, you can require "male" or "female".
• nature: (Optional) For higher difficulties, you can require a specific Nature (e.g., "adamant").
• ivRange: (Optional) For the hardest difficulty, specify the number of perfect (31) IVs required (e.g., "2").

loot_pools.jsonc - Crafting Rewards

Define what players receive upon successful hunt completion. Each hunt type and difficulty has its own reward list.

• Reward Types: You can create two kinds of rewards:
  • "command": Executes a server command. Use %player% as a placeholder for the player's name. This is perfect for economy integration.
  • "item": Directly gives the player an item, with full support for NBT data via a serializableItemStack.
• Display Item: For command rewards, you can still define an item stack to be shown in the GUI, so players know what the reward represents.
• chance: A weighted value that dictates the probability of this specific reward being granted from the pool.