hyrule-navigator

Plan and execute autonomous navigation for Link using world_graph.json and RAM data.

Updated Dec 30, 2025
One-click install
npx skills add https://github.com/scawful/afs_scawful --skill hyrule-navigator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyrule-navigator
Source: https://github.com/scawful/afs_scawful/tree/main/skills/hyrule-navigator
Command: npx skills add https://github.com/scawful/afs_scawful --skill hyrule-navigator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Autonomous navigation and path planning for Link in the Oracle of Secrets enables reliable localization and destination routing within dungeon maps.

Core Features & Use Cases

  • Localization: Localize Link using RAM state to determine position and context (Dungeon and Overworld).
  • Macro-Pathfinding: Plan routes across rooms or screens using world_graph.json and produce a sequence of actions.
  • Micro-Steering: Drive Link to precise coordinates with a PID-like loop and safety checks.

Quick Start

Load the world graph, localize Link, plan a path to the target, and drive Link to the destination.

Frequently Asked Questions about hyrule-navigator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan autonomous navigation routes for a game character across dungeon rooms?

Autonomous navigation routes across dungeon rooms are planned using a world graph file to map screen connections and produce a sequence of macro-path actions for the character to follow.

How does RAM state localization work for determining a character's dungeon position?

RAM state localization reads emulator memory addresses to determine the character's precise position and context, identifying whether they are currently in a dungeon or the overworld map.

Can I use a PID-like steering loop to drive a character to precise coordinates?

Yes, a PID-like steering loop drives the character to precise coordinates by continuously processing emulator inputs and applying safety checks to correct the movement trajectory.

What's the best way to integrate pathfinding scripts with an emulator for game AI?

Integrating pathfinding scripts with an emulator requires combining a world graph for macro-routing with RAM data reads and a steering loop to execute navigation actions directly within the game environment.

Does autonomous dungeon navigation require a world graph file to function?

Yes, autonomous dungeon navigation relies on a world_graph.json file to map the macro-path routing across rooms, which is essential for generating the sequence of actions needed to reach the target destination.