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

Add 'overworld find-tile' command for locating tile instances across maps

Browse Source
This commit is contained in:
scawful
2025-10-03 14:12:05 -04:00
parent c7a7707d25
commit b6ba7cb572
6 changed files with 349 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
docs/z3ed/E6-z3ed-reference.md
View File

@@ -38,7 +38,7 @@
│ ├─ agent describe [--resource <name>] │
│ ├─ rom info/validate/diff/generate-golden │
│ ├─ palette export/import/list │
│ ├─ overworld get-tile/set-tile │
│ ├─ overworld get-tile/find-tile/set-tile │
│ └─ dungeon list-rooms/add-object │
└────────────────────┬────────────────────────────────────┘
│
@@ -629,12 +629,24 @@ Example:
z3ed overworld get-tile --map=0 --x=100 --y=50
```
#### `overworld find-tile` - Locate tile instances across maps
```bash
z3ed overworld find-tile --tile <id> [--map <map_id>] [--world light|dark|special] [--format json|text]
Examples:
# Scan entire overworld for tile 0x02E and emit JSON
z3ed overworld find-tile --tile 0x02E --format json
# Limit search to Light World map 0x05
z3ed overworld find-tile --tile 0x02E --map 0x05
```
#### `overworld set-tile` - Set tile at coordinates
```bash
z3ed overworld set-tile --map <id> --x <x> --y <y> --tile-id <id>
z3ed overworld set-tile --map <id> --x <x> --y <y> --tile <id>
Example:
z3ed overworld set-tile --map=0 --x=100 --y=50 --tile-id=0x1234
z3ed overworld set-tile --map=0 --x=100 --y=50 --tile=0x1234
```
### Dungeon Commands

9
docs/z3ed/README.md
View File

@@ -194,6 +194,15 @@ z3ed agent diff --latest
z3ed agent accept --latest
```
### Locate Existing Tiles
```bash
# Find every instance of tile 0x02E across the overworld
z3ed overworld find-tile --tile 0x02E --format json
# Narrow search to Light World map 0x05
z3ed overworld find-tile --tile 0x02E --map 0x05
```
### Label-Aware Dungeon Edit
```bash
# AI uses ResourceLabels from your project