Cobblemon Grass Spawn

---

📖 Description

Experience classic Pokémon encounters in Minecraft! Walk through grass to trigger wild Pokémon battles, with spawn rates based on your biome and time of day (night/day cycle). Includes Lure and Repel items to control your adventure.

---

✨ Features

• 🌱 Random Grass Encounters: Walk through grass to trigger wild Pokémon encounters automatically
• 🎯 Smart Spawn System: Pokémon levels are based on your party's average level (±2 levels)
• ✨ Shiny Pokémon: Configurable shiny chance that improves with Lure active
• 🎨 Aspect Support: Random chance for Pokémon to spawn with special aspects (forms)
• 🧪 Repel Items: Prevent wild encounters for a limited time
• 🍀 Lure Items: Increase spawn rates of rarer Pokémon and improve shiny chances
• ⚙️ Fully Configurable: Customize all aspects of the encounter system through YAML config
• 🔄 Dynamic Rarity System: Weighted spawn system supporting Common, Uncommon, Rare, and Ultra-Rare buckets
• ⚔️ Automatic Battle Initiation: Seamless transition to Cobblemon battles

---

🧪 Craftable Items

Repel Items

Repel items prevent wild Pokémon encounters for a limited time. Perfect for when you need to travel through grass areas without battles!

🔸 Repel (Normal)

Prevents wild encounters for 6 minutes.

---

🔸 Super Repel

Prevents wild encounters for 12 minutes.

---

🔸 Max Repel

Prevents wild encounters for 20 minutes.

---

Lure Items

Lure items increase the spawn rates of rarer Pokémon and improve your chances of finding shiny Pokémon!

🔸 Lure (Normal)

Increases rare Pokémon spawns and improves shiny chance. Duration: 6 minutes.

---

🔸 Super Lure

Increases rare Pokémon spawns more significantly and improves shiny chance. Duration: 12 minutes.

---

🔸 Max Lure

Maximum effectiveness for rare Pokémon spawns and improved shiny chance. Duration: 20 minutes.

---

⚙️ Configuration

The mod creates a configuration file at:

config/cobblemongrassspawn/default.yml

Default Configuration

# Encounter settings
encounterChance: 0.08
shinyChance: 512
shinyChanceWithLure: 128
aspectChance: 50
cooldown: 80

# Rarity bucket weights
bucketWeights:
  ultra-rare: 2.0
  uncommon: 40.0
  common: 100.0
  rare: 10.0

# Lure durations (in ticks)
normalLureDuration: 7200    # 6 minutes
superLureDuration: 14400    # 12 minutes
maxLureDuration: 24000      # 20 minutes

# Repel durations (in ticks)
normalRepelDuration: 7200   # 6 minutes
superRepelDuration: 14400   # 12 minutes
maxRepelDuration: 24000     # 20 minutes

Configuration Variables

Variable	Type	Default	Description
encounterChance	Double	0.08	Probability of triggering an encounter when walking through grass (0.08 = 8%). Higher = more frequent encounters
shinyChance	Integer	512	Base odds of encountering a shiny Pokémon (1 in X). Lower = more common shinies
shinyChanceWithLure	Integer	128	Shiny odds when Lure effect is active (1 in X). Lower = more common shinies
aspectChance	Integer	50	Chance for a Pokémon to spawn with a special aspect/form (1 in X). Lower = more aspects
cooldown	Integer	80	Ticks between encounters (20 ticks = 1 second). Prevents encounter spam
bucketWeights	Object	-	Spawn rate multipliers for each rarity tier
bucketWeights.common	Double	100.0	Weight multiplier for common Pokémon spawns
bucketWeights.uncommon	Double	40.0	Weight multiplier for uncommon Pokémon spawns
bucketWeights.rare	Double	10.0	Weight multiplier for rare Pokémon spawns
bucketWeights.ultra-rare	Double	2.0	Weight multiplier for ultra-rare Pokémon spawns
normalLureDuration	Integer	7200	Duration of Normal Lure effect in ticks (7200 = 6 minutes)
superLureDuration	Integer	14400	Duration of Super Lure effect in ticks (14400 = 12 minutes)
maxLureDuration	Integer	24000	Duration of Max Lure effect in ticks (24000 = 20 minutes)
normalRepelDuration	Integer	7200	Duration of Normal Repel effect in ticks (7200 = 6 minutes)
superRepelDuration	Integer	14400	Duration of Super Repel effect in ticks (14400 = 12 minutes)
maxRepelDuration	Integer	24000	Duration of Max Repel effect in ticks (24000 = 20 minutes)

Lure Effect on Rarity

When Lure is active, the following multipliers are applied to bucket weights:

• Uncommon: ×1.6 (60% more common)
• Rare: ×1.4 (40% more common)
• Ultra-Rare: ×1.2 (20% more common)

This means you'll encounter rarer Pokémon more frequently when using Lure items!

---

🎮 How It Works

Encounter System

1. Walking in Grass: When you walk through short grass, tall grass, ferns, or large ferns, the mod checks for an encounter
2. Encounter Check: Every tick, there's a 8% chance (configurable) to trigger an encounter
3. Biome & Time: Pokémon spawns depend on the biome you're in and whether it's day or night
4. Cooldown System: After an encounter, there's a 4-second cooldown (80 ticks) before the next possible encounter
5. Level Calculation: Wild Pokémon levels are based on your party's average level ±2 levels
6. Battle Initiation: A wild Pokémon spawns and a battle is automatically started

Requirements for Encounters

• ✅ Player must be on the ground
• ✅ Player must NOT be in spectator mode
• ✅ Player must NOT be in a vehicle
• ✅ Player must NOT have Repel effect active
• ✅ Player must have at least one usable Pokémon in their party
• ✅ Player must NOT be in an active battle

Repel Effect

When you use a Repel item:

• Wild Pokémon encounters are prevented completely
• Duration depends on the Repel type used
• You can walk through grass safely without battles
• Perfect for traveling or when you're low on health

Lure Effect

When you use a Lure item:

• Shinies become 4× more common (1/512 → 1/128)
• Rare Pokémon spawn more frequently
• Using multiple Lures extends the duration

---

💻 Commands

/grassspawn reload

Reloads the mod configuration from the config file without needing to restart the game.

Required Permission Level: OP level 2 (Admin)

---

Enjoy your classic Pokémon experience in Minecraft! 🎮⚡