Class PacketHelper

java.lang.Object

tools.packet.PacketHelper

public class PacketHelper
extends Object

跨封包建構器共用的序列化輔助工具集。

本類別提供大量靜態序列化方法，供 tools.packet 套件中各封包建構器複用， 避免重複組裝邏輯，包括：

• 時間戳換算：getTime / getKoreanTimestamp 將 Unix 毫秒轉為客戶端 Windows FILETIME（100 ns 單位），並定義 MAX_TIME、ZERO_TIME、 PERMANENT 等常數。
• 角色完整資訊序列化：addCharacterInfo 寫入外觀、能力值、技能、任務、 冷卻、Buff、寵物等所有子區段，供登入 / 頻道切換封包使用。
• 子區段序列化：addCharLook、addCharStats、addSkillInfo、 addQuestInfo、addCoolDownInfo、addPetItemInfo 等各對應角色資料結構的獨立寫入方法。
• 商店 / 迷你遊戲：addAnnounceBox、addShopInfo（MapleShop）。
• 移動序列：serializeMovementList 序列化 LifeMovementFragment 列表。

組裝寫入目標為 MaplePacketLittleEndianWriter； 讀取道具資訊來自 MapleItemInformationProvider。

Field Summary

Fields

Modifier and Type	Field	Description
static final long	FT_UT_OFFSET
static final long	MAX_TIME
static final long	PERMANENT
static final long	ZERO_TIME

Constructor Summary

Constructors

Constructor	Description
PacketHelper()

Method Summary

