scawful/yaze
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Update z3ed README to enhance CLI output and help system documentation

Browse Source
This commit is contained in:
scawful
2025-10-04 14:24:33 -04:00
parent 78c6041877
commit f115e1caad
2 changed files with 84 additions and 46 deletions
Download Patch File Download Diff File Expand all files Collapse all files

90
docs/D1-roadmap.md
View File

@@ -1,62 +1,62 @@
# Roadmap
## 0.4.X (Next Major Release)
**Last Updated: October 4, 2025**
### Core Features
- **Overworld Sprites**: Complete sprite editing with add/remove functionality
- **Enhanced Dungeon Editing**: Advanced room object editing and manipulation
- **Tile16 Editing**: Enhanced editor for creating and modifying tile16 data
- **Plugin Architecture**: Framework for community extensions and custom tools
- **Graphics Sheets**: Complete editing, saving, and re-importing of sheets
- **Project Refactoring**: Clean up resource loading and memory usage
This document outlines the development roadmap for YAZE. The project has made significant strides in core features, AI integration, and testing infrastructure. The immediate focus is on stabilizing the test suite and completing key editor functionalities.
### Technical Improvements
- **Sprite Property Editor**: Add support for changing sprite behavior and attributes
- **Custom Sprites**: Support creating and editing custom sprites
- **Asar Patching**: Stabilize existing patching system for advanced modifications
## Current Focus: Stability & Core Features
## 0.5.X
The highest priority is to fix the broken test suites to ensure the stability and correctness of the existing, largely complete, feature set. Alongside this, work will continue on completing the core AI and editor functionalities.
### Advanced Features
- **SCAD Format**: Polish and finalize the scad file integration
- **Hex Editing Improvements**: Enhance user interface for direct ROM manipulation
- **Music Editing**: Add an interface to edit and manage music data
---
## 0.6.X
## 0.4.X (Next Major Release) - Stability & Core Tooling
### Platform & Integration
- **Cross-Platform Stability**: Test and refine builds across Windows, macOS, iOS, and Linux
- **Plugin/Integration Framework**: Provide hooks or scripting for community add-ons
### Priority 1: Testing & Stability (BLOCKER)
- **Fix Dungeon Editor Test Suite**: Resolve the critical `SIGBUS` and `SIGSEGV` crashes that are blocking all integration tests for the dungeon system.
- **Refactor Integration Tests**: Migrate tests from the unstable `MockRom` to use the `TestRomManager` with real ROM files, following the pattern set by the passing rendering tests.
- **Expand E2E Coverage**: Create a comprehensive end-to-end smoke test for the Dungeon Editor and expand coverage for the Overworld editor.
## 0.7.X
### Priority 2: `z3ed` AI Agent
- **Complete Live LLM Testing**: Verify and harden the function-calling loop with live Ollama and Gemini models.
- **Enhance GUI Chat Widget**: Implement state persistence and integrate proposal review shortcuts directly into the editor's chat window.
- **Expand Agent Toolset**: Add new read-only tools for inspecting dialogue, sprite properties, and other game resources.
### Performance & Polish
- **Performance Optimizations**: Remove bottlenecks in rendering and data processing
- **Documentation Overhaul**: Update manuals, guides, and in-app tooltips
### Priority 3: Editor Features
- **Dungeon Editor**: Implement missing features identified from the ZScream comparison, such as custom collision and object limits tracking.
- **Overworld Sprites**: Complete the sprite editing workflow, including adding, removing, and moving sprites on the canvas.
- **Sprite Property Editor**: Create a UI to edit sprite attributes and behavior.
## 0.8.X
---
### Beta Preparation
- **Beta Release**: Code freeze on major features, focus on bug fixes and polish
- **User Interface Refinements**: Improve UI consistency, iconography, and layout
- **Internal Cleanup**: Remove deprecated code, finalize API calls
## 0.5.X - Feature Expansion
## 1.0.0
- **Plugin Architecture**: Design and implement the initial framework for community-developed extensions and custom tools.
- **Advanced Graphics Editing**:
- Finalize the Tile16 Editor palette system, fixing all known color consistency bugs.
- Implement functionality to edit and re-import full graphics sheets.
- **`z3ed` AI Agent Enhancements**:
- **Collaborative Sessions**: Investigate and implement infrastructure for multi-user collaborative editing and AI interaction.
- **Multi-modal Input**: Integrate screenshot capabilities to send visual context to Gemini for more accurate, context-aware commands.
### Stable Release
- **Stable Release**: Final, production-ready version
- **Changelog**: Comprehensive summary of all changes since 0.0.0
---
## Current Focus Areas
## 0.6.X - Polish & Integration
### Immediate Priorities (v0.4.X)
1. **Dungeon Editor Refactoring**: Complete component-based architecture
2. **Sprite System**: Implement comprehensive sprite editing
3. **Graphics Pipeline**: Enhance graphics editing capabilities
4. **Plugin System**: Enable community extensions
- **Cross-Platform Stability**: Conduct full testing and bug fixing cycles for Windows and Linux to ensure a stable experience equivalent to macOS.
- **Advanced Content Editors**:
- Implement a user interface for the music editing system.
- Enhance the Hex Editor with better search and data interpretation features.
- **Documentation Overhaul**:
- Implement a system to auto-generate C++ API documentation.
- Write a comprehensive user guide for ROM hackers, covering all major editor workflows.
---
## 0.7.X and Beyond - Path to 1.0
- **Performance Optimization**: Implement high-priority items from the graphics performance plan, such as lazy loading of graphics and streaming assets from the ROM.
- **UI/UX Refinements**: Improve UI consistency, iconography, and overall layout based on user feedback.
- **Beta Release**: Code freeze on major features to focus on bug fixing and final polish.
- **1.0 Stable Release**: Final, production-ready version with a comprehensive changelog.
### Long-term Vision
- **Community-Driven**: Robust plugin system for community contributions
- **Cross-Platform Excellence**: Seamless experience across all platforms
- **Performance**: Optimized for large ROMs and complex modifications
- **Accessibility**: User-friendly interface for both beginners and experts