Mirror/Erupe
1
0
Fork 0
mirror of https://github.com/Mezeporta/Erupe.git synced 2026-05-06 14:24:15 +02:00
Code Issues Packages Projects Releases Wiki Activity

feat(savedata): parse zenny/gzenny/CP from ZZ save blob

Browse Source 
Adds read-only parsing for three scalar fields in the ZZ character save
blob: zenny (0xB0), gzenny (0x1FF64) and caravan points (0x212E4). Also
registers an offset for current_equip (0x1F604); extraction deferred
until its length is reverse-engineered. Offsets sourced from
Chakratos/mhf-save-manager and validated against a live HR999 blob.

Scope is intentionally ZZ-only: mhf-save-manager's F5 and G1-G5.2 maps
are not validated against live data, and the dormant pPlaytime vs
item_pouch collision in those versions is not resolved yet. Non-ZZ
modes leave the new pointers unmapped, and the read path is guarded by
`ok && off > 0 && off+size <= len(blob)` so unverified versions cannot
accidentally read from the blob.

Tests cover positive-path roundtrip (including live kirito blob),
regression guards for existing fields, non-ZZ isolation, new-character
skip, and bounds safety against truncated blobs.
This commit is contained in:
Houmgaor
2026-04-17 23:04:30 +02:00
parent 538724e6c9
commit 47277c712d
4 changed files with 312 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
server/channelserver/model_character.go
View File

@@ -28,6 +28,13 @@ const (
pGRP
pKQF
lBookshelfData
// Offsets sourced from Chakratos/mhf-save-manager (ZZ layout), validated
// against live G6-ZZ blobs. F5 / G1-G5.2 values from that project have
// not been verified and are intentionally left unmapped here.
pZenny
pGZenny
pCP
pCurrentEquip
)
// CharacterSaveData holds a character's save data and its parsed fields.
@@ -52,6 +59,9 @@ type CharacterSaveData struct {
HR uint16
GR uint16
KQF []byte
Zenny uint32
GZenny uint32
CP uint32
compSave []byte
decompSave []byte
@@ -74,6 +84,11 @@ func getPointers(mode cfg.Mode) map[SavePointer]int {
pointers[pGardenData] = 142424
pointers[pRP] = 142614
pointers[pKQF] = 146720
// Validated against a live HR999 ZZ save blob (see tests).
pointers[pZenny] = 0xB0
pointers[pGZenny] = 0x1FF64
pointers[pCP] = 0x212E4
pointers[pCurrentEquip] = 0x1F604
case cfg.Z2, cfg.Z1, cfg.G101, cfg.G10, cfg.G91, cfg.G9, cfg.G81, cfg.G8,
cfg.G7, cfg.G61, cfg.G6, cfg.G52, cfg.G51, cfg.G5, cfg.GG, cfg.G32, cfg.G31,
cfg.G3, cfg.G2, cfg.G1:
@@ -174,6 +189,12 @@ const (
saveFieldKQF = 8
saveFieldNameOffset = 88
saveFieldNameLen = 12
saveFieldZenny = 4
saveFieldGZenny = 4
saveFieldCP = 4
// current_equip is a ~2.4KB equipment record; we expose the offset but do
// not extract a fixed-size slice until its exact length is reverse-
// engineered. Leave extraction as a follow-up.
)
func (save *CharacterSaveData) updateStructWithSaveData() {
@@ -213,6 +234,20 @@ func (save *CharacterSaveData) updateStructWithSaveData() {
if save.Mode >= cfg.G10 {
save.KQF = save.decompSave[save.Pointers[pKQF] : save.Pointers[pKQF]+saveFieldKQF]
}
// Read zenny / gzenny / CP only when a pointer is configured for
// the current mode. Unmapped versions (e.g. S6, F4/F5, G1-G5.2)
// leave the pointer at zero; we guard with the ok check and an
// additional offset != 0 check so a bare default map cannot cause
// bogus reads from the blob header.
if off, ok := save.Pointers[pZenny]; ok && off > 0 && off+saveFieldZenny <= len(save.decompSave) {
save.Zenny = binary.LittleEndian.Uint32(save.decompSave[off : off+saveFieldZenny])
}
if off, ok := save.Pointers[pGZenny]; ok && off > 0 && off+saveFieldGZenny <= len(save.decompSave) {
save.GZenny = binary.LittleEndian.Uint32(save.decompSave[off : off+saveFieldGZenny])
}
if off, ok := save.Pointers[pCP]; ok && off > 0 && off+saveFieldCP <= len(save.decompSave) {
save.CP = binary.LittleEndian.Uint32(save.decompSave[off : off+saveFieldCP])
}
}
}
}