你好!
当我玩 Minecraft 时,我发现聊天界面停留在 2011 年的水平:与游戏的复杂性相比,它极其基础。当我寻找模组来修复这一问题时,我只找到了一些轻量且相当无用的模组,它们迫使我安装另外 5 个模组,并为了兼容性从我的整合包中移除 7 个;或者是一些庞大到令人望而生畏的单体模组,需要花费 2 小时才能理解并配置。因此,我决定开发这个模组,以弥补原版 Minecraft 聊天中缺失的功能。SAKChat 是一个模块化、轻量级的客户端 Fabric 模组,旨在过滤、个性化和自动化聊天。
它完全可通过游戏内 GUI(使用 ModMenu 或 /sakchat gui)或直接编辑 JSON 文件进行配置。(温馨提示:如果破坏了 JSON 语法,模组会安全地将文件重置为默认值,请小心操作!)。希望你喜欢它!:D
由于它是 100% 客户端模组,因此可以在任何地方运行:单人游戏、多人游戏以及 Realms。服务器甚至不会知道你正在运行它。
该模组绝不会在未经授权的情况下存储数据,也不会向开发者或第三方发送个人数据。
需要 Fabric API 和 Cloth Config API
模式与模块
触发器 (Triggers)
对特定聊天关键词或正则表达式的反应。
支持正则表达式/文本,区分大小写/不区分大小写
动作:
- 声音警报
- 消息高亮
- 快捷栏 HUD 弹窗
- Toast 通知
黑名单
防止聊天刷屏的冷却时间
匹配时可选项自动运行快捷键
快捷键 (Shortcuts)
即时发送命令或文本。
支持按键绑定和占位符
可选参数位置通过 % 定义(额外参数追加到末尾)
翻译 (Translations)
使用 API 提供程序(Google 或自定义)自动翻译聊天消息。
占位符 (Placeholders)
实时获取游戏数据并将其注入消息或快捷键中。
玩家数据:生命值、饥饿值、护甲、精确坐标和朝向
技术信息:服务器 IP、FPS、操作系统和内存使用情况
与快捷键集成
聊天记录器 (Chat Recorder)
按世界/服务器记录原始、未经过滤的聊天记录,保存在 minecraft/sakchat/records/ 下,格式为两种:txt(用于快速简便使用)和 jsonl(在此保存带有颜色和图形细节的消息,你可以在游戏中使用 /sakchat display 打开它)
反人肉搜索 & 防泄露 (Anti-Doxxing & Anti-Leak)
屏蔽传入/传出文本中的电子邮件、IP 地址、电话号码和坐标
对于传出的文本,你可以通过在消息开头输入 #leak# 一次性绕过此限制
主播模式 (Streamer Mode)
用户名掩码(不会阻止触发器因你的用户名而被激活)
静音聊天 (Mute Chat)
启用时完全隐藏聊天
这不会阻止其他模块正常工作
将阻止发送消息(非命令)
消息是如何处理的?
传入文本
聊天数据包 -> 静音聊天 -> 记录引擎 -> 主播模式 -> 反人肉搜索 -> 触发引擎 -> 动作 [声音警报 -> HUD 弹窗 -> Toast -> 快捷键 -> 黑名单 -> 高亮] -> 聊天
传出文本
聊天 -> 静音聊天* -> 防泄露 -> 占位符引擎 -> 快捷键 -> 聊天数据包
*对于传出文本,如果启用,静音聊天会阻止发送消息但允许发送命令
当传入消息被修改时,你仍然可以通过悬停在 [⏎] 前缀上、读取 .txt 记录或使用 /sakchat display 查看格式化的 .jsonl 来查看原始消息
配置文件
所有内容都位于 .minecraft/config/sakchat/ 中:
- triggers.json
- shortcuts.json
- config.json
正则表达式模式的编译以及配置的加载/保存是在游戏加载或配置文件编辑时异步执行的,因此你不会遇到任何游戏卡顿
重要命令
/sakchat help — 显示命令列表
/sakchat gui — 直接打开配置设置
/sakchat save — 强制将当前设置保存到磁盘
/sakchat display [可选:相对于 minecraft/sakchat/records/ 的路径] — 显示游戏内聊天的格式化记录(如果未提供路径,则打开最后一个),必须启用聊天记录器!
/sakchat reload — 强制模组从磁盘重新导入文件(仅在开发模式下可用)
/sakchat modes <mode> toggle <true/false> — 开启或关闭模式
/sakchat modules <module> toggle <true/false> — 开启或关闭模块
/sc <id> [args...] — 立即运行自定义快捷键
发现 bug?你觉得我漏掉了什么功能?不要害羞,在 GitHub 上提交一个 Issue,我会尽快回复!
Hi!
When I play Minecraft I find the chat stuck in 2011: extremely basic compared to the complexity of the game, and when I look for mods to fix that, I only find light and quite useless mods that force me to install 5 more and remove 7 from my modpack for incompatibility, or a few monstrously monolithic mods that require 2 hours to understand and configure, so I decided to develop this mod to add the features that I feel are missing in Minecraft Vanilla Chat, SAKChat is a modular, lightweight client-side Fabric mod built to filter, personalize and automate chat.
It's fully configurable using the in-game GUI (using ModMenu or /sakchat gui) or by editing the JSON files directly. (Just a heads-up: if you break the JSON syntax, the mod will safely reset the file to default, so be careful!). Hope you like it! :D
Since it's 100% client-side, it works everywhere: singleplayer, multiplayer and Realms. Servers won't even know you're running it.
This mod never stores without permission or sends personal data to the developer or third parties.
Fabric API and Cloth Config API are required
Modes and Modules
Triggers
Reactions to specific chat keywords or regular expressions.
Supports regex/text, case-sensitive/insensitive
Actions:
- Sound alert
- message highlight
- hotbar HUD popups
- toast notifications
blacklist
Cooldowns to prevent chat spam
Optional auto-run shortcuts on match
Shortcuts
Sends commands or text instantly.
Supports keybinding and placeholders
Optional arguments positions are defined via % (extra arguments append to the end)
Translations
Automatically translates chat messages using an API Provider (google or custom one).
Placeholders
Gets data from the game in real time and injects it in messages or shortcuts.
Player Data: Health, hunger, armor, exact coordinates and facing direction
Technical Info: Server IP, FPS, OS and RAM usage
Shortcuts integration
Chat Recorder
Logs raw, unfiltered chat history by world/server into minecraft/sakchat/records/ in two formats: txt (for quick and easy use) and jsonl (here are saved the messages with their color and graphic details, you can open it in game with /sakchat display)
Anti-Doxxing & Anti-Leak
Blocks emails, IPs, phone numbers and coordinates in incoming/outgoing text
For outgoing texts you can one-time bypass it by beginning your message with #leak#
Streamer Mode
Username masking (does not prevent triggers with your username from being activated)
Mute Chat
Completely hide chat when enabled
This does not prevent the other modules from working normally
Sending messages (not commands) will be prevented
How are messages processed?
Incoming Text
Chat Packet -> Mute Chat -> Record Engine -> Streamer Mode -> Anti-Doxxing -> Trigger Engine -> Actions [Sound Alert -> HUD Popup -> Toast -> shortcut -> blacklist -> highlight] -> Chat
Outgoing Text
Chat -> Mute Chat* -> Anti-Leak -> Placeholder Engine -> Shortcut -> Chat Packet
*For outgoing texts, Mute chat prevents sending messages if enabled but allows sending commands
When incoming messages are modified you can still view the original messages by hovering the [⏎] prefix, reading the .txt record or the formatted .jsonl with /sakchat display
Configuration Files
Everything lives inside .minecraft/config/sakchat/:
- triggers.json
- shortcuts.json
- config.json
The regex patterns compiling and the config loading/saving is executed asynchronously when the game loads or configs are edited, so you won't experience any gameplay stutters
Important Commands
/sakchat help — Shows the list of commands
/sakchat gui — Opens the configuration settings directly
/sakchat save — Forces the current settings to save to your disk
/sakchat display [optional: path relative to minecraft/sakchat/records] — display a formatted record of in-game chat (if no path is provided it opens the last one), chat recorder has to be enabled!
/sakchat reload — Forces the mod to re-import files from your disk (only available in dev mode)
/sakchat modes <mode> toggle <true/false> — toggle modes on and off
/sakchat modules <module> toggle <true/false> — toggle modules on and off
/sc <id> [args...] — Runs a custom shortcut instantly
Found a bug? Do you think I'm missing a feature? Don't be shy and open an issue on GitHub, I'll respond as soon as possible!
评论 0
登录后参与评分
还没有评论,来抢沙发吧