# 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.