SH的家养动物

《星露谷物语》「Domestic Animals」MOD 使用指南

【核心介绍】
为游戏添加12种可互动的拟真家养动物，作为山谷中的动态装饰与角色伙伴，支持自然游荡、发声与基础互动。

【安装指南】

1. 下载并安装 SMAPI（必需运行环境）：「SMAPI」；
2. 下载本 MOD 文件包，解压后将整个文件夹（含 `manifest.json`）复制至游戏根目录 `/mods` 文件夹；
3. 本 MOD 安装前，需同步安装前置依赖的 MOD：「Content Patcher」（版本 ≥ 1.29）与「Custom Companions」（版本 ≥ 1.8.0）；
4. 若已安装「SVE」或「Free Dusty」，Dusty 狗屋功能将自动禁用（无需手动操作，避免冲突）；
5. 启动游戏前请确认所有文件已正确放置，缺一不可。

【功能详情】
✅ 已优化：

• 添加以下动物及专属行为：「Willy 的棕色猫」、「女巫小屋的黑色猫形史莱姆」、「巫师的绿色小龙」、「查理鸡」、「Abigail 的豚鼠 David（笼子形态随位置切换）」、「Alex 的狗 Dusty（自动适配 SVE/Free Dusty）」、「Emily 的鹦鹉」、「Leah 的兔子」、「Robin 谷仓的罗斯特」、「下水道影子幼犬」、「鹈鹕镇流浪猫」、「流浪狗」；
• 所有动物具备随机游荡、环境遮挡（如躲藏于建筑/灌木后）、基础音效与互动动画；
  ❌ 未修改：
• 动物无养殖、喂养、繁殖、任务触发等玩法系统；
• 不改变原有 NPC 日常行程、对话文本或剧情事件；
  ✨ 额外调整：
• 动物美术风格严格匹配原作像素质感与色彩规范；
• 流浪猫/狗为独立实体，与「Kitty Cats」MOD 兼容（可共存，功能不重叠）。

【使用要求】

• 必须运行 SMAPI 4.7+；
• 游戏本体需为 《星露谷物语》1.6+ 版本；
• 推荐安装「Stardew Valley Expanded（SVE）」以获得更丰富的场景交互支持（非必需，但增强体验）。

【兼容性说明】

• 兼容范围：「SVE」「Kitty Cats」「Seasonal Outfits」「CJB Item Spawner」等主流内容类 MOD；
• 不兼容模组：直接修改 `NPC.cs` 或覆盖 `companions` 文件夹的自定义同伴类 MOD（如旧版非标准 Custom Companions 衍生模组）；
• 暂未推出专用兼容补丁。

【注意事项】

• 动物为纯装饰性存在，不会影响好感度、事件触发或农场评分；
• 少量动物可能因地形碰撞暂时卡入墙体/地板，属视觉异常，不影响游戏进程；
• 若未看到某只动物，请检查是否已进入其生成区域（如女巫小屋、谷仓、下水道等），并等待 1–2 天刷新；
• Dusty 狗屋功能在启用「SVE」或「Free Dusty」时自动关闭——此为设计行为，非 bug。

【更新日志】

• 2024 年 5 月 12 日 新增流浪猫/狗实体，优化遮挡逻辑；
• 2024 年 4 月 3 日 适配「Custom Companions」v1.8.0，修复 David 笼子形态切换异常；
• 2024 年 3 月 1 日 首发正式版，支持全部 12 种动物及基础交互。