Modifier and Type	Method	Description
static void	addAbilityInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addAnnounceBox(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addCharacterInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addCharLook(MaplePacketLittleEndianWriter mplew, MapleCharacterLook chr, boolean mega)
static final void	addCharLook(MaplePacketLittleEndianWriter mplew, MapleCharacterLook chr, boolean mega, boolean isChannelServer)
static final void	addCharStats(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static void	addChosenSkills(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addCoolDownInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static void	addCoreAura(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addExpirationTime(MaplePacketLittleEndianWriter mplew, long time)
static void	addHonorInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addInteraction(MaplePacketLittleEndianWriter mplew, IMaplePlayerShop shop)
static void	addInventoryInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addItemInfo(MaplePacketLittleEndianWriter mplew, Item item)
static final void	addItemInfo(MaplePacketLittleEndianWriter mplew, Item item, MapleCharacter chr)
static void	addItemPosition(MaplePacketLittleEndianWriter mplew, Item item, boolean trade, boolean bagSlot)
static final void	addJaguarInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addMonsterBookInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static void	addPartTimeJob(MaplePacketLittleEndianWriter mplew, PartTimeJob parttime)
static final void	addPetItemInfo(MaplePacketLittleEndianWriter mplew, Item item, MaplePet pet, boolean active)
static void	addQuestInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static void	addRedLeafInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addRingInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addRocksInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static final void	addShopInfo(MaplePacketLittleEndianWriter mplew, MapleShop shop, MapleClient c)
static final void	addShopItemInfo(MaplePacketLittleEndianWriter mplew, MapleShopItem item, MapleShop shop, MapleItemInformationProvider ii, Item i, MapleCharacter chr)
static final void	addSkillInfo(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static void	addStealSkills(MaplePacketLittleEndianWriter mplew, MapleCharacter chr)
static void	addStolenSkills(MaplePacketLittleEndianWriter mplew, MapleCharacter chr, int jobNum, boolean writeJob)
static long	getFileTimestamp(long timeStampinMillis, boolean roundToMinutes)
static final long	getKoreanTimestamp(long realTimestamp)
static final long	getTime(long realTimestamp)
static final void	serializeMovementList(MaplePacketLittleEndianWriter lew, List<LifeMovementFragment> moves)
static <E extends Buffstat> void	writeBuffMask(MaplePacketLittleEndianWriter mplew, Collection<Pair<E,Integer>> statups)
static <E extends Buffstat> void	writeBuffMask(MaplePacketLittleEndianWriter mplew, Map<E,Integer> statups)
static <E extends Buffstat> void	writeMask(MaplePacketLittleEndianWriter mplew, Collection<E> statups)
static <E extends Buffstat> void	writeSingleMask(MaplePacketLittleEndianWriter mplew, E statup)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

FT_UT_OFFSET

public static final long FT_UT_OFFSET

See Also:

• Constant Field Values

MAX_TIME

public static final long MAX_TIME

See Also:

• Constant Field Values

ZERO_TIME

public static final long ZERO_TIME

See Also:

• Constant Field Values

PERMANENT

public static final long PERMANENT

See Also:

• Constant Field Values

Constructor Details

PacketHelper

public PacketHelper()

Method Details

getKoreanTimestamp

public static final long getKoreanTimestamp(long realTimestamp)

getTime

public static final long getTime(long realTimestamp)

getFileTimestamp

public static long getFileTimestamp(long timeStampinMillis,
 boolean roundToMinutes)

addQuestInfo

public static void addQuestInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addSkillInfo

public static final void addSkillInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addCoolDownInfo

public static final void addCoolDownInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addRocksInfo

public static final void addRocksInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addRingInfo

public static final void addRingInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addInventoryInfo

public static void addInventoryInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addCharStats

public static final void addCharStats(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addCharLook

public static final void addCharLook(MaplePacketLittleEndianWriter mplew,
 MapleCharacterLook chr,
 boolean mega)

addCharLook

public static final void addCharLook(MaplePacketLittleEndianWriter mplew,
 MapleCharacterLook chr,
 boolean mega,
 boolean isChannelServer)

addExpirationTime

public static final void addExpirationTime(MaplePacketLittleEndianWriter mplew,
 long time)

addItemPosition

public static void addItemPosition(MaplePacketLittleEndianWriter mplew,
 Item item,
 boolean trade,
 boolean bagSlot)

addItemInfo

public static final void addItemInfo(MaplePacketLittleEndianWriter mplew,
 Item item)

addItemInfo

public static final void addItemInfo(MaplePacketLittleEndianWriter mplew,
 Item item,
 MapleCharacter chr)

serializeMovementList

public static final void serializeMovementList(MaplePacketLittleEndianWriter lew,
 List<LifeMovementFragment> moves)

addAnnounceBox

public static final void addAnnounceBox(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addInteraction

public static final void addInteraction(MaplePacketLittleEndianWriter mplew,
 IMaplePlayerShop shop)

addCharacterInfo

public static final void addCharacterInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addMonsterBookInfo

public static final void addMonsterBookInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addPetItemInfo

public static final void addPetItemInfo(MaplePacketLittleEndianWriter mplew,
 Item item,
 MaplePet pet,
 boolean active)

addShopInfo

public static final void addShopInfo(MaplePacketLittleEndianWriter mplew,
 MapleShop shop,
 MapleClient c)

addShopItemInfo

public static final void addShopItemInfo(MaplePacketLittleEndianWriter mplew,
 MapleShopItem item,
 MapleShop shop,
 MapleItemInformationProvider ii,
 Item i,
 MapleCharacter chr)

addJaguarInfo

public static final void addJaguarInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addStealSkills

public static void addStealSkills(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addStolenSkills

public static void addStolenSkills(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr,
 int jobNum,
 boolean writeJob)

addChosenSkills

public static void addChosenSkills(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addAbilityInfo

public static void addAbilityInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addHonorInfo

public static void addHonorInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addCoreAura

public static void addCoreAura(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addRedLeafInfo

public static void addRedLeafInfo(MaplePacketLittleEndianWriter mplew,
 MapleCharacter chr)

addPartTimeJob

public static void addPartTimeJob(MaplePacketLittleEndianWriter mplew,
 PartTimeJob parttime)

writeSingleMask

public static <E extends Buffstat> void writeSingleMask(MaplePacketLittleEndianWriter mplew,
 E statup)

writeMask

public static <E extends Buffstat> void writeMask(MaplePacketLittleEndianWriter mplew,
 Collection<E> statups)

writeBuffMask

public static <E extends Buffstat> void writeBuffMask(MaplePacketLittleEndianWriter mplew,
 Collection<Pair<E,Integer>> statups)

writeBuffMask

public static <E extends Buffstat> void writeBuffMask(MaplePacketLittleEndianWriter mplew,
 Map<E,Integer> statups)