Files
oracle-of-secrets/Docs
scawful 8b23049e28 Fix menu system crashes and stability issues
- Fix IrisSpotlight crash ($00F361): Removed errant $0116/$17 writes
  from menu_select_item.asm that corrupted VRAM upload index
- Fix journal stack corruption: Added missing PHB in Journal_CountUnlocked
- Fix P register mismatches: Added SEP #$30 to Menu_RefreshQuestScreen,
  Menu_ScrollFrom, Menu_DrawRingPrompt
- Fix MagicBag crashes: Fixed data bank corruption in error path,
  fixed uninitialized Y register in cursor movement
- Relocate StoryState from volatile $7C to SRAM $7EF39E
- Add bounds checking to HouseTag_Main jump table
- Use long addressing (.l) for SRAM access in custom_tag.asm

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-22 03:20:35 -05:00
..
2025-10-03 16:07:58 -04:00

Oracle of Secrets Documentation

Welcome to the documentation for Oracle of Secrets. This directory is organized to help you find information about the project's architecture, systems, and content.

Directory Structure

  • ./General/: High-level project information, including development guidelines and build instructions.
  • ./Core/: Documentation for the core engine components, such as memory maps, the player engine (Link.md), and system interaction analysis.
  • ./Features/: Detailed analysis of major gameplay features.
    • ./Features/Items/: Information on custom and modified items.
    • ./Features/Masks/: Details on the mask transformation system.
    • ./Features/Menu/: Analysis of the custom menu and HUD.
    • ./Features/Music/: Guide to the music system and composition workflow.
  • ./World/: Information about the game world's construction.
    • ./World/Overworld/: Documentation for the overworld engine, including ZSCustomOverworld and the time system.
    • ./World/Dungeons/: Details on dungeon mechanics and custom features.
  • ./Sprites/: Analysis of all sprite types, including bosses, NPCs, and interactive objects.
  • ./Guides/: Step-by-step guides and tutorials, such as the sprite creation guide and the main quest flowchart.

Key Documents

  • General/DevelopmentGuidelines.md: The primary guide for coding standards, architecture, and best practices. Start here to understand the project's philosophy.
  • Core/MemoryMap.md: A comprehensive map of custom WRAM and SRAM variables.
  • Guides/QuestFlow.md: A detailed walkthrough of the main story and side-quest progression.
  • Guides/SpriteCreationGuide.md: A tutorial for creating new custom sprites.
  • World/Overworld/ZSCustomOverworld.md: A deep dive into the data-driven overworld engine that powers the game world.