Phase 9: safe start island, better quest book, every useful item obtainable

- Button Isle is peaceful: wild Pokémon only fight a player who hit them first
  (tuning/server.json peaceful_zones); its apricorns and coal make Poké Balls
  (4 apricorns + coal or charcoal), and the world report checks it has enough.
- Quest book: no boilerplate; each zone page says what is particular to it, and
  every zone that needs gear or a field move to be safe has its own quest. New
  page on the bigger mods (Cold Sweat, Fight or Flight, Cobblebase, breeding,
  veins, shared loot, maps and info).
- The Mire's poison stops 10 blocks below the surface.
- Player battles never cost a Pokémon (CobbleHardcoreMon config, mixins, and the
  companion mod's own permadeath).
- tools/item_audit.py: every item with a use has a source on the island; new
  sources for the gaps it found (species additions, three recipes).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/balance.md

@@ -26,7 +26,7 @@ Every tunable lives in a config file or in this table. **Placeholder** means gue
 | Guardian respawn | 5 hours of game time after being beaten | Decided (Adrian, 2026-10-29) | `world/zones.json` → `guardian_respawn_hours` | Fixed spots |
 | Guardian strength | strongest Pokémon spawning in the zone, band top + 5 levels, scaled to stand about 8 blocks tall (1.5× to 12× its normal size), uncatchable | Decided (Adrian, 2026-10-30) | `tools/zone_spawns.py` (`GUARDIAN_*`), `world/zones.json` → `guardian.species` | Pinned by hand: Southwold Pinsir, Highland Meadows Mudsdale, Sunscorch Flygon, Frostpeak Abomasnow, Deep Dark Regigigas, Basalt Furnace Moltres (Lv 75; drops 3 Exp. Candy XL + 2 netherite scrap, placeholder) (Adrian, 2026-11-02: guardians fit their zone, a legendary for the Deep Dark) |
 | Guardian drops | Button Isle 10 Poké Balls + 4 Potions; Southwold 6 Great Balls + 4 Exp. Candy S; Westmarch and Jungle Mire Waders + 4 Pecha Berries + 2 Exp. Candy M; Mire and Highlands 3 Icy Rocks + 4 Super Potions; Sunscorch 3 Heat Rocks + 2 Exp. Candy L; Frostpeak and Deep Dark 3 Icy Rocks + 2 Exp. Candy L; Deep Sea Mystic Water + 3 Exp. Candy M | Decided (Adrian, 2026-10-30) | `world/zones.json` → `guardian.drops` | 3 rocks make one full fur or hide set |
-| Mire poison | Poison I for 7 s, renewed every 5 s while in the Mire without Mire Waders | Decided (Adrian, 2026-10-30) | `datapacks/core/data/cobblesurvival/zone_hazards/mire.json` | Vanilla Poison stops at half a heart |
+| Mire poison | Poison I for 7 s, renewed every 5 s while in the Mire without Mire Waders, down to 10 blocks below the surface (Adrian, 2026-11-10: not far underground) | Decided (Adrian, 2026-10-30) | `datapacks/core/data/cobblesurvival/zone_hazards/mire.json` | Vanilla Poison stops at half a heart |
 | Field moves (Cobblemon HMs) | mod defaults: all 39 abilities on, no level minimum, no fullness or friendship cost; Rock Smash breaks up to 32 connected ore blocks with no cooldown | Placeholder | `config/cobblemon_hms.json` (generated by the mod; the pack ships none yet) | Rock Smash mines any ore, whatever pickaxe the player has. HMs' `minLevel` is the player's XP level, not the Pokémon's |
 | Breeding (Cobbreeding) | mod defaults: an egg every 8,000–14,000 ticks per breeding pasture, hatch multiplier 1.0 (about 10 min for 20 egg cycles), Masuda shiny boost ×4, no random eggs from two Dittos, no gate | Placeholder | `config/cobbreeding/main.json` (written by the mod; the pack ships none) | Adrian, 2026-10-31: breeding without a gate |
 | Machine shells | 3×3×3, core in a wall, chamber in the centre; casing: Heat bricks/mud bricks/deepslate bricks; Dynamo copper blocks; Synthesis iron/gold/diamond/netherite blocks; Altar obsidian/crying obsidian/blackstone/polished blackstone bricks; Rebirth amethyst/quartz/calcite; glass allowed at the window spots | Placeholder | `datapacks/core/data/cobblesurvival/machines/*.json`, `tags/block/*_casing.json` | Adrian, 2026-10-31 (Phase 6) |
@@ -93,3 +93,7 @@ Sections to fill as phases land: hazard damage (Phase 3), field-move cooldowns a
 | Sea levels | channels between the islands are Shallows (Lv 5–20), everything beyond 1,500 blocks from the centre is Deep Sea (Lv 30–50) (Adrian, 2026-11-09) | Decided | `world/zones.json` → `deep_sea.rule.beyond` | Run `tools/zone_layout.py`, `zone_spawns.py`, `zone_bosses.py`, `zone_ores.py` after changing it |
 | Starter | only faints: never removed, can't be released or sacrificed, a Revival Charm on it isn't used up (Adrian, 2026-11-09) | Decided | `permadeath/Permadeath.kt`, `mixin/HardcorePartyMixin.java` | Cobblemon's own record of each player's starter |
 | Regional forms | a rare spawn (`homeless`) unless a line or an evolution brings them; Galarian Zapdos, Articuno, Moltres from Sigils, tier 2 (Adrian, 2026-11-09) | Placeholder | `world/zones.json` → `homeless.zones`, `world/summons.json` | Five regional evolutions got an island biome: `data/cobblemon/tags/worldgen/biome/evolution/regional/` |
+| Peaceful start | on Button Isle a wild Pokémon only fights a player who hit it first: no hunting weaker trainers, no anger from failed catches, other attacks cancelled (Adrian, 2026-11-10) | Decided | `tuning/server.json` → `peaceful_zones`, `zone/PeacefulZones.kt` | A fail-safe for a player who lost everything |
+| Poké Ball from the start island | 4 apricorns of any colour + coal or charcoal → 1 Poké Ball; Cobblemon's 4 red apricorns + copper ingot → 4 stays (Adrian, 2026-11-10: the start island must make at least one kind of ball) | Placeholder | `datapacks/core/data/cobblesurvival/recipe/poke_ball_from_coal.json` | Button Isle has about 250 apricorns on its trees and 11,600 coal ore, no copper; `tools/world_report.py` checks for at least 100 and 500 |
+| Battles between players | never cost a Pokémon: one that faints there stays fainted until healed (Adrian, 2026-11-10) | Decided | `defaultconfigs/cobblehardcoremon/server.toml` → `trackPlayerBattles = false`; `permadeath/Permadeath.kt`, `mixin/HardcoreBattlesMixin.java` for worlds made before | |
+| Items given a source (Adrian, 2026-11-10: every item with a use is obtainable) | Shell Helmet from Shelmet (10 %), Malicious Armor from Armarouge (5 %), Tasty Tail from Slowpoke (10 %), Chameleon Molt from Kecleon (15 %), Soul Sprout from Lampent (10 %), the terrain flowers from Comfey and the Oricorio flowers from Cutiefly (5 % each); recipes for the Cherish Ball (pink and red apricorns, gold), Ancient Origin Ball (Master Ball in tumblestone) and Netherite Upgrade template (diamonds, netherite scrap, obsidian) | Placeholder | `datapacks/core/data/cobblesurvival/species_additions/`, `.../recipe/` | `tools/item_audit.py` keeps it so |