Files
yaze/docs/public/examples/README.md
scawful e36d81f357 fix(linux): add missing yaze_gfx_render dependency to yaze_gfx_debug
Fixes linker error on Linux where yaze_gfx_debug.a (performance_dashboard.cc)
was calling AtlasRenderer::Get() and AtlasRenderer::GetStats() but wasn't
linking against yaze_gfx_render which contains atlas_renderer.cc.

Root cause: yaze_gfx_debug was only linking to yaze_gfx_types and
yaze_gfx_resource, missing the yaze_gfx_render dependency.

This also fixes the undefined reference errors for HttpServer methods
which were already properly included in the agent.cmake source list.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 01:38:55 -05:00

1.7 KiB

Examples & Recipes

Short, task-focused snippets for everyday YAZE workflows. These examples supplement the primary guides (Getting Started, z3ed CLI, Dungeon/Overworld editors) and should remain concise. When in doubt, link back to the relevant guide instead of duplicating long explanations.

1. Launching Common Editors

# Open YAZE directly in the Dungeon editor with room cards preset
./build/bin/yaze --rom_file=zelda3.sfc \
  --editor=Dungeon \
  --cards="Rooms List,Room Graphics,Object Editor"

# Jump to an Overworld map from the CLI/TUI companion
./build/bin/z3ed overworld describe-map --map 0x80 --rom zelda3.sfc

2. AI/Automation Recipes

# Generate an AI plan to reposition an entrance, but do not apply yet
./build/bin/z3ed agent plan \
  --rom zelda3.sfc \
  --prompt "Move the desert palace entrance 2 tiles north" \
  --sandbox

# Resume the plan and apply it once reviewed
./build/bin/z3ed agent accept --proposal-id <ID> --rom zelda3.sfc --sandbox

3. Building & Testing Snippets

# Debug build with tests
cmake --preset mac-dbg
cmake --build --preset mac-dbg --target yaze yaze_test
./build/bin/yaze_test --unit

# AI-focused build in a dedicated directory (recommended for assistants)
cmake --preset mac-ai -B build_ai
cmake --build build_ai --target yaze z3ed

4. Quick Verification

  • Run ./scripts/verify-build-environment.sh --fix (or the PowerShell variant on Windows) whenever pulling major build changes.
  • See the Build & Test Quick Reference for the canonical list of commands and testing recipes.

Want to contribute another recipe? Add it here with a short description and reference the relevant guide so the examples stay focused.