CobbleHunts

CobbleHunts A Minecraft Fabric mod that adds a hunting system to Cobblemon. It includes global and solo Pokémon hunting missions with customizable options, rewards, and an easy-to-use GUI.

Dependencies

• Kotlin
• Fabric API
• Cobblemon Mod
• E-Utils

Features

Hunt System

• Global Hunts: Participate in server-wide hunts with up to 7 concurrent active hunts, each with a shared time limit and cooldown.
• Solo Hunts: Take on personal missions across four difficulty tiers (Easy, Normal, Medium, Hard), each with unique Pokémon requirements and rewards.
• Time Limits & Cooldowns: Configurable timers for hunt duration and cooldowns ensure balanced gameplay.
• Hunt Previews: Preview upcoming solo hunt targets before activation.

Pokémon Hunt Customization

• Species Selection: Hunt specific Pokémon species tailored to each difficulty tier.
• Form & Aspect Requirements: Target Pokémon with specific forms (e.g., Alolan) or aspects (e.g., shiny).
• Gender Specification: Normal+ difficulties may require specific genders (Male, Female, or Any).
• Nature Requirements: Medium+ difficulties can demand specific natures (e.g., Adamant, Timid).
• IV Thresholds: Hard difficulty hunts may require Pokémon with high IVs in specific stats (e.g., 2+ stats above 20).

Reward System

• Weighted Loot Pools: Earn rewards from customizable loot tables with percentage-based chances.
• Item Rewards: Receive items like enchanted gear or resources upon hunt completion.
• Command Rewards: Trigger server commands (e.g., currency deposits) with configurable display items.
• Leaderboard Points: Gain points for completing hunts, tracked on a server-wide leaderboard.

User Interface

• Comprehensive GUI: Access global hunts, solo missions, and leaderboards through an intuitive graphical interface.
• Dynamic Updates: Real-time GUI refreshes show hunt progress, timers, and cooldowns.
• Turn-In System: Submit caught Pokémon via a dedicated GUI with validation checks.
• Editor GUI: Admins can tweak hunt settings, Pokémon pools, and loot tables in-game.

Administration Tools

• Command Suite: Manage hunts with commands like /cobblehunts hunts, /cobblehunts reload, and cooldown adjustments.
• Permission System: Restrict hunt access by difficulty tier with configurable permission nodes.
• Hunt Editor: Fine-tune Pokémon chances, requirements, and timers via an in-game editor.
• Revert Turn-Ins: Admins can undo hunt completions and return Pokémon to players.

Performance & Safety

• Thread-Safe Design: Uses concurrent collections for smooth server performance.
• Cooldown Management: Prevents hunt spamming with per-player and global cooldowns.
• Debug Mode: Toggle detailed logging for troubleshooting.

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.