Don’t Hurt Them

Don’t Hurt Them

记录专属友谊相册，保护朋友免受玩家造成的伤害。

安装

在客户端和服务器上都安装对应的 JAR 文件。

友谊相册

合成一本 友谊证明，需要两份红石粉、两颗铁粒、一颗青金石和三颗金粒。也可以在创造模式的“工具与实用物品”分类中找到：

R R
ILI
GGG

R：红石粉 · I：铁粒 · L：青金石 · G：金粒。

• 将它拿在任意一只手中，潜行并右键即可打开自己的相册。
• 不潜行时右键点击实体，即可添加或移除该个体。
• 输入精确的 namespace:path 实体注册 ID，即可保护所有该类型的实体。紧凑输入框会在输入时预览已注册的 ID；使用方向键或滚轮选择，按 Tab/Shift+Tab 补全或切换，或点击候选项。按 Enter 会先补全部分 ID，再按一次即可添加完整类型。Java 继承关系和注册名称前缀不决定实体是否属于该类型。
• 点击星标可置顶条目；点击 × 可将其移除。置顶条目优先显示，其后是个体再到类型，最后按注册 ID、名称和 UUID 的字典序排列。
• “个体”和“实体类型”按钮可分别启用对应类别。“收藏”是额外筛选项，默认关闭。已记录的朋友死亡后会显示“已死亡”；启用此项后，只显示已记录的死亡实体。
• 相册页面可显示 2、4 或 8 张卡片，默认显示 4 张。“每页卡片数”按钮可循环切换设置，并将设置保存到 config/dont_hurt_them/dont_hurt_them-client.toml（cardsPerPage）。卡片、字体和控件大小会根据所选密度与 GUI 缩放比例自动调整。
• 将鼠标悬停在卡片上，可查看友谊持续时间（游戏日，精确到小数点后一位）和个体的 UUID。点击已加载且存活的个体名称，即可使用命名牌的命名及保存机制为其改名。
• 拿着相册时，个体朋友会显示绿色轮廓，类型朋友会显示蓝色轮廓；轮廓可穿墙显示。绿色优先。
• 拿着相册时，朋友的名字也会在正常名牌渲染范围内显示。

每张卡片都会显示实体肖像。被追踪的个体若当前已加载到客户端，将使用其实时实体外观；否则相册会使用默认模型。服务器已加载的个体会显示当前生命值和坐标；同维度条目还会显示距离。未加载或缺失的实体仍会保留在相册中，并明确标记为不可用。打开相册不会加载区块。

友谊记录和星标归属于玩家，死亡或重新连接后仍会保留，也不要求持有特定物品。只有可归因于该玩家的伤害会被阻止。其他玩家和自然危害仍可伤害实体。每位玩家最多可保存 256 个条目。

死亡记录与复活

已确认的死亡会保留为灰色个体卡片，并与未加载区块中的实体区分开来。服务器会在死亡掉落生成前记录游戏时间、维度、身份、死因，以及实体可序列化的 NBT 状态。卸载或被取消的死亡不会生成死亡记录。

启用作弊（权限等级 2）后，玩家可以运行：

/dht revive <namespace:entity_type> <UUID>

两个参数都只会根据该玩家当前已记录、符合条件的死亡个体友谊自动补全。复活会恢复实体原有的 UUID、维度、位置和已保存的实体状态，包括变种、名称、装备、物品栏、所有权和属性；存活的实体会以满生命值返回，并清除死亡、着火和摔落等临时状态。执行此命令时会加载记录所在的区块。若尸体仍处于加载状态或 UUID 冲突，则无法生成重复实体；请等待尸体消失后重试。恢复失败时，记录会保留。Minecraft 玩家实体使用正常的玩家重生机制，不能通过此命令克隆。

较早添加的条目因未记录最初的加入时间，友谊持续时间未知。此功能加入前发生的死亡无法根据实体缺失情况还原。只有实体 NBT 机制实际保存的状态才能恢复；快照不完整或不可用的实体不会提供复活选项。

保护范围

各平台适配器会拦截近战伤害、归属明确的投射物、TNT/爆炸、驯服生物的攻击、有害状态效果，以及使用 Minecraft 无敌机制的非生物实体。归属明确的投射物会在选择碰撞实体时跳过朋友，继续飞向其他目标或方块，且不会消耗箭的穿透次数。箭和三叉戟仍遵循原本的物品回收和忠诚机制。备用机制会跳过对受保护实体的命中，而不会删除投射物。受保护目标会从玩家造成的爆炸伤害与击退列表中移除。有益效果仍可生效。

玩家与方块的互动和挖掘会在同步方块变化、计划刻、随机刻、流体/火焰蔓延及其生成实体的过程中传递伤害来源。玩家放置的接触类危险（包括熔岩、火焰、仙人掌、岩浆块、水和窒息方块）会保存来源归属。执行机制会保留已断开连接玩家的规则，并应用于可归因于该玩家、仍在场的实体。

没有可观察到的玩家来源时，伤害不一定能与自然伤害区分。任意红石机器、间接地形/摔落陷阱、结交前已施加的效果，以及会丢弃来源归属或直接修改生命值的其他模组，都需要额外集成支持。这些机制并不会让实体免疫所有环境伤害。已测试行为及仍待运行时验证的内容，请参阅 验证。

已内置英语和简体中文翻译。

每个 JAR 都仅对应其文件名中标注的 Minecraft/加载器组合。友谊条目采用带版本号的通用格式，但在不同加载器或 Minecraft 版本之间迁移世界或玩家文件，并非自动支持的迁移功能。

许可证

请参阅 LICENSE.md。