Package handling.world

package handling.world
跨伺服器（程序內）協調層：登入／頻道／商城三伺服器之間的玩家狀態交接與群體訊息廣播。

核心為靜態的 World，以巢狀靜態類別 World.Find／World.Broadcast／ World.Party／World.Messenger／World.Guild／World.Alliance／ World.Family 提供查找、廣播與隊伍／信使／公會／聯盟／家族的協調入口；玩家在頻道與 商城之間移動時，透過此層而非重新連線完成切換。

本 package 同時持有跨伺服器共享的角色快照模型：MapleParty／MaplePartyCharacter （隊伍）、MapleMessenger／MapleMessengerCharacter（信使對話），以及 PartyOperation 操作列舉與 CharacterIdChannelPair 等輕量配對。玩家跨頻道交接的 完整狀態由 CharacterTransfer（Externalizable）序列化攜帶，暫存的 buff／冷卻／ 異常狀態則由 PlayerBuffStorage 集中保管，內容物為 PlayerBuffValueHolder。

其餘輔助型別包含外觀快照 MapleCharacterLook、作弊回報資料 CheaterData 與技能 蒐集器 SkillCollector。公會、聯盟、遠征隊與家族的完整資料模型則分屬子套件 handling.world.guild、handling.world.exped 與 handling.world.family。

  • Class
    Description
    CharacterIdChannelPair
    角色 ID 與所在頻道編號的輕量配對值物件。
    CharacterTransfer
    玩家跨頻道或進出現金商城時的角色狀態快照，用於無縫轉移。
    CheaterData
    作弊偵測系統中單一違規紀錄的值物件，封裝違規點數與描述文字。
    MapleCharacterLook
     
    MapleMessenger
    最多三人即時私訊群組（信使）的伺服器端狀態模型。
    MapleMessengerCharacter
    信使群組中單一成員的輕量快照，記錄角色名稱、ID、頻道與上線狀態。
    MapleParty
    組隊的伺服器端狀態模型，管理隊長與最多六名 MaplePartyCharacter 成員。
    MaplePartyCharacter
    組隊成員的輕量快照，記錄角色名稱、ID、等級、職業、地圖、頻道、上線狀態及魔法門座標。
    PartyOperation
    組隊狀態變更的操作類型列舉，用於向客戶端廣播組隊封包時區分事件種類。
    PlayerBuffStorage
    玩家換頻道或進出現金商城期間暫存 buff、冷卻與異常狀態的靜態倉儲。
    PlayerBuffValueHolder
    單一主動 buff 狀態的快照值物件，供跨頻道 buff 保留機制使用。
    SkillCollector
     
    SkillCollector.run
     
    World
    行程內的跨伺服器協調層，以全靜態 API 串接三個 Netty 伺服器與多個頻道。
    World.Alliance
    公會聯盟子系統：集中保管所有 MapleGuildAlliance 並提供聯盟相關操作與封包廣播。
    World.Broadcast
    跨頻道訊息廣播子系統。
    World.Buddy
    好友（Buddy）跨頻道協調子系統。
    World.Family
    家族子系統：集中保管所有 MapleFamily 並提供家族成員與聲望相關操作。
    World.Find
    角色定位子系統：依角色 ID 或名稱查出所在頻道與角色實例。
    World.Guild
    公會（Guild）跨頻道協調子系統。
    World.Messenger
    密語視窗（Maple Messenger）跨頻道協調子系統。
    World.Party
    組隊（Party）與遠征隊（Expedition）跨頻道協調子系統。
    World.Respawn
    負責一組頻道之定時重生／維護的 Runnable 任務。