LuckyCobblemon

# 🍀 Lucky Cobblemon

  **Break the block, test your luck, and discover a Cobblemon-themed surprise!**

  Lucky Cobblemon is a Fabric mod that adds craftable and naturally generated Lucky Blocks. Every block stores its own
  luck value from **-100 to +100** and triggers a weighted event when broken.

  ## ✨ Features

  - Pokémon encounters across six rarity tiers
  - Shiny encounters and a legendary shiny jackpot
  - Poké Ball and Rare Candy supply bundles
  - Three-Pokémon encounters
  - Lucky Shrines with loot and an epic guardian
  - Harmless unlucky effects
  - Optional integration with Cobblemon Raid Dens
  - Per-block luck values that are preserved when placed
  - Configurable event weights, Pokémon levels and species pools
  - Natural generation in newly generated Overworld chunks

  ## 🎲 Luck System

  Each Lucky Block has an individual luck value ranging from **-100 to +100**.

  Combine a Lucky Block with materials such as iron, gold, emeralds, diamonds, golden apples or a Nether Star to
  increase its luck. Items such as rotten flesh, spider eyes, poisonous potatoes and pufferfish reduce it.

  Positive luck improves the relative chances of rare, epic, mythical and legendary rewards. Negative luck increases the
  chance of unlucky events.

  ## 🌍 Natural Generation

  Lucky Blocks can appear naturally on the Overworld surface in newly generated chunks.

  - One placement attempt every 48 chunks on average
  - Values from -90 to +90 favor results closer to zero
  - 2.5% chance of receiving +100 luck
  - 2.5% chance of receiving -100 luck
  - Existing chunks are not modified

  ## 🧰 Requirements

  - **Minecraft:** 1.21.1
  - **Mod Loader:** Fabric
  - **Fabric Loader:** 0.17.2 or newer
  - **Fabric API:** 0.116.6+1.21.1 or newer
  - **Cobblemon:** 1.7.3 or newer
  - **Java:** 21 or newer

  ### Optional dependency

  - **Cobblemon Raid Dens:** 0.11.7 or newer

  Without Cobblemon Raid Dens, a failed Raid Den result safely falls back to a rare Pokémon encounter.

  ## 📦 Installation

  1. Install Fabric Loader for Minecraft 1.21.1.
  2. Download Fabric API and Cobblemon.
  3. Place the dependencies and Lucky Cobblemon JAR inside the `mods` folder.
  4. Launch the game.

  For multiplayer, install the mod and its required dependencies on both the server and every connecting client.

  ## ⚙️ Configuration

  After the first launch, the following file will be created:

  `config/luckycobblemon.json`

  It allows you to customize:

  - Event weights
  - Minimum and maximum Pokémon levels
  - Species available in each rarity pool

  Invalid configurations are backed up automatically before the default settings are restored.

  ## 🔗 Links

  - [Source Code](https://github.com/Pexe171/LuckyCobblemon)
  - [Issue Tracker](https://github.com/Pexe171/LuckyCobblemon/issues)
  - [Changelog](https://github.com/Pexe171/LuckyCobblemon/blob/main/CHANGELOG.md)

  ---

  Lucky Cobblemon is an independent and unofficial community add-on. It is not affiliated with or endorsed by Mojang
  Studios, The Pokémon Company, Cobblemon, or Cobblemon Raid Dens.