猫

🐱 猫咪 – Hytale 的可驯服猫咪伙伴



⚠️ BETA 版本 这是一个测试版本，部分功能仍在完善中。

重要更新说明： 更新前务必从你的模组文件夹中移除所有旧版本的此插件，以避免出现双重保存或服务器启动错误等问题。

📖 概览

猫咪模组为 Hytale 添加了可驯服的猫咪伙伴，包含自然世界生成、基于信任的驯服、性格驱动的情绪，以及舒适的居家功能，如猫床、猫包、玩具和零食。

该模组首先是为那些希望在游戏世界中拥有生动伙伴的玩家打造的，同时它仍提供了足够的系统和精良度，使其在 Hytale 新世界竞赛项目中脱颖而出。

你可以探索野外寻找猫咪，用鱼慢慢赢得它们的信任，给它们起名字，按 F 打开动作轮，并围绕玩耍、睡眠和陪伴构建一个简单的日常居家生活。

🎥 介绍与概览视频

🚀 快速开始

如果你想直接开始与猫咪玩耍，这是最快的路径：

1. 探索世界，在自然生成区域寻找野生猫咪。
2. 带上鱼，小心靠近，多次喂食野生猫咪以获取其信任。
3. 驯服后，空手按 F 抚摸你的猫咪并打开动作轮。
4. 制作猫床、猫包、猫毛线球和猫零食来照顾你的伙伴。
5. 当你需要更直接的行为管理时，可以使用 /cat bed、/cat follow 或 /cat sleep 等命令进行可选的进阶控制。

新手玩家提示

• 鱼可以驯服、治疗和振奋你的猫咪。
• 更好的鱼能提高每次喂食的驯服几率。
• 每只猫咪在被驯服后只属于一个玩家。
• 在创造模式下，启用快速设置中的“允许 NPC 检测”以进行更可靠的互动。

驯服流程还会以一个自定义界面结束，该界面会显示情绪、性格，并允许你立即为新伙伴设置一个真实的名字。

✨ 突出特点

• 猫咪会在多个区域自然生成，而不是感觉像菜单里才有的伙伴。
• 驯服需要随时间建立信任，这使得第一个伙伴感觉是努力得来的。
• 性格、情绪、礼物和需求赋予你的猫咪超越简单跟随行为的生命力。
• 动作轮将大部分互动保留在游戏世界中，并且从第一分钟起就易于学习。
• 像猫床和猫包这样的家居物品使猫咪既能用于冒险，也能用于装饰。

动作轮也是伙伴系统汇聚的地方：你无需离开游戏世界就能看到猫咪的实时状态、性格、礼物数量以及当前的休息、社交和玩耍需求。

🛏️ 猫床展示

猫床不仅仅是装饰品。它既是猫咪的睡眠点，也是一个管理点。

当你使用猫床时，模组会找到范围内最近的床并打开猫床界面。该界面会显示你拥有的猫咪、它们当前的状态以及适合它们的操作：生成、召唤或唤醒。如果猫已经在床上休息，你也可以使用清空床来清除该床附近的睡眠猫咪。

即使猫咪当前已消失、已在世界中或正在睡觉，这使得猫床也很有用。它也与 /cat bed 命令自然搭配，该命令会发送附近驯服的猫咪到最近的可用的床。

猫床界面

猫床界面是模组中最有用的管理工具之一，尤其是当你开始拥有多只处于不同状态的猫咪时。

✅ 当前功能

核心伙伴

• 八种猫咪变体：黑猫、三花猫、灰色虎斑猫、长毛俄罗斯蓝猫、橙色虎斑猫、暹罗猫、燕尾服猫和小猫（实验性）
• 在区域 1-4 中自然生成，分布与环境相关
• 单主人驯服的猫咪，自动生成独特的名字
• 当多只猫咪靠近时有简单的社交和群体行为
• 匹配的声音、动画和多种行为状态

驯服、情绪和性格

• 通过反复喂鱼进行基于信任的驯服
• 驯服成功界面，可即时命名并预览情绪和性格
• 影响幸福感获取方式的性格系统
• 从痛苦到狂喜共五个情绪等级，随时间缓慢衰减
• 由需求驱动的日常行为，休息、社交和玩耍需求随时间影响自主行为
• 快乐的猫咪在被抚摸时偶尔会带来礼物
• 动作轮和 /cat info 显示性格、礼物和当前需求
• 鱼和猫零食可以治疗猫咪并提升幸福感

互动与日常使用

• 空手按 F 打开动作轮 UI，显示实时状态和伙伴信息面板
• 行为包括跟随、坐下、等待、游荡、睡眠、玩耍、搜索和去睡觉
• 直接在自定义 UI 中重命名
• 用于运输驯服猫咪的猫包
• 用于有趣互动的猫毛线球，投掷后可以进行类似寻回的游戏
• 用于床铺分配、召唤、生成、唤醒和状态概览的猫床 UI

