Files
AVA2/tools/generate_ava2_item_oracle.py
T
shenleiandClaude Opus 5.5 9077aa389a AVA2 client Windows parity passes (gr2 BitKnit2/64-bit, GamePhase handlers, python modules)
- gr2: BitKnit2 decompression, 64-bit LE files, compressed curves
- net: remaining GamePhase handlers, generated GC packet table
- python: event/chat/chr/minimap/guild/quest/messenger/shop-search and
  other native modules ported against the AVA2 Windows client
- render: D3D8 fixed-function lighting in Gr2ModelRenderer, terrain
  without baked shade; cape/NPC equipment attachment
- tests + audits updated; docs/PORT-PLAN.md and WINDOWS-PARITY.md

Batch 4 (render pipeline: background.*, app.RenderGame/UpdateGame,
camera bindings, main.cpp fake-content removal) is still in progress.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 10:43:01 +09:00

100 lines
11 KiB
Python

#!/usr/bin/env python3
"""Extract actual AVA2 Windows item declarations with their active feature guards."""
from pathlib import Path
import re,sys
root=Path(__file__).resolve().parents[1]
packet=(root/'upstream/ava2-client/UserInterface/Packet.h').read_text(errors='replace')
game=(root/'upstream/ava2-client/UserInterface/GameType.h').read_text(errors='replace')
def decl(source,name):
matches=re.findall(r'typedef\s+struct\s+'+name+r'\s*\{.*?\}\s*\w+\s*;',source,re.S)
assert matches,name
return matches[-1].replace('unsigned long long','std::uint64_t').replace('long long','std::int64_t').replace('long','std::int32_t').replace('CItemData::ITEM_NAME_MAX_LEN','24')
constants=game[game.index('enum\n{\n\tITEM_SOCKET_SLOT_MAX_NUM'):]
constants=constants[:constants.index('\n};')+3]
stdafx=(root/'upstream/ava2-client/UserInterface/StdAfx.h').read_text(errors='replace')
assert '#define _USE_32BIT_TIME_T' in stdafx
assert re.search(r'POINT_MAX_NUM\s*=\s*255',stdafx)
equipment=packet[packet.index('enum ECharacterEquipmentPart'):packet.index('typedef struct packet_char_additional_info')]
text='#pragma once\n#include <cstdint>\n#include <cstring>\n#include "'+str(root/'upstream/ava2-client/UserInterface/Locale_inc.h')+'"\nnamespace ava2_windows_item {\nusing BYTE=std::uint8_t;using WORD=std::uint16_t;using DWORD=std::uint32_t;using time_t=std::int32_t;constexpr int POINT_MAX_NUM=255,CHARACTER_NAME_MAX_LEN=24,SKILL_MAX_NUM=255;\n'+constants+'\n'+equipment+'\n#pragma pack(push,1)\nstruct TItemPos { BYTE window_type; WORD cell; };\n'+decl(game,'TPlayerItemAttribute')+'\n'+packet[packet.index('#ifdef RENEWAL_DEAD_PACKET\nenum EReviveTypes'):packet.index('typedef struct packet_dead')]+'\n'+decl(packet,'packet_dead')+'\n'+decl(packet,'SPlayerSkill')+'\n'+decl(packet,'packet_skill_level')+'\n'+decl(packet,'packet_skill_level_new')+'\n'+decl(packet,'command_item_drop')+'\n'+decl(packet,'command_item_drop2')+'\n'+decl(packet,'packet_add_char2')+'\n'+decl(packet,'packet_update_char2')+'\n'+decl(packet,'packet_add_char')+'\n'+decl(packet,'packet_char_additional_info')+'\n'+decl(packet,'packet_update_char')+'\n'+decl(packet,'packet_set_item')+'\n'+decl(packet,'packet_set_item2')+'\n'+decl(packet,'packet_update_item')+'\n'+decl(packet,'packet_exchange')+'\n'+decl(packet,'packet_points')+'\n'+decl(packet,'packet_point_change')+'\n'+decl(packet,'SPacketGCTime')+'\n'+decl(packet,'command_EnterFrontGame')+'\n'+decl(packet,'packet_main_character4_bgm_vol')+'\n#pragma pack(pop)\n}\n'
mob=(root/'upstream/ava2-client/UserInterface/PythonNonPlayer.h').read_text(errors='replace')
mob_decls=decl(mob,'SMobSkillLevel')+'\n'+'\n'.join(decl(mob,'SMobTable_r'+str(size)) for size in (235,255,256,262,263))
text+='namespace ava2_windows_mob { using BYTE=std::uint8_t;using WORD=std::uint16_t;using DWORD=std::uint32_t;constexpr int CHARACTER_NAME_MAX_LEN=24,MOB_ENCHANTS_MAX_NUM=6,MOB_RESISTS_MAX_NUM=11,MOB_SKILL_MAX_NUM=5;\n#pragma pack(push,1)\n'+mob_decls+'\n#pragma pack(pop)\n}\n'
affects=[]
for name in ('TPacketAffectElement','TPacketGCAffectAdd','TPacketGCAffectRemove'):
match=re.search(r'typedef struct\s*\{[^{}]*\}\s*'+name+r'\s*;',packet,re.S)
assert match,name
affects.append(match.group().replace('long','std::int32_t'))
text+='namespace ava2_windows_affect {using BYTE=std::uint8_t;using DWORD=std::uint32_t;\n#pragma pack(push,1)\n'+'\n'.join(affects)+'\n#pragma pack(pop)\n}\n'
skill=(root/'upstream/ava2-client/UserInterface/PythonSkill.h').read_text(errors='replace')
skill_types=re.search(r'enum\s*\{\s*SKILL_TYPE_NONE,.*?\};',skill,re.S)
assert skill_types
text+='namespace ava2_windows_skill {\n'+skill_types.group()+'\n'
for name in ('SKILL_GRADE_COUNT','SKILL_GRADE_STEP_COUNT','SKILL_GRADEGAP','SKILL_EFFECT_COUNT'):
value=re.search(r'\b'+name+r'\s*=\s*(\d+)',skill)
assert value,name
text+='constexpr int '+name+'='+value.group(1)+';\n'
text+='}\n'
item=(root/'upstream/ava2-client/GameLib/ItemData.h').read_text(errors='replace')
item_decls=decl(item,'SItemLimit')+'\n'+decl(item,'SItemApply')+'\n'+'\n'.join(decl(item,'SItemTable_r'+str(size)) for size in (152,156,158))
item_constants=''
for name in ('ITEM_NAME_MAX_LEN','ITEM_LIMIT_MAX_NUM','ITEM_APPLY_MAX_NUM','ITEM_VALUES_MAX_NUM','ITEM_SOCKET_MAX_NUM'):
value=re.search(r'\b'+name+r'\s*=\s*(\d+)',item)
assert value,name
item_constants+='constexpr int '+name+'='+value.group(1)+';\n'
text+='namespace ava2_windows_proto {using BYTE=std::uint8_t;using WORD=std::uint16_t;using DWORD=std::uint32_t;\n'+item_constants+'#pragma pack(push,1)\n'+item_decls+'\n#pragma pack(pop)\n}\n'
quest_flags=re.search(r'enum\s*\{\s*QUEST_SEND_IS_BEGIN.*?\};',packet,re.S)
assert quest_flags
text+='namespace ava2_windows_quest { using BYTE=std::uint8_t;using WORD=std::uint16_t;\n'+quest_flags.group()+'\n#pragma pack(push,1)\n'+decl(packet,'packet_quest_info')+'\n#pragma pack(pop)\n}\n'
messenger_decls='\n'.join(decl(packet,name) for name in ('packet_messenger','packet_messenger_list_offline','packet_messenger_list_online','packet_messenger_login','packet_messenger_logout'))
messenger_enums=[]
for start in ('MESSENGER_SUBHEADER_GC_LIST','MESSENGER_CONNECTED_STATE_OFFLINE'):
match=re.search(r'enum\s*\{\s*'+start+r'.*?\};',packet,re.S)
assert match,start
messenger_enums.append(match.group())
text+='namespace ava2_windows_messenger {using BYTE=std::uint8_t;using WORD=std::uint16_t;\n'+'\n'.join(messenger_enums)+'\n#pragma pack(push,1)\n'+messenger_decls+'\n#pragma pack(pop)\n}\n'
cube_enum=re.search(r'enum\s*\{\s*CUBE_RENEWAL_SUB_HEADER_OPEN_RECEIVE.*?\};',packet,re.S)
assert cube_enum
cube_decls='\n'.join(decl(packet,name) for name in ('packet_send_cube_renewal','dates_cube_renewal','packet_receive_cube_renewal'))
text+='namespace ava2_windows_cube {using BYTE=std::uint8_t;using DWORD=std::uint32_t;constexpr BYTE HEADER_GC_CUBE_RENEWAL=221;\n'+cube_enum.group()+'\n#pragma pack(push,1)\n'+cube_decls+'\n#pragma pack(pop)\n}\n'
search_decls='\n'.join(decl(packet,name) for name in ('packet_offline_shop_item','packet_priv_shop_item_set','command_shop_search'))
text+='namespace ava2_windows_search {using BYTE=std::uint8_t;using DWORD=std::uint32_t;using TPlayerItemAttribute=ava2_windows_item::TPlayerItemAttribute;constexpr int ITEM_SOCKET_SLOT_MAX_NUM=ava2_windows_item::ITEM_SOCKET_SLOT_MAX_NUM,ITEM_ATTRIBUTE_SLOT_MAX_NUM=ava2_windows_item::ITEM_ATTRIBUTE_SLOT_MAX_NUM,CHARACTER_NAME_MAX_LEN=24;\n#pragma pack(push,1)\n'+search_decls+'\n#pragma pack(pop)\n}\n'
guild_decls='\n'.join(decl(packet,name) for name in ('packet_guild','packet_guild_sub_grade','packet_guild_sub_member','packet_guild_sub_info','packet_guild_war','SPacketGuildWarPoint'))
guild_enums='\n'.join(re.search(r'enum(?: EGuildWarState)?\s*\{\s*'+start+r'.*?\};',packet,re.S).group() for start in ('GUILD_SUBHEADER_GC_LOGIN','GUILD_AUTH_ADD_MEMBER','GUILD_WAR_NONE'))
text+='namespace ava2_windows_guild {using BYTE=std::uint8_t;using WORD=std::uint16_t;using DWORD=std::uint32_t;constexpr int GUILD_NAME_MAX_LEN=12,GUILD_GRADE_NAME_MAX_LEN=8;\n'+guild_enums+'\n#pragma pack(push,1)\n'+guild_decls+'\n#pragma pack(pop)\n}\n'
battle_enum=re.search(r'enum\s*\{\s*BATTLEPASS_SUB_HEADER_OPEN.*?\};',packet,re.S)
assert battle_enum
battle_decls='\n'.join(decl(packet,name) for name in ('info_item_battlepass','info_battlepass','packet_cg_battlepass','packet_gc_battlepass'))
text+='namespace ava2_windows_battlepass {using BYTE=std::uint8_t;using DWORD=std::uint32_t;constexpr BYTE HEADER_GC_BATTLEPASS=230;\n'+battle_enum.group()+'\n#pragma pack(push,1)\n'+battle_decls+'\n#pragma pack(pop)\n}\n'
drop_enum=re.search(r'enum\s*\{\s*DROP_ITEM_SUB_HEADER_OPEN.*?\};',packet,re.S)
assert drop_enum
drop_decls='\n'.join(decl(packet,name) for name in ('packet_send_drop_item_system','info_drop_item_system','packet_receive_drop_item_system'))
text+='namespace ava2_windows_drop {using BYTE=std::uint8_t;using DWORD=std::uint32_t;constexpr BYTE HEADER_GC_DROP_ITEM_SYSTEM=220;\n'+drop_enum.group()+'\n#pragma pack(push,1)\n'+drop_decls+'\n#pragma pack(pop)\n}\n'
dungeon_enum=re.search(r'enum\s*\{\s*DUNGEON_INFO_SUB_HEADER_OPEN.*?\};',packet,re.S)
assert dungeon_enum
dungeon_decls='\n'.join(decl(packet,name) for name in ('packet_send_dungeon_info_system','SFDateInfoPacket','SFDateRanking','SFDateMision','SPacketGCDungeonInfoReceive'))
text+='namespace ava2_windows_dungeon {using BYTE=std::uint8_t;using DWORD=std::uint32_t;constexpr BYTE HEADER_GC_DUNGEON_INFO_SYSTEM=217;\n'+dungeon_enum.group()+'\n#pragma pack(push,1)\n'+dungeon_decls+'\n#pragma pack(pop)\n}\n'
switch=(root/'upstream/ava2-client/UserInterface/PythonSwitchbot.h').read_text(errors='replace')
switch_decls=[]
for name in ('TSwitchbotAttributeAlternativeTable','TSwitchbotTable','TSwitchbottAttributeTable'):
found=re.search(r'struct '+name+r'\s*\{.*?\};',switch,re.S)
assert found,name
switch_decls.append(found.group().replace('long','std::int32_t'))
for name in ('TPacketCGSwitchbot','TPacketGCSwitchbot','TSwitchbotUpdateItem'):
found=re.search(r'struct '+name+r'\s*\{.*?\};',packet,re.S)
assert found,name
switch_decls.append(found.group().replace('long','std::int32_t'))
switch_enums='\n'.join(re.search(r'enum '+name+r'\s*\{.*?\};',source,re.S).group() for source,name in ((game,'ESwitchbotValues'),(game,'EAttributeSet'),(packet,'ECGSwitchbotSubheader'),(packet,'EGCSwitchbotSubheader')))
text+='namespace ava2_windows_switchbot {using BYTE=std::uint8_t;using DWORD=std::uint32_t;using WORD=std::uint16_t;using TPlayerItemAttribute=ava2_windows_item::TPlayerItemAttribute;constexpr int ITEM_SOCKET_SLOT_MAX_NUM=8,ITEM_ATTRIBUTE_SLOT_MAX_NUM=15;\n'+switch_enums+'\n#pragma pack(push,1)\n'+'\n'.join(switch_decls)+'\n#pragma pack(pop)\n}\n'
ishop_enum=re.search(r'enum\s*\{\s*ITEMSHOP_LOAD.*?\};',packet,re.S)
assert ishop_enum
ishop_decls='\n'.join(decl(packet,name) for name in ('SIShopData','SIShopLogData','SPacketGCItemShop'))
text+='namespace ava2_windows_itemshop {using BYTE=std::uint8_t;using DWORD=std::uint32_t;constexpr int CHARACTER_NAME_MAX_LEN=24;\n'+ishop_enum.group()+'\n#pragma pack(push,1)\n'+ishop_decls+'\n#pragma pack(pop)\n}\n'
offline_enum=re.search(r'enum EPacketShopSubHeaders\s*\{.*?\};',packet,re.S)
assert offline_enum
offline_decls='\n'.join(decl(packet,name) for name in ('packet_shop','ShopLog','SShopDecoration','SOfflineShopItemTable','SPacketCGMyOfflineShop','packet_offline_shop_start','packet_offline_shop_update_item'))
text+='namespace ava2_windows_offline_shop {using BYTE=std::uint8_t;using WORD=std::uint16_t;using DWORD=std::uint32_t;using TItemPos=ava2_windows_item::TItemPos;using TOfflineShopItemData=ava2_windows_search::TOfflineShopItemData;constexpr int CHARACTER_NAME_MAX_LEN=24,SHOP_SIGN_MAX_LEN=45,OFFLINE_SHOP_HOST_ITEM_MAX_NUM=80;\n'+offline_enum.group()+'\n#pragma pack(push,1)\n'+offline_decls+'\n#pragma pack(pop)\n}\n'
python_item=(root/'upstream/ava2-client/UserInterface/PythonItem.h').read_text(errors='replace')
sound_enums='\n'.join(re.search(r'enum\s*\{\s*'+start+r'.*?\};',python_item,re.S).group() for start in ('USESOUND_NONE','DROPSOUND_DEFAULT'))
text+='namespace ava2_windows_item_sound {\n'+sound_enums+'\n}\n'
out=Path(sys.argv[1]);out.parent.mkdir(parents=True,exist_ok=True);out.write_text(text)