菜单
Reverse-engineered binary schemas for Booth (ItemBooth/PalBooth) and Guild rawdata in palsav. Lock flags, V1_MARKER handling, _u8_flag semantics, and roundtrip rules. Load when touching map_concrete_model.py or group.py decoders, booth/guild lock features, or debugging roundtrip drift.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | pst-binary-schemas |
| description | Reverse-engineered binary schemas for Booth (ItemBooth/PalBooth) and Guild rawdata in palsav. Lock flags, V1_MARKER handling, _u8_flag semantics, and roundtrip rules. Load when touching map_concrete_model.py or group.py decoders, booth/guild lock features, or debugging roundtrip drift. |
src/palsav/palsav/rawdata/map_concrete_model.py)trailing_bytes (20B) -> 3 fieldsRE'd by comparing unlocked vs locked Level.sav byte diffs:
unlocked: 000000000000000000000000 00 0000000
locked: 000000000000000000000000 01 0000000
^^ byte[12]=1
unknown_before_lock (12B): opaque prefixis_private_lock (1B u8): 0=unlocked, 1=locked — THIS controls the lock stateunknown_after_lock (7B): opaque suffixunknown_bytes (236B) -> 3 fieldsunlocked byte[224]: 00
locked byte[224]: 01
unknown_prefix (224B)is_private_lock (1B u8): 0=unlocked, 1=lockedunknown_suffix (11B)private_lock_player_uid is identical (non-zero) in BOTH locked & unlocked. Lock state is NOT that GUID — it's is_private_lock.func_manager.py:748-782)deep_unlock SKIPS both booth typesis_private_lock = 0 on booth RawData dicts directlyprivate_lock_player_uid on booths (game needs it non-zero)src/palsav/palsav/rawdata/group.py)Newer Palworld versions prepend ~480 bytes BEFORE the known V1_MARKER (02 00 00 00 02 03 00 00 00 00) in the guild binary tail. Old code checked post_unk2[:10] == V1_MARKER — missed when marker not at offset 0. try/except silently set players: [].
post_unk2[:10] == V1_MARKER -> post_unk2.find(V1_MARKER) >= 0_pre_v1_bytes for roundtrip_raw_tail fallback uses original_tail (unmodified)_u8_flag Bug (commit 343d5abb)Decoder unconditionally read a _u8_flag byte after each player entry. In pre-V1 format these flag bytes don't exist — byte after each player's fstring is the FIRST byte of the next player's GUID. Caused 1-byte shift per player -> parser overran -> 0 players parsed.
Fix: Changed if not sub.eof(): -> if group_data.get('_has_v1_marker') and not sub.eof():. Encoder already conditional (if '_u8_flag' in p).
_u8_flag values1 = guild master/admin3 = regular member2 = never observedmove_player_to_guild() left stale _u8_flag=1 on moved players -> multiple admins. Fix: reset found['_u8_flag'] = 3 after appending to target guild.
make_member_leader (commit 36522918)Iterates all guild players: _u8_flag=1 on new leader, 3 on everyone else.
To inspect guild binary tail: convert Level.sav to JSON, load with json_tools.load(), search for V1_MARKER in _raw_tail hex. If at offset > 0, guild format was extended.
OpenCode configuration knowledge for this repo — skills setup, plugin wiring, JSONC config format, snapshot system behavior (doesn't track .opencode/), and the diff-logger plugin pattern. Load when editing .opencode/ config, plugins, or troubleshooting opencode behavior.
Game-verified Palworld pal stat calculation formulas (HP/ATK/DEF/WS) in src/palworld_aio/utils.py. Verified against in-game breakdowns on maxed test pals. Load when touching stat calculation, tooltips, or IV/rank/condenser math.
Deep internals of the palsav save serialization engine + palooz Oodle bindings, and exactly how PST (palworld_aio GUI) consumes them. Load when touching any save parse/roundtrip/compression code, debugging roundtrip drift, editing rawdata decoders, or tracing the SAV<->GVAS<->JSON flow.
PalworldSaveTools (PST) architecture map — repo layout, entry chain, the palsav SAV<->GVAS<->JSON pipeline, the palworld_aio GUI structure, game data locations, and the custom pytest dynamic-import registry. Load FIRST whenever working anywhere in this repo so you orient on real structure, not guesses.
The pal editing engine — pal data model (every SaveParameter field with type-wrapper shapes), editing operations, illegal pal detection, pal generation, container/slot model, game data binding, and the PalEditorWidget UI. Previously the monolithic `edit_pals.py` (5454 lines), now a modular `pal_editor/` package (17 modules + backward-compat `edit_pals.py` shim). Load when editing pal logic, stats, skills, IVs, containers, or illegal detection.
The build system (Nuitka primary for CI/release → dist/, cx_Freeze for Windows installer → PST_standalone/), Inno Setup installer, GitHub Actions CI (5 workflows), standalone-mode signaling (runtime.cfg), verify_build checks, and utility scripts (update_game_data ETL, translation automation via Google Translate, theme linter, import validator). Load when building, releasing, or maintaining CI.