Project: Save the Pets! - 拯救宠物！

项目：拯救宠物！

版本： 4.0.1-alpha

许可证： Apache-2.0

客户端/服务器端： 皆可（客户端功能有限）

Forge/Fabric/Quilt： 皆支持

贡献者： Sisby folk (they/them)

保护你的宠物免受自己、朋友和环境的伤害，同时给它们第二次生命的机会！

可在客户端（功能有限）或服务器端运行（单人游戏视为两者兼具）。与大多数模组不同，本模组可在任意一端独立运行。若安装在服务器端，所有客户端将获得服务器端功能。若安装在客户端，你可以无碍地加入原版服务器。

Forge、Fabric 和 Quilt 版本功能与配置文件相同，且可互相兼容（例如：原版/Forge 服务器与 Fabric/原版客户端）。

依赖项

Minecraft 1.20.0+

Java 版本： 19+

Fabric Loader： 0.14.0+

Fabric API： 0.87.0+

Forge Loader： 47.0.0+

Quilt Loader： 0.20.2+

Quilted Fabric API： 7.1.2+

功能

保护（客户端/服务器端）

你的宠物将受到保护，免受由你、朋友或环境造成的各种伤害。

由朋友或你造成的伤害（客户端/服务器端）

可防止你或朋友造成的伤害。默认启用以下伤害来源：

• 直接伤害（客户端或服务器端）
• 爆炸（仅服务器端）
• 弹射物（仅服务器端）
• 横扫攻击（仅服务器端）

环境伤害（仅服务器端）

出于平衡考虑默认禁用。可启用以下选项以保护宠物免受：

• 爆炸
• 甜浆果丛
• 火焰/熔岩
• 细雪冻结
• 溺水

白名单（客户端/服务器端）

你可以将应受模组保护的朋友加入白名单。只需提供用户名或账户 UUID，其他值将自动生成。服务器端与客户端的行为有所不同。

服务器端

加入白名单的用户将受到保护，免受所有玩家的伤害。

客户端

主人位于白名单中的实体将受到保护，免受你造成的伤害（受客户端功能限制）。

原版队伍（客户端/服务器端）

若同一原版队伍中的玩家已禁用友军伤害，则无法伤害彼此的宠物。出于平衡考虑及客户端 Bug，此功能默认禁用。

注意： 客户端实现可能导致游戏冻结几秒，因为原版队伍使用用户名而非 UUID。

复活（仅服务器端）

宠物死亡时会掉落一张便签。手持便签右键点击铜块或其他已配置的方块，即可复活宠物。方块将被消耗，宠物将重生！不再为失去朋友而难过！

转移宠物（仅服务器端）

手持木棍或其他已配置的物品，潜行并右键点击宠物，即可获得其所有权。

但此功能默认禁用，且服务器白名单中的用户受到保护。你只能转移与你被视为朋友的宠物（同一原版队伍或 PvP 已禁用）。

解除驯服（仅服务器端）

不想要宠物了或想送给别人？可潜行并使用剪刀或其他已配置的物品来移除所有权。

伤害你的宠物（仅客户端）

按住 Shift 键或你配置的按键进行攻击，将绕过客户端保护并伤害宠物。我不确定你为何想这样做，但功能在此，以防万一。

注意： 若服务器安装了本模组，此功能将被移除。

玩家保护（客户端/服务器端）

默认禁用，你可将玩家加入白名单（见白名单行为说明），从而无法伤害他们或他们的宠物！

注意： 此功能可能因改变服务器中的 PvP 机制而导致封禁。请谨慎使用。

配置

本模组高度可配置，提供多种选项以禁用或启用功能，适应玩家想要的体验。

配置文件基于 JSON。请参阅文件 [CONFIG.md]() 查看带注释的示例。

API（面向开发者）

本模组设计为在编程层面高度可配置，允许其他模组调整或添加行为。

提供多种方法和接口，便于添加新的环境伤害保护、新的受保护实体类型，甚至处理保护逻辑（适用于 Factions 等类似模组）。

建议查看源代码以获取灵感。主要可查看的区域包括：

• dcp.mc.projectsavethepets.ProjectSaveThePets - 主实例和逻辑处理器
• dcp.mc.projectsavethepets.apis.* - 包含模组使用的接口
• dcp.mc.projectsavethepets.blockers.* - 防止友军伤害的代码
• dcp.mc.projectsavethepets.entities.* - 受保护的实体
• dcp.mc.projectsavethepets.mixins.* - 用于防止伤害来源
• dcp.mc.projectsavethepets.notes.* - 复活便签的 NBT 处理器

常见问题

支持 Forge 吗？

已完成！我还更新了以包含 Quilt Loader！

模组包？

尽管使用！你完全有权将本模组加入公开或私有的模组包。无需注明出处！

我能将此用于我的模组吗？

当然可以！同上！

嘿！我看了你的代码，想借用一段！

没问题，我不介意！只要不是整篇文件的明显复制粘贴！如果可能的话希望提及我，但非必需。

需要 Fabric API/Quilted Fabric API 吗？

是的，因为模组需要它们来实现自定义按键绑定。但仅在使用 Fabric/Quilt 版本时需要！

这是客户端还是服务器端模组？

它可在客户端运行而无需服务器安装。但许多功能将缺失。这对于在公开的原版服务器上与朋友游玩更有用，以免宠物间引发战争。注意： 我们不承担因在公开服务器使用本模组而导致的封禁责任。

然而，若服务器安装了本模组，所有玩家无需安装即可获得全部功能。

玩得开心！

我的客户端需要这个模组吗？

仅适用于未安装本模组的服务器以及单人游戏/局域网！更多信息见上文。

局域网多人游戏支持这个模组吗？

支持！只要主持游戏的人安装了模组，所有人都能使用全部功能！

我有问题或发现了 Bug。

欢迎在下方评论提问，但我更希望你将 Bug 报告提交到 GitLab 仓库！谢谢！

我有建议或想添加功能！

同上，欢迎评论！我会尽力添加，即使我出于平衡原因不同意（例如环境伤害保护）。我认为模组应满足你的需求，即使它很特殊。所以它可能在配置中默认禁用，但你随时可以启用！