SOS-Staff
免费、开源的 Paper 支持工单管理系统,配备完整的 Discord 双向桥接功能。
玩家在游戏中打开工单。工作人员从 Discord 管理这些工单。只要工单保持开放状态,实时聊天就会在两个方向上中继消息——无需在 Minecraft 和 Discord 之间来回切换即可获取帮助。
功能
- 两种创建流程 - 预设常见问题列表、自由文本输入(铁砧 GUI 或聊天),或两者兼有,可全局配置并按类别单独配置。
- 防垃圾信息 - 每个玩家最多可打开的工单数量上限以及关闭后的冷却时间均可配置。
- 双向实时聊天 - 玩家的游戏内消息会通过 Webhook 即时中继到其工单的 Discord 频道(包含玩家头像和名字),工作人员的回复也会中继回游戏内。
- 每个工单一个 Discord 频道,位于专用分类下,带有认领/关闭/重新打开/优先级/转录/提醒按钮,以及完全可配置、权限控制的行动按钮(治疗、喂食、强制重连、传送、冻结,或任何原始命令)。
- 游戏内管理面板 (
/sostaff panel) - 分页且可过滤的工单列表,显示玩家头像、状态着色羊毛,点击即可传送并附加聊天。
- 五种同步语言:英语、法语、西班牙语、俄语、德语——对于缺失的任何键值默认回退到英语。
- 热重载 (
/sostaff reload) - 配置文件、语言文件和 Discord 连接均可热重载,不会中断已开放的工单。
- GDPR 工具 -
/sostaff gdpr erase <player> 及可配置的转录保留策略。
- 公共 API 和 Bukkit 事件,供其他插件读取、创建和对工单做出反应。
- 软依赖集成 - PlaceholderAPI、LuckPerms、Vault。
- 兼容 Folia:全程无主线程或区域线程上的阻塞调用,且在 Discord 回调线程中不直接访问 Bukkit。
要求
Paper(或其分支如 Purpur/DivineMC)26.2 或更高版本——这本身需要 Java 25 才能运行。你需要自己的 Discord 机器人应用(免费,设置仅需五分钟——请参阅 Wiki)。
链接
许可证
GPL-3.0 - 100% 免费且开源。不存在也不计划存在许可证密钥、激活机制或高级付费层级。
SOS-Staff
Free, open-source support-ticket management for Paper, with a full bidirectional Discord bridge.
Players open tickets in-game. Staff manage them from Discord. Live chat relays both ways for as
long as the ticket stays open - no server-hopping between Minecraft and Discord to get help.
Features
- Two creation flows - a preset list of common issues, free-form text (anvil GUI or chat), or
both, configurable globally and per category.
- Anti-spam - a configurable cap on open tickets per player and a cooldown after closing one.
- Bidirectional live chat - a player's in-game messages relay instantly to their ticket's
Discord channel via webhook (their skin, their name), and staff replies relay back in-game.
- One Discord channel per ticket, in a dedicated category, with claim/close/reopen/priority/
transcript/ping buttons and fully configurable, permission-gated action buttons (heal, feed,
force-reconnect, teleport, freeze, or any raw command).
- In-game admin panel (
/sostaff panel) - a paginated, filterable ticket list with player
heads, status-colored wool, and click-to-teleport-and-attach-chat.
- Five shipped languages at parity: English, French, Spanish, Russian, German - falling back
to English for any missing key.
- Hot reload (
/sostaff reload) - config, language files, and the Discord connection,
without ever disrupting a ticket already open.
- GDPR tooling -
/sostaff gdpr erase <player> and configurable transcript retention.
- A public API and Bukkit events for other plugins to read, create, and react to tickets.
- Soft-depend integrations - PlaceholderAPI, LuckPerms, Vault.
- Folia-safe throughout: no blocking calls on the main or a region thread, and no direct
Bukkit access from a Discord callback thread.
Requirements
Paper (or a fork such as Purpur/DivineMC) 26.2 or newer - which itself requires Java 25 to
run. A Discord bot application of your own (free, five minutes to set up - see the wiki).
Links
License
GPL-3.0 - 100% free and open source. No license keys, activation, or premium tiers exist or are
planned.
评论 0
登录后参与评分
还没有评论,来抢沙发吧