鹈鹕聊天

鹈鹕聊天

与Discord连接的聊天扩展功能

PelicanChat (Pelican4Ever.Chat)

为星露谷物语 1.6.15+(SMAPI 4.1.0+)打造的可滚动、带标签页、适配 Discord 的聊天框全面改造。

PelicanChat 将星露谷物语原版聊天框升级为现代多频道聊天界面,支持平滑滚动、未读角标、上下文标签路由以及可选的主机端 Discord 桥接。它在原版/合作游戏中100% 独立运行,并在安装 Pelican 4Ever 时自动与其集成。


主要功能

  • 扩展历史记录与平滑滚动: 每个频道最多保留 200 条消息(可在 10 到 2000 之间配置),而非原版的 10 行限制;高度受限(展开 280px / 收起 140px),支持鼠标滚轮滚动、PageUp/PageDown,以及阅读旧消息时的滚动锁定。
  • 频道标签页与未读角标: 全部、本地(附近 <= 30 格)、全局、Discord、私聊和事件。可通过点击或按 Tab/Shift+Tab 切换标签页。
  • 上下文发送: 在本地或Discord标签页直接输入时,消息会自动路由到对应频道,无需每次都输入 /l 或 /d。
  • 可选 Discord 桥接(仅主机): 专用 Discord 频道,严格进行方括号/标签清理([color]/[emoji] 注入防护),支持回环监听,且不与客户端共享任何机器人令牌/密钥。
  • 独立运行 + Pelican 4Ever 集成:
    • 独立模式: 提供 /l(/local)、/g(/global)、/w(/message 的别名)和 /d(/discord)。
    • 配合 Pelican 4Ever: 通过 SMAPI Mod API 自动挂接,以同步服务器时钟 [HH:mm] 时间戳、避免命令冲突、分类服务器事件并桥接外部聊天。
  • 多语言支持: 包含英语、西班牙语(es)和简体中文(zh-CN)翻译。

前置要求

  • 星露谷物语 1.6.15+
  • SMAPI 4.1.0+

安装

  1. 安装 SMAPI 4.1.0 或更新版本。
  2. 下载 PelicanChat 0.1.0.zip。
  3. 将 PelicanChat 文件夹解压到你的 Stardew Valley/Mods/ 目录中。
  4. 通过 SMAPI 启动游戏。

命令与操作

  • Tab/Shift+Tab(聊天框打开时):在聊天标签页之间循环切换。
  • Mouse Wheel/PageUp/PageDown:滚动浏览聊天历史。
  • /l <message> 或 /local <message>:发送附近聊天消息(独立模式)。
  • /g <message> 或 /global <message>:发送全局聊天消息(独立模式)。
  • /w <player> <message>:发送私聊(独立模式下 /message 的别名)。
  • /d <message> 或 /discord <message>:向桥接的 Discord 频道发送消息。

配置(config.json)

首次启动时自动生成于 Mods/PelicanChat/config.json:

  • Enabled(默认:true)— 启用或禁用本模组的视觉与路由补丁。
  • MaxHistoryPerChannel(默认:200,范围:10–2000)— 每个标签页保留的消息数。
  • MaxVisibleHeight(默认:280,范围:100–800)— 聊天框展开时的视口高度(px)。
  • MaxClosedHeight(默认:140,范围:40–400)— 聊天框收起时的视口高度(px)。
  • ShowTimestamps(默认:true)— 为消息添加 [HH:mm] 前缀。
  • TimestampSource(默认:"Auto")— Auto、ServerClock 或 LocalTime。
  • IncludeDiscordInAllTab(默认:true)— 在全部标签页中显示 Discord 消息。
  • DefaultTab(默认:"All")— 起始标签页(All、Local、Global、Discord、Whisper、System)。
  • ProximityRadius(默认:30.0,范围:1–500)— 独立本地聊天的格数半径。
  • CriticalToastDurationSeconds(默认:15,范围:0–120)— 跨标签页关键事件提示的持续时间。
  • DiscordBridgeEnabled/DiscordWebhookUrl/DiscordInboundPort/DiscordInboundToken/MaxInboundMessageLength— 可选的主机端独立 Discord 桥接设置。

源代码

GitHub: https://github.com/juanlumediterrani/Pelican-Chat