yaze 0.3.2
Link to the Past ROM Editor
 
Loading...
Searching...
No Matches
YAZE Release

YAZE is a cross-platform Zelda 3 editor. This package includes the desktop app (yaze), the z3ed CLI, and required assets.

ROMs are not included. You must supply a legally obtained A Link to the Past ROM.

Contents

  • yaze (desktop app)
  • z3ed (CLI)
  • assets/ (required data)
  • LICENSE
  • manifest.json (build metadata)

Quick Start

Windows (portable zip, no installer)

  1. Unzip to a folder.
  2. Run yaze.exe or z3ed.exe --help from Command Prompt.
  3. Keep the assets/ folder next to the executables.

macOS (DMG)

  1. Open the DMG and drag yaze.app to Applications (optional).
  2. Run yaze.app. For CLI, run ./z3ed --help from Terminal.
  3. If Gatekeeper blocks the app, right-click and choose Open.

Linux (tar.gz)

  1. Extract the archive.
  2. Run ./yaze or ./z3ed --help.
  3. If needed: chmod +x yaze z3ed.

z3ed CLI

  • Run z3ed --help to see command groups.
  • For AI workflows, set the API key env vars below before using z3ed agent ....

Collaboration Server (yaze-server repo)

The multiplayer/collaboration service ships separately:

  • Repo: https://github.com/scawful/yaze-server
  • Clone and follow the README to configure ENABLE_AI_AGENT, GEMINI_API_KEY (or other providers), and websocket ports.
  • The desktop app connects via the collaboration panel once the server is running.

AI Features (optional)

  • Cloud providers: set GEMINI_API_KEY, OPENAI_API_KEY, or ANTHROPIC_API_KEY.
  • Local Ollama: install Ollama and set OLLAMA_MODEL (example: qwen2.5-coder:0.5b).
  • LMStudio: use z3ed --ai_provider=openai --openai_base_url=http://localhost:1234.

.yazeproj Bundles

YAZE supports .yazeproj bundle directories that package a ROM, project config, code snapshots, and backups into a single portable unit.

Bundle layout:

MyProject.yazeproj/
project.yaze # Project configuration
manifest.json # Bundle metadata
rom # ROM binary (no extension)
project/ # Code/asset snapshot
backups/ # Per-bundle backups
output/ # Build output

Opening a bundle:

  • macOS: Double-click the .yazeproj directory, or use File > Open ROM / Project.
  • iOS: Tap the bundle in Files > iCloud Drive > Yaze > Projects, or use the in-app Project Browser.
  • Windows: File > Open ROM / Project and select the .yazeproj folder. If the picker does not show directories, navigate inside and select project.yaze.
  • Linux: File > Open ROM / Project and select the .yazeproj directory.
  • CLI: z3ed <command> --rom=MyProject.yazeproj/rom

See the full .yazeproj Bundle Guide for details.

Data Locations

  • Desktop/CLI: ~/.yaze (Windows uses USERPROFILE%\\.yaze)
  • Web: /.yaze (browser storage via IndexedDB)
  • Projects: store .yaze or .yazeproj project files wherever you prefer (recommended: ~/.yaze/projects)

Documentation