PHAYRIOSIS REBORN CONTINUED — 0.1.3 (CONFIG UI + METEOR DEFENDER HP)
Author: leo_san
Minecraft: 1.20.1; Forge: 47.4.x; Runtime: Java 17
Date: 2026-10-12

AUTHORITATIVE INPUT
- Phayriosis-Reborn-Continued-0.1.3.jar supplied by the user for this change.
- Version and prior six elite defenders retained unchanged.
- Previously tested meteor-only In Control exemption and all its Mixins are unchanged.

CHANGE 1: MODPACK CREATOR CREATE-WORLD UI HIDE
- New option is `hideWorldCreationConfig = false` under [general] in the global
  client/instance config/phayriosisreborn-common.toml.
- Set to true to omit the Phayriosis settings button from Minecraft's Create World
  Game tab. The button is removed during screen reinitialization before applying
  the hide gate so stale button instances are not retained.
- The separate per-world serverconfig/phayriosisreborn-server.toml remains authoritative
  for established worlds and is not replaced. The hide flag belongs to the global
  client config because a per-world server config is not available at Create World.
- Existing TOMLs gain this option only if absent. The upgrade preserves existing values,
  leaves true values unchanged, and is idempotent; new generated TOMLs include it.
- Original Phayriosis config UI functions as before with the default false setting.
- This hides the Create World button; it does not block operators from /phayconfig,
  does not prohibit manual config editing, and is not a server-side permissions mechanism.
- A restart of the client/instance is needed after editing the global option because
  PhayriosisFileConfig is loaded once and cached during the process.

CHANGE 2: MINIMUM 100 HP FOR OUTSIDE METEOR DEFENDERS ONLY
- In PhayriosisMeteorImpactSystem.spawnImpactInfected, take the returned Entity from
  each existing spawnEntity call and pass it to MeteorDefenderHealth.raiseIfBelow100.
- For LivingEntity defenders with effective maximum health less than 100, adjust the
  maximum-health attribute and set current health to 100 (or up to effective maximum).
- Preserve any entity with 100 or more maximum HP with no attribute or health changes.
- Existing spawnEntity method, MeteorSpawnScope, spawn position distribution, all
  exterior defender type entries, and optional In Control Mixins are unchanged.
- The Nucleus lives in spawnNucleusGuardian, which is left untouched and continues
  to receive its pre-existing 500 HP base health; it never calls the new helper.
- No ticking hooks, entity iteration, or background calculations are added. The
  helper runs only immediately following each exterior meteor spawn attempt.

CHANGED EXISTING CLASS FILES
- net/mcreator/phayriosisreborn/config/PhayriosisFileConfig.class
- net/mcreator/phayriosisreborn/client/PhayriosisCreateWorldClient.class
- net/mcreator/phayriosisreborn/meteor/PhayriosisMeteorImpactSystem.class
NEW CLASS FILES
- net/mcreator/phayriosisreborn/config/PhayriosisConfigUpgrade.class
- net/mcreator/phayriosisreborn/meteor/MeteorDefenderHealth.class
UPDATED DOCUMENTATION
- Root and META-INF/phayriosis-maintainer copies of the maintenance history.
- This release log and both new helper sources included under META-INF/phayriosis-maintainer.

IMPLEMENTATION / VERIFICATION
- Narrow JVM instruction patch via Java 21 JDK internal ASM API; output Java 17 class
  major version 61. The source archive contains the patcher and the new helper classes.
- FileConfig.read uses its existing boolean parser on general.hideworldcreationconfig.
- Existing TOML upgrade runs in the existing ensureLoaded error-handled I/O path.
- Create World UI uses its existing allowCheats null gate after applying UI-only flag.
- Exterior defender hook consumes the returned Entity instead of its original POP.
- Verified config upgrade preserves values, skips duplicate insertion, and respects true.
- Verified mocked health cases: 20, 80, 100, 165, 500, and modified attribute values.
- Release JAR integrity, bytecode descriptors and all unchanged entry hashes verified.
- Full Minecraft Forge runtime testing remains to be performed by the user; if issues
  occur, collect latest.log and any crash report from the exact installed release JAR.

LIMITATIONS / HANDOFF
- The global hide option prevents access through this Create World UI; it is not a
  security boundary. Operators can still change server settings using existing tools.
- Other mods may subsequently modify a meteor defender's attributes after spawning.
- The original exterior registry IDs `assaulter` and `spitter` were preserved, even
  though older maintenance notes flagged them as possibly absent. This release does
  not attempt to fix those names to avoid unrelated alterations.
- Continue development from THIS jar as the authoritative user-selected 0.1.3 base.
