斯迈利模组

Smily

Smily 是一个陪伴模组。一个住在你的世界里的小小友好面孔， 它会在聊天中和你说说话，并且真的能帮上忙——寻找矿石、递给你物品、 为你治疗，当夜晚安静下来时还会放上一张唱片。

它完全离线运行，无需账号，也无需任何设置。

---

快速开始

当你第一次进入一个世界时，你会收到一个盒子。

把它放下来，退后一步，然后观看：它会升到空中并打开——Smily 就在那里。一本README.txt 会随之掉落在旁边。右键点击该文件，即可像读书一样阅读它。

就这么简单。现在只要站在 Smily 附近，在聊天框中输入文字即可。

---

Smily 能做什么

当 Smily 在 10 格范围内时，在聊天框中正常输入文字：

• 你好 / 你是谁 / 你好吗 —— Smily 会和你聊天
• 治好我 —— 恢复你的生命值
• 最近的钻石在哪里 —— 定位煤、铁、金、青金石、钻石或绿宝石，并告诉坐标
• 给我 32 个火把 —— 递给你几乎任何物品（最多一次 100 个）
• 2 + 2 或 10 * 3 —— Smily 会做数学题
• 播放音乐 / 停止音乐 —— 播放一张唱片
• 对不起 / 谢谢 / 再见 —— Smily 会回应

右键点击 Smily 可以把它捡起来随身携带。

在聊天框中输入 /smilyhelp 可以查看游戏内的完整指令列表。

---

Sadly

Smily 有一个对立面：Sadly —— 蓝色的、安静，而且没心情说话。 你问 Sadly 任何问题，最好的情况也只是耸耸肩。

Sadly 不会在世界中自然生成。你只能在创造模式物品栏中找到它，或者通过召唤获得。它可以像 Smily 一样被捡起和放置。

---

特性

• Smily 和 Sadly 在说话时嘴巴会有动画
• 可选的旁白语音会朗读它们的台词
• Smily 有浅色或深色配色方案可选
• 背景音乐，可通过对话切换
• Smily 会注意周围的世界：生物群系、时间、附近的东西
• 如果 Smily 遭遇不测，它会回来
• 以上所有功能完全离线可用

---

AI 功能（可选，默认关闭）

Smily 可以选择使用 Groq API 来进行真正的对话，代替使用内置回复。这完全是可选的——模组自带的是禁用状态，除非你自己打开，否则它会一直保持禁用。

费用是多少

免费。Groq 提供免费套餐，无需信用卡。

如何设置

1. 前往 console.groq.com 创建一个免费账户
2. 打开 API Keys 部分，创建一个新密钥
3. 在 Minecraft 中，打开 模组 → Smily → 配置
4. 将 AI 聊天 设置为 开启
5. 把你的密钥粘贴到 Groq API 密钥 字段中
6. 点击 完成 并重新进入你的世界

默认模型是 llama-3.1-8b-instant。你可以在同一界面更改它。

免费套餐限制为每分钟 30 次请求，每天 14,400 次，这远远超过单人世界所需。

会发送什么，发到哪里

开启前请仔细阅读：

• 该功能关闭时不会发送任何内容。 AI 禁用时，模组完全不会建立网络连接。
• 请求只发送到一个端点：https://api.groq.com/openai/v1/chat/completions
• 请求包含你输入的讯息以及游戏内上下文，以便回复更合理：你的坐标、生物群系、时间、Smily 附近的方块，以及你的物品栏内容。
• 请求使用你自己的 API 密钥发送。模组不附带任何密钥，作者也不运行任何服务器。
• 没有遥测，也没有分析。 不会向作者或任何第三方发送任何内容，也不会在任何地方存储任何内容。
• 你的 API 密钥只保存在本地配置文件中。切勿分享该文件，也不要截屏展示它。

即使启用了 AI，所有游戏内操作（寻找矿石、给予物品、治疗、音乐）仍然由模组自身的本地逻辑运行。

---

配置

在游戏中打开 模组 → Smily → 配置：

个性化

• Smily 颜色 —— 浅色（黄色）或深色（黑色）
• 语音（旁白） —— 朗读 Smily 的台词

AI

• AI 聊天 —— 开/关总开关
• Groq API 密钥
• 模型

---

鸣谢

音乐： "Kater Street Rag"，由 Bennie Moten 演奏。 公有领域录音，来自 Internet Archive Free 20s Jazz Collection。

灵感： 本模组灵感来自 Verity JE，它让我看到一个单一的伴侣能承载多少个性。Smily 已经发展成自己的样子，但火花来源于那里。

---

版本

适用于 Minecraft 1.12.2 和 1.16.5（Forge）。