Feature: add "no free heals" (-nfh) challenge flag

[HansGR]

Add a new flag -nfh (--no-free-heals) that removes, adds costs, or limits events that recover the party fully. Modified healing events include:

• The Narshe bucket may be used only 3 times;
• Healing springs select a random effect from a list that includes healing HP+MP, HP or MP or status only, or applying a random status effect to the party;
• When sleeping in free beds (i.e. Sabin's House), the party has a chance to be ambushed during the night;
• The WoB airship healer costs 3000 GP;
• The Returners hideout and Figaro Castle inns charge money;
• The Vector hut may be used once (after defeating the battle);
• The Phantom Train restaurant offers three options, only the most expensive of which guarantees healing;
• All inn costs are multiplied by 3x (including money randomly stolen at Vector inn, with limit that you can't sleep there if too poor);
• all other event free heals are removed

The flag should be compatible with all other Worlds Collide flags. Free heals inside event locations are handled in the event classes (e.g. events/doma_wob.py). Inn prices, beds, and recovery springs are modified via functions in events/free_heals.py.

[gemini-code-assist]

Code Review

This pull request introduces the -nfh (--no-free-heals) flag, which restricts or removes free party heals throughout the game, including inns, recovery springs, free beds, and scripted event heals. To support this, a new event/free_heals.py module is added alongside a custom BedHealCharacter field instruction. The feedback highlights critical compilation and logic issues: the Read class is not imported and is incorrectly referenced as field.Read in event/free_heals.py, and a missing branch instruction in BedHealCharacter causes HP healing to fall through into MP healing, violating the intended mutually exclusive behavior.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[wrjones104]

All gemini-code-assist comments are valid and should be addressed

[HansGR]

All gemini-code-assist comments are valid and should be addressed

Done. Note that the bed heal docstring was out of date: the desired functionality was implemented correctly: if alive and no status effect, add (max HP)/4 AND (max MP)/4. Docstring is now up to date.