doc: inline code documentation.

This commit is contained in:
Houmgaor
2025-11-24 18:41:37 +01:00
parent a992c5a603
commit 64cc285fd8
11 changed files with 697 additions and 181 deletions

View File

@@ -8,14 +8,34 @@ import (
"erupe-ce/network/clientctx"
)
// MsgMhfEnumerateQuest represents the MSG_MHF_ENUMERATE_QUEST
// MsgMhfEnumerateQuest is sent by the client to request a paginated list of available quests.
//
// This packet is used when:
// - Accessing the quest counter/board in town
// - Scrolling through quest lists
// - Switching between quest categories/worlds
//
// The server responds with quest metadata and binary file paths. The client then
// loads quest details from binary files on disk or via MSG_SYS_GET_FILE.
//
// Pagination:
// Quest lists can be very large (hundreds of quests). The client requests quests
// in batches using the Offset field:
// - Offset 0: First batch (quests 0-N)
// - Offset N: Next batch (quests N-2N)
// - Continues until server returns no more quests
//
// World Types:
// - 0: Newbie World (beginner quests)
// - 1: Normal World (standard quests)
// - 2+: Other world categories (events, special quests)
type MsgMhfEnumerateQuest struct {
AckHandle uint32
Unk0 uint8 // Hardcoded 0 in the binary
World uint8
Counter uint16
Offset uint16 // Increments to request following batches of quests
Unk4 uint8 // Hardcoded 0 in the binary
AckHandle uint32 // Response handle for matching server response to request
Unk0 uint8 // Hardcoded 0 in the binary (purpose unknown)
World uint8 // World ID/category to enumerate quests for
Counter uint16 // Client counter for tracking sequential requests
Offset uint16 // Pagination offset - increments by batch size for next page
Unk4 uint8 // Hardcoded 0 in the binary (purpose unknown)
}
// Opcode returns the ID associated with this packet type.