============================================================
NIKO MOVESET - README
============================================================

Hack / Patch by: Nico
Base game: Super Mario World
Recommended emulator: Snes9x / BizHawk / bsnes
Format recommended for release: BPS patch, not ROM

IMPORTANT:
Do not upload or distribute a ROM file. For SMW Central, create and upload a
BPS patch made from a clean Super Mario World ROM.


============================================================
ABOUT
============================================================

Niko Moveset is a gameplay-focused Super Mario World hack/patch that adds a
new advanced movement system, optional character unlocks, special Yoshis, and
hard-mode boss behavior.

The goal is to make Mario feel faster, more expressive, and more technical,
while still keeping the game recognizable as Super Mario World.


============================================================
MAIN MOVES
============================================================

Slide
- Press Down while running to slide.
- The slide can defeat normal enemies.
- Some characters can break certain blocks while sliding.
- Slide jump/long jump keeps strong horizontal momentum.

Long Jump / Slide Jump
- Jump during or after a slide to perform a long horizontal jump.
- Useful for speed, skips, and reaching far platforms.

Air Dash
- While holding Run, tap left or right three times quickly in the air.
- Performs a short horizontal dash.
- Luigi’s dash lasts slightly longer.

Double Jump
- Mario / Shadow Mario: double jump uses spin-style input.
- Luigi: double jump uses Run + Jump and has a flutter-style air kick.

Wall Stick / Wall Jump
- Hold toward a wall in the air to stick and slide down.
- Jump from the wall to launch away.
- Shadow Mario slides down faster, making wall sticking harder.
- Cape spin prevents accidental wall sticking while flying.

Charged Jump
- Hold Down to charge.
- Release/jump after charging to perform a higher jump.
- Camera follows high jumps upward more naturally.

Parry / Victory Pose Move
- A short defensive move using the victory/star-style pose.
- Gives a brief flash/invincibility window.
- Luigi can chain a manual spin after a successful parry.


============================================================
CHARACTERS
============================================================

Mario
- Balanced default character.
- Normal movement and cape behavior.
- Standard version of the new moveset.

Luigi
- Lighter and more technical.
- Has a flutter-style second jump.
- Slightly longer air dash.
- Easier slide than Mario, but still requires running.
- Slightly better cape float than Mario.

Shadow Mario
- Heavy/power character.
- Stronger slide and long jump.
- Heavier movement and more inertia.
- Stronger ground pound / senton effects.
- Can break more blocks with slides, dashes, and heavy impacts.
- Harder wall stick because he slides down faster.
- Cape is heavier than Mario/Luigi.


============================================================
SPECIAL YOSHIS
============================================================

Rainbow Yoshi
- Special unlockable Yoshi.
- Changes colors in-game and on the overworld.
- Can fire magic-style projectiles.
- Projectiles convert enemies into blue shells.

Star Yoshi
- Secret variant connected to Yoshi’s House.
- Alternates between red/yellow style colors.
- Uses star-looking projectiles visually.
- Keeps the same enemy-converting logic as Rainbow Yoshi.

Yoshi loss behavior
- If you lose or dismount Yoshi and leave a normal level, you should no longer
  keep that Yoshi.
- Castles, ghost houses, and forced dismount levels preserve the intended logic.


============================================================
UNLOCK SYSTEM
============================================================

Luigi Unlock
- Defeat all 7 main Koopalings in their hard-mode conditions.
- After clearing Bowser, Luigi becomes available.

Shadow Mario Unlock
- Defeat all 7 main Koopalings in hard mode.
- Also clear the Reznor hard-mode challenges.
- Reznor progress is tracked separately.

New Game Plus Character Select
- After unlocking characters, new empty files can select unlocked characters
  in the intended character-select area.(yoshis house)
- Completed files keep free character switching behavior.

Yoshi Unlock Condition
- In the public version, the special Yoshi reward requires clearing the Star
  World final reward condition with at least 300 seconds on the timer.

CHARACTER SWITCHING
============================================================

After characters are unlocked, they can be selected depending on the save file state.

Completed Save File Slot
- If the save file has cleared Bowser and unlocked the characters, character
  switching is available freely.
- Use Select + Left / Right to cycle between available characters.

New Empty Save File / New Game Plus
- If another save file slot has already unlocked Luigi or Shadow Mario, a new empty
  file can start as one of the unlocked characters.
- In new files, character switching is restricted to Yoshi’s House / the starting
  character-select area.
- Use Select + Left / Right in Yoshi’s House to choose the character.
- After leaving the character-select area, the chosen character is fixed for
  that run.

Unlock Rules
- Luigi unlocks after clearing the main hard-mode boss requirements.
- Shadow Mario unlocks only if the Reznor hard-mode requirements are also
  completed.
============================================================
BOSS HARD MODES
============================================================

Some bosses gain special “panic” or hard-mode behavior if defeated or attacked
with advanced movement in certain ways.

Reznor
- If platforms are destroyed or the fight is broken early, Reznor enters a
  harder mode.
- A safe goal reward appears to prevent softlocks.

Morton / Roy
- Harder behavior based on the stable Morton-style routine.
- Designed to prevent slide/senton softlocks.

Lemmy / Wendy
- Boss can reset into a safer hard-mode style instead of leaving the level
  unwinnable.
- Extra flame pressure may appear.

Iggy / Larry
- Senton-triggered hard mode.
- Adds extra pressure without completely changing the boss logic.

Ludwig
- Has its own safer hard-mode behavior.
- Avoids using Morton/Roy logic to prevent boss corruption.


============================================================
BOWSER / MIRROR MARIO
============================================================

Bowser has a special Shadow/Mirror Mario phase.

- A mirror version of Mario can appear.
- The arena may include a center mirror/wall mechanic depending on unlock/test
  version.
- Shadow Mario visuals are drawn as a mirrored OAM copy.
- Small Mario and big Mario are handled separately to avoid broken hologram
  graphics.


============================================================
YOSHI HOUSE SECRET
============================================================

Yoshi’s House includes a custom message:

Niko says:

Special thanks to Yulia Star Girl and her TikTok community.

- Enjoy this ROM

Some test versions also use Yoshi’s House to trigger the Star Yoshi secret.


============================================================
KNOWN NOTES
============================================================

- This hack uses UberASMTool and custom ASM.
- Some features depend on SRAM/free RAM, so use a clean save when testing major
  changes.
- If submitting to SMW Central, test on accurate emulators and provide a BPS
  patch only.
- Do not include a ROM file in the upload.


============================================================
CREDITS
============================================================

Original game:
Nintendo

ASM / Moveset / Design:
Nico

Special Thanks:
Yulia Star Girl and her TikTok community

Tools:
UberASMTool
Asar
Lunar Magic
Snes9x
BizHawk