#!/usr/bin/env python3 """Generate room-owned stages, shared atlases, native foes and route tables.""" import hashlib,json from PIL import Image from extract_graphics import ROOT,decode from extract_start_room import extract,write_json,RGB from overworld_data import manifest,metadata from nes_object_graphics import P PALETTE_NATIVE=[2,3,0,1] def prepare(): entries=manifest();assert len({e['stage'] for e in entries})==len(entries) size=max(17,max(e['stage'] for e in entries)+1);rooms={};meta={};by_native={e['room']:e for e in entries};by_stage={e['stage']:e for e in entries} for e in entries: d=extract(e['room'],e['name']);rooms[e['stage']]=d;m=metadata(e['room']);meta[e['stage']]=m assert len(m['foes'])<=5 and set(m['foes'])<={7,8,9},(e,m) # Opaque CHR indices share one canonical green palette; cells select NES colors. bank=ROOT/'assets/tilesets/north';doc=json.loads((bank/'asset.json').read_text());patterns=bytearray(4096) for offset,chunk_size,dest in [(34687,1792,0),(51515,2080,1792),(36479,224,3872)]:patterns[dest:dest+chunk_size]=P[offset:offset+chunk_size] nes_palettes=rooms[0]['background_nes_palettes'];colors=[(*RGB[c],255) for c in nes_palettes[2]] native_tiles=sorted({t for d in rooms.values() for row in d['tilemap'][8:] for t in row});glyph={};arts=[] for tile in native_tiles: im=Image.new('RGBA',(8,8));im.putdata([colors[v] for v in decode(patterns[tile*16:(tile+1)*16])]);path=bank/f'tile_{tile:02x}.png';im.save(path);gid=len(arts);glyph[tile]=gid;arts.append({'file':path.name,'index':gid,'artifact_id':f'world-tile-{tile:02x}','fingerprint':hashlib.sha256(path.read_bytes()).hexdigest()}) doc['artifacts']=arts;doc['name']='Shared NES overworld terrain';doc['output']['pipeline']['palettes']=[{'index':i,'palette':{'rgba8888':[int.from_bytes(bytes((*RGB[c],255)),'big',signed=True) for c in nes_palettes[n]]}} for i,n in enumerate(PALETTE_NATIVE)];write_json(bank/'asset.json',doc) blank={'active':False,'glyph_id':0,'palette_id':0,'flip_x':False,'flip_y':False} def cells(stage): d=rooms[stage];return [{'active':True,'glyph_id':glyph[(243 if y==10 else 36) if stage==2 and 14<=x<=15 and 10<=y<=11 else d['tilemap'][y][x]],'palette_id':PALETTE_NATIVE.index(d['palette_map'][y][x]),'flip_x':False,'flip_y':False} for y in range(8,30) for x in range(32)] def publish(root,width,tiles): p=ROOT/f'assets/scenes/{root}/scene-bank.pack-request.json';v=json.loads(p.read_text());v['layers'][0].update(width=width,height=len(tiles)//width,tiles=tiles);write_json(p,v) atlas=[];atlas_index={} for e in entries:atlas_index[e['stage']]=len(atlas)//960;atlas += [dict(blank) for _ in range(256)]+cells(e['stage']) publish('overworld_north',32,atlas) # Connections require both native adjacency and an actual shared walkable opening. exceptions=(141,145,156,172,173,204,210,213,223) def walk(t):return t<137 or t in exceptions def witnesses(left,right,vertical): a=rooms[left]['tilemap'];b=rooms[right]['tilemap'] if vertical:return [x*8 for x in range(0,31,2) if all(walk(v) for v in (a[29][x],a[29][x+1],b[8][x],b[8][x+1]))] return [61+i*16 for i in range(11) if walk(a[9+i*2][30]) and walk(b[9+i*2][0])] links=[];transition_tiles=[];neighbors=[-1]*(size*4);transition_y=[0]*(size*4) for e in entries: for delta,vertical in [(1,False),(16,True)]: if not vertical and e['room']%16==15:continue other=by_native.get(e['room']+delta) if not other:continue points=witnesses(e['stage'],other['stage'],vertical) if not points:continue a=e['stage'];b=other['stage'];base=len(transition_tiles)//64*8 transition_tiles += [dict(blank) for _ in range(8*64)] ac=cells(a);bc=cells(b) if vertical: for chunk in (ac,bc): for y in range(22):transition_tiles += chunk[y*32:(y+1)*32]+[dict(blank) for _ in range(32)] da,db=4,8 else: for y in range(22):transition_tiles += ac[y*32:(y+1)*32]+bc[y*32:(y+1)*32] da,db=1,2 idx=lambda stage,d:stage*4+{1:0,2:1,4:2,8:3}[d] neighbors[idx(a,da)]=b;neighbors[idx(b,db)]=a;transition_y[idx(a,da)]=base;transition_y[idx(b,db)]=base links.append({'a':a,'b':b,'room_a':e['room'],'room_b':other['room'],'direction':da,'atlas_y':base,'openings':points}) publish('overworld_north_scroll',64,transition_tiles) # Each screen still owns its tile array and stage API, generated from its ROM room. for e in entries: if not e['managed']:continue folder=ROOT/'src/stages'/e['module'];folder.mkdir(parents=True,exist_ok=True);typ=e['data_type'];service=e['service'];tiles=[v for row in rooms[e['stage']]['tilemap'][8:] for v in row] source='// Generated by prepare_overworld.py from the verified native room.\n' source+='declare global terrain: array = ['+','.join(map(str,tiles))+'];\n' source+=f'''declare struct {typ}() {{ fn tile_at(column: int,row: int) -> int {{ if column<0 || column>=32 || row<0 || row>=22 {{ return 255; }} return terrain[row*32+column] else 255; }} fn contains_player(x: int,y: int) -> bool {{ return x>=0 && x<=240 && y>=61 && y<=221; }} }} ''' (folder/'room.generated.pbs').write_text(source) (folder/'mod.barrel').write_text(f'pub service {service};\nmod struct {typ};\n') (folder/'main.pbs').write_text(f'''import {{ Composer }} from @sdk:composer; declare global room: {typ} = new {typ}(); declare service {service} {{ fn render() -> bool {{ let status=Composer.bind_scene(13); return status==0; }} fn tile_at(column: int,row: int) -> int {{ return room.tile_at(column,row); }} fn contains_player(x: int,y: int) -> bool {{ return room.contains_player(x,y); }} }} ''') # Room $66 has the native open doorway of shop $78. shop_room=ROOT/'src/stages/overworld_northwest/main.pbs' wrapper=shop_room.read_text().replace(' fn render()', ' fn can_enter(x: int,y: int,grid: int) -> bool { return x==112 && y==77 && grid==0; }\n fn render()') shop_room.write_text(wrapper) supply_room=ROOT/'src/stages/overworld_shop_west/main.pbs' supply_room.write_text(supply_room.read_text().replace(' fn render()', ' fn can_enter(x: int,y: int,grid: int) -> bool { return x==64 && y==77 && grid==0; }\n fn render()')) # Room $67 has a real rock-wall tile object; terrain stores its revealed passage. north=ROOT/'src/stages/overworld_north' source=(north/'main.pbs').read_text();source='import { BombableWall } from @zelda1:world;\nimport { Scene } from @zelda1:scene;\n'+source source=source.replace('declare global room:', 'declare global wall_fresh: bool=false;\ndeclare global rock_wall: BombableWall = new BombableWall(103,112,80);\ndeclare global room:') source=source.replace(' fn tile_at(column: int,row: int) -> int { return room.tile_at(column,row); }', ' fn tile_at(column: int,row: int) -> int { if column>=14 && column<=15 && row>=2 && row<=3 { if rock_wall.opened() { if row==2 && !wall_fresh { return 243; } return 36; } } return room.tile_at(column,row); }') source=source.replace(' fn render()', ' fn wall_opened() -> bool { return rock_wall.opened(); }\n fn finish_visit() -> void { wall_fresh=false; }\n fn blast(x: int,y: int) -> void { let opened=rock_wall.try_blast(x,y); if opened { wall_fresh=true; } }\n fn can_enter(x: int,y: int,grid: int) -> bool { let opened=rock_wall.opened(); return opened && x==112 && y==77 && grid==0; }\n fn draw_wall(dx: int,dy: int) -> void { if rock_wall.opened() { return; }\n'+''.join(f' Scene.emit_sprite({glyph[t]},0,{112+x}+dx,{80+y}+dy,10,0);\n' for t,x,y in [(216,0,0),(218,8,0),(217,0,8),(219,8,8)])+' }\n fn render()') (north/'main.pbs').write_text(source) # Marker positions follow the original 16x8 overworld grid. hud=ROOT/'assets/ui/hud';hdoc=json.loads((hud/'asset.json').read_text());base=Image.open(hud/'hud_09.png').convert('RGBA');green=(56,184,0,255);gray=(124,124,124,255);dots=[(x,y) for y in range(32) for x in range(32) if base.getpixel((x,y))==green];hud_ids=[9]*size for e in entries: if e['stage']==0:continue marker_id=f'world-marker-{e["room"]:02x}';existing=next((a for a in hdoc['artifacts'] if a['artifact_id']==marker_id),None) idx=existing['index'] if existing else max(a['index'] for a in hdoc['artifacts'])+1;im=base.copy() for x,y in dots:im.putpixel((x,y),gray) dx=(e['room']%16-7)*2;dy=(e['room']//16-7)*4 for x,y in dots:im.putpixel((x+dx,y+dy),green) path=hud/f'world-marker-{e["room"]:02x}.png';im.save(path);hdoc['artifacts']=[a for a in hdoc['artifacts'] if a['index']!=idx and a['artifact_id']!=f'world-marker-{e["room"]:02x}']+[{'file':path.name,'index':idx,'artifact_id':path.stem,'fingerprint':hashlib.sha256(path.read_bytes()).hexdigest()}];hud_ids[e['stage']]=idx write_json(hud/'asset.json',hdoc) ids=[119]*size;camera=[0]*size;counts=[0]*size;kinds=[0]*(size*5);edge=[0]*size;menu=[0]*size;menu[1]=1 ids[10]=103;hud_ids[10]=hud_ids[2];menu[10]=1 ids[11]=102;hud_ids[11]=hud_ids[3];menu[11]=1 ids[16]=68;hud_ids[16]=hud_ids[15];menu[16]=1 for e in entries: i=e['stage'];menu[i]=0 if i==0 else atlas_index[i]+3;ids[i]=e['room'];camera[i]=atlas_index[i]*240;counts[i]=len(meta[i]['foes']);edge[i]=int(meta[i]['edge_spawns']);kinds[i*5:i*5+len(meta[i]['foes'])]=meta[i]['foes'] folder=ROOT/'src/overworld';folder.mkdir(parents=True,exist_ok=True);(folder/'mod.barrel').write_text('pub service Overworld;\nmod struct WorldData;\n') data=['// Generated overworld catalog: room identity, foes, UI and directed edges.'] for name,values in [('ids',ids),('camera',camera),('counts',counts),('kinds',kinds),('edges',edge),('menu',menu),('hud',hud_ids),('zora',[int(meta[i]['zora']) if i in meta else 0 for i in range(size)]),('neighbors',neighbors),('transition_y',transition_y)]:data.append(f'declare global world_{name}: array = ['+','.join(map(str,values))+'];') data+=['declare struct WorldData() {'] for name,default in [('ids',119),('camera',0),('counts',0),('edges',0),('zora',0),('menu',0),('hud',9)]:data.append(f' fn {name}(i: int) -> int {{ return world_{name}[i] else {default}; }}') data+=[' fn kind(stage: int,slot: int) -> int { return world_kinds[stage*5+slot] else 0; }',' fn index(stage: int,direction: int) -> int { let d=if direction==1 { 0 } else if direction==2 { 1 } else if direction==4 { 2 } else { 3 }; return stage*4+d; }',' fn neighbor(stage: int,direction: int) -> int { let i=this.index(stage,direction); return world_neighbors[i] else -1; }',' fn transition_y(stage: int,direction: int) -> int { let i=this.index(stage,direction); return world_transition_y[i] else 0; }','}'] (folder/'data.generated.pbs').write_text('\n'.join(data)+'\n') code=['import { CaveStart } from @zelda1:stages/cave_start;','import { CaveSecret } from @zelda1:stages/cave_secret;','import { CaveShop } from @zelda1:stages/cave_shop;','import { CaveSupplyShop } from @zelda1:stages/cave_supply_shop;']+[f'import {{ {e["service"]} }} from @zelda1:stages/{e["module"]};' for e in entries] code+=['declare global data: WorldData = new WorldData();','declare service Overworld {',' fn is_cave(stage: int) -> bool { return stage==1 || stage==10 || stage==11 || stage==16; }',' fn has_zora(stage: int) -> bool { let value=data.zora(stage); return value!=0; }',' fn native_id(stage: int) -> int { return data.ids(stage); }',' fn camera_y(stage: int) -> int { return data.camera(stage); }',' fn foe_count(stage: int) -> int { return data.counts(stage); }',' fn foe_kind(stage: int,slot: int) -> int { return data.kind(stage,slot); }',' fn from_edges(stage: int) -> bool { let value=data.edges(stage); return value!=0; }',' fn hud_glyph(stage: int) -> int { return data.hud(stage); }',' fn menu_variant(stage: int) -> int { if stage==1 || stage==10 || stage==11 || stage==16 { return 1; } return data.menu(stage); }',' fn neighbor(stage: int,direction: int) -> int { return data.neighbor(stage,direction); }',' fn transition_y(stage: int,direction: int) -> int { return data.transition_y(stage,direction); }'] for method,args,ret,fallback in [('tile_at','column: int,row: int','int','255'),('contains_player','x: int,y: int','bool','false'),('render','','bool','false')]: tail='column,row' if method=='tile_at' else 'x,y' if method=='contains_player' else '' code.append(f' fn {method}(stage: int'+(','+args if args else '')+f') -> {ret} {{') code.append(f' if stage==1 {{ return CaveStart.{method}({tail}); }}') code.append(f' if stage==10 {{ return CaveSecret.{method}({tail}); }}') code.append(f' if stage==11 {{ return CaveShop.{method}({tail}); }}') code.append(f' if stage==16 {{ return CaveSupplyShop.{method}({tail}); }}') for e in entries:code.append(f' if stage=={e["stage"]} {{ return {e["service"]}.{method}({tail}); }}') code+=[' return '+fallback+';',' }'] code+=['}'];(folder/'main.pbs').write_text('\n'.join(code)+'\n') strips=[{'root':'overworld_start','row':8,'palette':'start'}]+[{'root':r,'row':8,'palette':'cave'} for r in ('cave_start','cave_start','cave_start')] strips += [{'root':'overworld_north','row':atlas_index[e['stage']]*30+8,'palette':'world'} for e in entries if e['stage']!=0] report={'rooms':[dict(e,**meta[e['stage']],atlas_index=atlas_index[e['stage']]) for e in entries],'links':links,'menu_strips':strips,'world_palette_to_native':PALETTE_NATIVE,'limits':{'actor_pool':5,'scene_slots':16},'legacy_gaps':[]} write_json(ROOT/'extracted/overworld/expansion/catalog.json',report) from prepare_inventory_screen import prepare as inventory inventory() print('Overworld:',len(entries),'rooms,',len(links),'bidirectional links,',len(arts),'glyphs; no new scene slots') if __name__=='__main__':prepare()