Phase 9: reproducible builds, balance from the server, spark check, play feedback

Build: every tool pinned (JDK, packwiz, Gradle plugins, Python packages), exports
normalised, tools/check_reproducible.py proves two clean builds are byte-identical.

Server-side balance: a server can load config/cobblesurvival/datapack.zip in place of
the jar's data, /reload applies it, tools/server_update.py packages it and refuses
when a client change is needed. JEI drop pages are sent by the server. Code-held
balance numbers moved to tuning/server.json.

Performance: spark in the pack (server only), tools/perf_test.py with fake players
whose chunks really are active, docs/performance.md.

Adrian's feedback: default keys R, U, J, §; drop pages link to Cobblemon Info and show
real chances; bosses only hurt in battles; battle XP halved; channels between the
islands low level; temperature ×3 with insulation doubled; hazards start at once; no
item dots on the map; a wild attack starts a battle; the starter only faints; quest
book on join with a basics page and an HMs page; regional forms obtainable.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
claudeandClaude Opus 5.5 committed 2026-11-09 16:26:30 +01:00
1 parent 0741c84077
commit 4083791944
133 files changed
+8350 -3273

No files matched your search

+222 -7
View File
@@ -83,16 +83,50 @@ chapters:
This island has no zombies, no creepers and no cows: only Pokémon. Their drops are your food, string, leather and much more.
The island is split into zones, each with its own Pokémon, levels, ores and a guardian. You start on Button Isle; the further out you go, the stronger everything gets.
This book suggests what to do next. Nothing in it is locked and it gives no rewards: do things in any order you like.
This book suggests what to do next. Nothing in it is locked and it gives no rewards: do things in any order you like. This first page walks through how the island works; the next one lists every field move your Pokémon can lend you.
tasks:
- checkmark: true
title: Read this
- id: first_partner
title: A Partner
- id: keys
title: Keys Worth Knowing
icon: minecraft:tripwire_hook
after: [welcome]
text: |
§ (left of 1) opens this book. J opens the map.
R sends out the Pokémon selected on the left of your screen, or calls it back. Up and down arrows pick another. N opens its summary.
Over an item in your inventory or JEI, R shows how to get it and U what it's used for.
V shows more detail on what you're looking at. M switches shaders on and off. Everything can be changed in Options > Controls.
tasks:
- checkmark: true
title: Got it
- id: starter
title: Your First Partner
icon: cobblemon:poke_ball
after: [welcome]
text: |
Weaken a wild Pokémon in battle, then throw a Poké Ball at it.
When you first arrive you choose a starter. Look after it: it is the only Pokémon on the island that can never be lost.
When it faints it stays with you, fainted, until you heal it. It can't be released or sacrificed.
Every other Pokémon is gone for good when it faints.
tasks:
- checkmark: true
title: Read this
- id: battling
title: Battling
icon: minecraft:iron_sword
after: [starter]
text: |
Look at a wild Pokémon and press R: your Pokémon goes out and the battle starts.
Wild Pokémon can also come to you. One that attacks you starts a battle instead of hurting you, unless none of your Pokémon can fight: then you take the hit yourself.
Pokémon stronger than your team hunt you; weaker ones keep their distance. In a battle you can run, and you get a few seconds' head start.
tasks:
- cobblemon: defeat
amount: 1
- id: first_partner
title: Your First Catch
icon: cobblemon:poke_ball
after: [battling]
text: |
Weaken a wild Pokémon in battle, then throw a Poké Ball at it. The weaker it is, the easier it is to catch, and a Pokémon far above your team's level is much harder.
tasks:
- cobblemon: catch
amount: 1
@@ -105,6 +139,15 @@ chapters:
tasks:
- item: cobblemon:poke_ball
count: 16
- id: pc_pasture
title: PC and Pastures
icon: cobblemon:pasture
after: [first_partner]
text: |
A PC holds the Pokémon that don't fit in your party. A Pasture Block lets them out to roam around your base.
Pastured Pokémon also work: open the pasture and give them a skill, such as mining or gathering, and they bring in items. What they can find depends on the zone the pasture stands in, and JEI's Pasture Finds pages list it.
tasks:
- item: cobblemon:pasture
- id: full_team
title: A Full Team
icon: cobblemon:great_ball
@@ -119,8 +162,8 @@ chapters:
icon: cobblesurvival:revival_charm
after: [first_partner]
text: |
A Pokémon that faints is gone for good once the battle ends. Revives only help within that battle.
A Pokémon holding a Revival Charm is saved once instead: the charm is used up and the Pokémon is healed. Give one to your most valuable partner.
Apart from your starter, a Pokémon that faints is gone for good once the battle ends. Revives only help within that battle.
A Pokémon holding a Revival Charm is saved once instead: the charm is used up and the Pokémon is healed. Give one to your most valuable partner. Your starter doesn't need one.
tasks:
- item: cobblesurvival:revival_charm
- id: healing
@@ -128,7 +171,7 @@ chapters:
icon: cobblemon:healing_machine
after: [first_partner]
text: |
Sleeping doesn't heal your Pokémon. A Healing Machine does, but it is expensive and recharges slowly; potions and berries help in between.
Sleeping doesn't heal your Pokémon. A Healing Machine does, and it also wakes a fainted starter, but it is expensive and recharges slowly; potions and berries help in between.
tasks:
- item: cobblemon:healing_machine
- id: level_10
@@ -158,6 +201,46 @@ chapters:
tasks:
- cobblemon: evolve
amount: 1
- id: zones
title: Zones and Guardians
icon: minecraft:filled_map
after: [level_10]
text: |
Each zone has its own Pokémon and level range; the book has a page for each. The channels between the islands are gentle, the open sea around them is not.
Most zones have a guardian: a giant Pokémon with a health bar at the top of your screen when you are near. Only a battle can hurt it, and it can lose at most a quarter of its health to one attack. Beat it for its rewards; it comes back hours later.
tasks:
- checkmark: true
title: Read this
- id: hazards
title: Heat, Cold and Poison
icon: minecraft:leather_chestplate
after: [zones]
text: |
Some zones hurt to be in. Sunscorch is hot and Frostpeak is cold: your body temperature climbs or falls quickly there, so wear hide against heat and fur against cold.
The Mangrove Mire poisons you unless you wear Mire Waders. Look these up in JEI with R.
tasks:
- checkmark: true
title: Read this
- id: ores
title: Ore Comes from Veins
icon: minecraft:raw_iron
after: [zones]
text: |
There is no ore in ordinary stone. Each zone has its own nodes and underground veins, which grow back after you mine them. JEI's Ore Veins pages show what grows where.
A Pokémon that knows Rock Smash can mine a whole vein with one punch: see the HMs page of this book.
tasks:
- checkmark: true
title: Read this
- id: machines
title: Pokémon at Work
icon: cobblesurvival:heat_core
after: [zones]
text: |
Machines are small buildings with a Pokémon inside: a Large Furnace, a Generator, a Drop Synthesizer, a Sacrifice Altar and a Rebirth Chamber. Craft a core, use it, and ghost blocks show how to build around it.
JEI lists each core's recipe, and each machine's own page says what it makes.
tasks:
- checkmark: true
title: Read this
- id: beyond
title: Beyond Button Isle
icon: minecraft:compass
@@ -168,6 +251,127 @@ chapters:
- event: zone/southwold
title: Reach Southwold
- id: hms
title: HMs
subtitle: Every field move your Pokémon can lend you
icon: minecraft:iron_pickaxe
quests:
- id: how
title: How HMs Work
icon: minecraft:iron_pickaxe
size: 1.5
text: |
Any Pokémon of yours that has learned one of these moves can use it for you outside battle. There is nothing to craft or learn yourself.
Send the Pokémon out, sneak and right-click it, and pick Field moves. It lists what that Pokémon can do; hover over one to read about it. The top left of your screen shows what is active.
Partner HMs go to your empty hand: one per Pokémon, fired with a click.
Auras and weather work on you while the Pokémon is out and within 24 blocks.
Mount toggles help the Pokémon itself while you ride it.
Working makes a Pokémon hungry. Right-click it with any berry to feed it. If it works on an empty stomach it loses friendship, and at none it refuses.
tasks:
- checkmark: true
title: Read this
- id: gathering
title: Gathering and Building
icon: minecraft:iron_axe
after: [how]
text: |
Cut: fells a whole tree, or clears the plants in front of you.
Rock Smash: breaks a stone block, or mines up to 32 connected ore in one punch, and veins still grow back.
Dig: takes dirt, sand, gravel, clay and snow in one hit.
Leafage: grows nearby crops, saplings and berry trees at once, and covers bare ground in flowers. Sneak to till soil instead.
Stockpile: drinks water or lava, then spits it back out where you aim.
Strength: pushes the block you aim at one block, in any direction, along with anything inside it.
Tail Whip: sweeps suspicious sand or gravel clean in one go.
tasks:
- checkmark: true
title: Read this
- id: handy
title: Handy Tricks
icon: minecraft:ender_pearl
after: [how]
text: |
Teleport: blinks you up to 30 blocks to where you look (30 seconds to recharge).
Charge: turns a block into a lasting redstone power source. Use it again to switch it off.
Camouflage: makes you look like the creature you aim at for 15 minutes.
Celebrate: fireworks over your head, for no reason at all.
tasks:
- checkmark: true
title: Read this
- id: changing
title: Changing a Pokémon
icon: minecraft:nether_star
after: [how]
text: |
Growth: makes the Pokémon you aim at one size bigger for good; aim elsewhere and you grow for 5 minutes.
Minimize: the same, but smaller.
Outrage: turns an XL Pokémon of yours into an Alpha.
Calm Mind: settles an Alpha of yours back into an ordinary Pokémon.
Decorate: one roll at making the Pokémon you aim at shiny for good, once an hour.
tasks:
- checkmark: true
title: Read this
- id: exploring
title: Exploring Auras
icon: minecraft:spyglass
after: [how]
text: |
Flash: lets you see in the dark. Needs the Dripstone gate.
Dive: breathe, walk and mine at full speed underwater. Needs the Mire gate.
Rock Climb: walls work like ladders, on foot or riding. Needs the Highlands gate.
Magnet Rise: slow flight for building. Double-tap jump to lift off. Needs the Sunscorch gate.
Lava Plume: the same as Dive, for lava, with fire immunity. Needs the Deep Dark gate.
Jump: jump higher and land safely. Comes from Splash.
Shadow Sneak: walk silently, unseen by pressure plates and sculk, at a reduced speed.
Snowscape: snow under your feet, and still water freezes as you walk across it.
A gate means the Pokémon must have reached the top level of that zone, or hold one of its materials: its ore, evolution stone or guardian's drop.
tasks:
- checkmark: true
title: Read this
- id: helping
title: Helping Auras
icon: minecraft:honey_bottle
after: [how]
text: |
Absorb: loose items drift toward you.
Lucky Chant: more from what you break and fish. Needs the Frostpeak gate.
Sweet Scent: draws a wild Pokémon of the area about once a minute, like a Poké Snack. What the Pokémon holds works as seasoning.
tasks:
- checkmark: true
title: Read this
- id: weather
title: Weather
icon: minecraft:snowball
after: [how]
text: |
Only one weather runs at a time: the last one switched on wins.
Rain Dance: real rain around you, anywhere; it puts out fires and counts for rain evolutions and spawns.
Thunder: a thunderstorm around you.
Sunny Day: keeps the sky clear.
Blizzard: real snow falls and settles around you.
Sandstorm: soul sand and honey don't slow you, and sand, gravel and clay break four times as fast.
Mist: anything hunting you loses you once you're 8 blocks away. Needs the Mire gate.
tasks:
- checkmark: true
title: Read this
- id: mounts
title: Mount Toggles
icon: minecraft:saddle
after: [how]
text: |
Switch these on from the Field moves of the Pokémon you ride. They stay on for that Pokémon.
Surf: much faster through water.
Tailwind: faster through the air.
Agility: faster on land.
Swift: reaches top speed twice as quickly.
U-turn: turns far more sharply.
Endure: double the stamina.
tasks:
- checkmark: true
title: Read this
- id: button_isle
zone: button_isle
title: Button Isle
@@ -359,3 +563,14 @@ chapters:
Your PC holds every Pokémon not in your party. There is no remote access: you have to stand at a PC block.
tasks:
- item: cobblemon:pc
layout:
getting_started/beyond: [6.0, 0.75]
getting_started/drops: [4.0, 3.0]
getting_started/evolve: [6.0, -0.75]
getting_started/first_partner: [2.0, -0.75]
getting_started/full_team: [4.0, -3.0]
getting_started/healing: [4.0, 0.0]
getting_started/level_10: [4.0, 1.5]
getting_started/permadeath: [4.0, -1.5]
getting_started/poke_balls: [2.0, 0.75]