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 加载器： 0.14.0+
Fabric API： 0.87.0+

Forge 加载器： 47.0.0+

Quilt 加载器： 0.20.2+
Quilted Fabric API： 7.1.2+

功能

保护（客户端/服务端）

你的宠物受到保护，免受来自你、你的朋友或环境的各种伤害来源。

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

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

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

环境（仅服务端）

出于平衡原因默认禁用。可以启用以下选项来保护你的宠物免受其伤害：

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

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

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

服务端

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

客户端

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

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

同一原版队伍中且禁用友军伤害的玩家无法伤害彼此的宠物。出于平衡原因和客户端 bug，默认禁用。

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

复活（仅服务端）

当你的宠物死亡时，它会掉落一张便条。然后你可以手持这张便条，右键点击铜块或其他你配置的方块来复活宠物。该方块将被消耗，宠物将重新生成！再也不用想念你的朋友了！

转移宠物（仅服务端）

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

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

取消驯服（仅服务端）

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

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

攻击时按住 Shift 键或你配置的按键，可以绕过客户端保护并伤害宠物。我不太确定你为什么想这么做，不过还是提供了这个功能，以备不时之需。

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

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

此功能默认禁用。你可以将玩家添加到白名单中（白名单的行为方式见相关说明），这样就无法伤害他们或他们的宠物！

注意：由于此功能会改变服务器上的 PvP 机制，你可能因此被封禁。请谨慎使用。

配置

该模组提供了丰富的配置选项，你可以启用或禁用各项功能，以满足自己的游玩需求。

配置文件采用 JSON 格式。请查看 CONFIG.md，其中有带注释的示例。

API（面向开发者）

该模组在程序设计方面提供了高度可配置性，方便其他模组调整或扩展其行为。

你可以使用多种方法和接口，轻松添加新的环境保护规则、受保护的实体类型，甚至自定义保护逻辑（适用于阵营类及类似模组）。

建议查看源代码寻找灵感。可以重点查看以下部分：

• 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 加载器的支持！

可以加入整合包吗？

当然可以！你完全可以将该模组加入公开或私人整合包，无需注明出处！

我可以在自己的模组中使用它吗？

当然可以！和上面一样！

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

当然没问题！只要不是把整个文件直接复制粘贴就行！如果可以的话，我希望你能注明出处，但这不是必须的。

我需要 Fabric API/Quilted Fabric API 吗？

需要，因为该模组需要它来支持自定义按键绑定。不过，只有使用该模组的 Fabric/Quilt 版本时才需要！

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

即使服务器没有安装该模组，它也能在客户端运行。不过，许多功能将无法使用。它更适合和朋友一起游玩公共原版服务器时使用，避免你们的宠物之间爆发战争。注意：如果你在公共服务器上使用该模组而遭到封禁，我们概不负责。

不过，如果服务器安装了该模组，玩家就无需安装，也能使用全部功能。

祝你玩得开心！

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

只有在服务器没有安装该模组，或游玩单人游戏/LAN 时才需要。更多信息请见上文。

这个模组支持 LAN 多人游戏吗？

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

我有问题或发现了一个 Bug。

欢迎在下方留言提问。不过，如果你要报告 Bug，我更希望你能在 GitLab 仓库中提交！谢谢！

我有建议，或者想添加某个功能！

和上面一样，欢迎留言提出！即使出于平衡性考虑，我可能不赞同某些建议（例如环境保护），也会尽力添加。我希望这个模组能满足你的需求，即使需求比较小众。因此，该功能可能默认在配置中禁用，但你随时可以启用！