持久性与服务器支持

• 通过 /cat despawn 和 /cat spawn 命令进行消失和重新生成
• 猫咪数据持久化存储在 worlds/default/resources/CatsData.json 中
• 可通过权限配置的拥有上限
• 用于常规限制、生成行为和伤害保护的服务器端配置

生成与测试选项

对于正常游戏，自然生成是预期的路径。

其他选项可用于测试、管理员使用或可控设置：

• 使用 /npc spawn Cats_<Breed> 手动生成
• 使用生成蛋如 Egg_Spawner_Cats_Calico

🧶 制作与护理物品

猫包

使用猫包来拾取和运输你驯服的猫咪。

制作配方（农耕台）：

• 2x 木板
• 3x 纤维
• 1x 白色羊毛
• 1x 红色羊毛

用 F 对着驯服的猫咪使用猫包来拾取它。当猫包装有猫咪时，图标会改变，这样你就能一眼看出里面存放着一只猫。再次在地面上使用猫包，可将猫咪释放到新的位置。

猫床

使用猫床作为舒适的休息点和直接访问猫床管理界面的入口。

制作配方（家具台）：

• 4x 木板
• 2x 白色羊毛
• 3x 纤维

放置床并与它互动以打开猫床界面。你也可以使用 /cat bed 命令将附近驯服的猫咪发送到最近的可用的床，并从一个地方管理已消失、睡眠或等待中的猫咪。

猫毛线球

猫毛线球是一个玩具，用于与你驯服的猫咪进行趣味互动和短暂的寻回游戏。

制作配方（农耕台）：

• 2x 纤维

直接对着你的猫咪使用它进行趣味互动，或者投掷它以便附近驯服的猫咪可以追逐并带回来。

猫零食

猫零食比普通鱼能提供更大的幸福感提升，也有助于治疗。

制作配方（农耕台）：

• 1x 鱼
• 1x 纤维

⌨️ 命令

通用命令

• /cat reload - 重新加载所有配置文件，无需重启服务器
• /cat info - 显示详细的猫咪信息
• /cat list - 列出玩家拥有的所有猫咪
• /cat owner - 管理员命令，用于更改所有权
• /cat spawn - 生成一只先前已消失的猫咪
• /cat despawn - 消除一只猫咪并保存其状态

已驯服猫咪命令

命令通过注视你的驯服猫咪或提供其实体 ID 来执行。

• /cat bed - 将猫咪送到最近的可用的猫床
• /cat follow - 让猫咪跟随你
• /cat name <名字> - 设置自定义名字
• /cat play - 启用玩耍行为
• /cat pounce [目标] - 让附近的猫咪扑向一个目标
• /cat release - 将你的猫咪释放回野外
• /cat search - 让猫咪四处游荡和捕猎
• /cat sit - 让猫咪坐下并停留
• /cat sleep - 让猫咪睡觉
• /cat wait - 停止跟随并在原地等待
• /cat wander - 允许自由游荡

⚙️ 配置

配置文件在首次启动时创建于 mods/Cats/ 目录下，可以在服务器运行时编辑：

• general.cfg - 每位玩家的默认猫咪上限，默认为 16
• protection.cfg - 针对主人、其他玩家、生物、环境和弹射物的伤害过滤器
• spawn.cfg - 启用或禁用自然生成并调整生成权重倍数

使用 /cat reload 应用更改，无需重启服务器。

🔐 权限

该插件同时支持 Hytale 的权限系统和 LuckPerms。

玩家默认最多可以拥有 16 只猫咪。管理员可以通过权限如 markusbordihn.cats.limit.8 或 markusbordihn.cats.limit.unlimited 进行调整。

有关详细的权限配置，请参阅 权限文档。

🚧 计划功能

• 猫咪繁殖与幼猫
• 配饰，如项圈和铃铛
• 更多玩具和互动物品
• 更多猫咪变体
• 猫咪进阶与特殊能力

🗃️ 数据存储

猫咪数据会自动保存到 worlds/default/resources/CatsData.json，包括：

• 猫咪 UUID 和主人信息
• 猫咪类型、自定义名字和当前状态
• 最后已知位置和生成状态

如果你想在移动世界或测试更新时保留你的猫咪，请备份此文件。

🐛 已知问题

• 某些动画过渡尚不流畅
• 寻路仍需改进

🔗 相关插件

狗狗伙伴

正在寻找忠诚的战斗伙伴？查看狗狗伙伴插件。 虽然猫咪专注于陪伴、家庭生活和趣味互动，但狗狗伙伴则更多围绕战斗支援、守卫和积极的冒险玩法而设计。

下载狗狗伙伴

---

祝你与新的猫咪伙伴相处愉快。

此插件正在积极开发中。更新与改进会定期添加。