胸腔DNA

箱子DNA

记录每个物品的来源，并在物品提示框中显示。

打开一个箱子，你得到的战利品没有任何故事。箱子DNA解决了这个问题：物品诞生的那一刻，它就被打上了来源印记，这个印记会伴随该物品的一生。

---

它的作用

每当一个物品进入世界——从箱子中搜刮、被生物掉落、与村民交易、钓鱼获得、合成、熔炼或开采——箱子DNA都会为其附加一个来源，其中包含：

• 来源 - 村庄、地牢、末地城、远古城市、生物、交易、工作台……
• 详情 - 它生成所依据的战利品表，或者掉落它的实体
• 生物群系和维度
• 坐标 精确位置
• 结构 它被发现时所在的结构（如果有）
• 获得者 按名字记录谁获得了它

这些都存储为真实的数据组件，因此可以跨世界存档、潜影盒、末影箱和多人游戏保留——并且可以被命令、数据包和其他模组读取。

显示效果

悬停物品时，会在普通提示框下方绘制一张像素艺术卡片。它不使用纹理，逐像素绘制，在任何GUI缩放比例下都能保持清晰：

• 顶部显示来源名称，下方标注等级
• 边框颜色根据稀有度变化——灰色代表村庄箱子，金色并带有闪烁光芒像素环绕边框的则代表末地城、远古城市或险恶宝库
• 左侧边缘有一条动画DNA螺旋
• 默认显示一眼摘要；按住Shift可查看生物群系、维度、坐标和发现者
• 仅高级提示框（F3+H）会显示ID，与原版行为一致

卡片会根据屏幕自动调整大小：长文本会换行，不会超出必要尺寸，并且会报告其真实大小，确保提示框始终在屏幕内。

它能识别的来源

分组	涵盖范围
结构箱子	村庄、地牢、废弃矿井、要塞、下界要塞、堡垒遗迹、末地城、远古城市、林地府邸、试炼密室、险恶宝库、沉船、埋藏的宝藏、沙漠神殿、丛林神庙、雪屋、废弃传送门、掠夺者前哨站、海底废墟、奖励箱
生物	生物掉落、Boss掉落、剪刀修剪、猫和嗅探兽的礼物、村庄英雄
玩家行为	合成、熔炼、村民和流浪商人交易、钓鱼、考古、创造模式物品栏
开采	你破坏的每一个方块

总共36种来源类型，每种都有自己独特的名称、图标和稀有度等级。

它不会妨碍你

• 堆叠规则不变。 两个仅DNA不同的物品仍然可以像原版一样正常堆叠，搜刮来的圆石不会碎片化你的背包。
• 首次来源优先。 物品在创建时会被标记一次，之后永远不会被覆盖。
• 性能开销低。 每个生成的物品仅写入一次组件；开采方块时会跳过结构查询，因此破坏方块几乎没有任何可感知的性能消耗。
• 可配置。 每个来源分组都可以单独关闭，如果不希望记录坐标、生物群系、结构或玩家名，也可以将其关闭。

命令

• /chestdna inspect - 打印手中物品的完整DNA信息
• /chestdna clear - 清除手持物品的DNA（需要游戏管理员权限）

面向模组作者

整个系统是一个开放的API——有关代码示例，请参阅README：

• 注册你自己的来源类型，包括图标、颜色和等级
• 声明你自己的战利品表，或覆盖箱子DNA对原版战利品表的描述
• 在印记写入前重写或否决它，或监听印记的生成
• 向卡片添加内容行，或完全替换其主题
• 提供一个 chestdna 入口点，以便你的附属模组在正确的时机加载

环境要求

Minecraft 26.2 - Fabric Loader 0.19.3+ - Fabric API - Java 25。

箱子DNA可以安装在客户端或服务端，且绝不会阻止连接。服务端负责记录，客户端负责显示，因此你获得的功能取决于它安装在哪里：

安装方式	效果
单人游戏	一切正常，内置服务端会进行记录。
客户端和服务端	一切正常。
仅客户端，服务端未安装模组	你可以正常加入游戏。 已针对纯净原版26.2专用服务端测试：客户端可以正常连接并游戏，无任何错误。不过，由于记录功能在服务端，因此不会记录任何内容，也不会显示卡片。
仅服务端	会记录来源，且 /chestdna inspect 命令可用。玩家需要安装模组才能查看卡片，因此请将其设为可选项或提供给玩家。

客户端可选，服务端可选，两端都安装则效果最佳。