Files
metin2-server/docs/FEATURE-AVA2-CHEST.md
T

17 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# AVA2 原生批量开箱
2026-10-18:测试服接入;正式服未部署。客户端完整记录见 metin2-client/docs/AVA2-CHEST-PICKUP.md。
来源:AVA2 FILES+SRC.tgz 的 game/src/char_item.cpp,ENABLE_MULTI_CHEST 的 OpenChest、GiveItemFromSpecialItemGroupNew、AutoGiveItemChest;cmd_general.cpp 的 chest_drop 和 chestdrop;GC66 DWORD 长度预览布局。
- 原生入口 `/chest_drop <window> <cell> <count>`,仅普通背包合法格,最多 1000、且只消费该格当前数量。原始基础物品封包仍是 BYTE 数量,单堆仍为 200,没有扩大成 1000。
- 独立批量发奖,不再逐次 UseItem。保留特殊组金币/经验/异常效果及批次堆叠、延后更新/任务拾取回调。`/mt_chest` 保留为旧端兼容。
- 交易、锁定、装备、死亡/观察/传送、商店/仓库/合成等状态拒绝;保留基础服等级、竞技场与龙魂资格检查。新堆与已有堆都检查孔值后合并。
- 适配当前 200 堆叠:大数量奖励分堆,非堆叠逐个创建,MAKECOUNT 的最小量不会使剩余计数下溢;提示汇报实际创建数量。背包不足延续 AVA2 部分成功消耗语义,不把物品掉在地上。
- `/chestdrop <vnum>` 只查询有效宝箱组。GC66 帧有 8190 行/65535 字节边界;客户端校验实际长度。
- 物品 CItem 延后更新标志在 Initialize 重置。Makefile 为新 include 添加显式依赖,避免旧 Depend 漏编。
验证:`python3 tests/features/test_ava2_chest.py` 编译并执行真实 include;覆盖余量、合并、孔隔离、满包、状态、等级/龙魂、450 个奖励拆堆、非堆叠及 MAKECOUNT。另保留原 `/mt_chest` 测试。FreeBSD 隔离编译通过;普通 QA 在 sbtest 的真实窗口滑块开启 5 个,背包回调整叠开启其余 15 个。物理按键和 Android 真机仍未验收。
测试构建与原型备份在 /root/deploy-features/20261018-ava2-parity。回退:停止 sbtest,恢复 backup-pickup-proto 中 conf/db 两套原型(70002),game 链接恢复 sbtest/game.ava2-stones,重启测试 db/auth/channel5。没有操作正式服 share/bin/game。