文本描述
SIR – Simple In-game Receptionist
一款模块化的 Minecraft 助手,集中管理聊天、公告、新手引导和跨平台通信。SIR 配备了丰富的配置工具包,让你无需触碰 Java 代码即可定制玩家看到的每一次交互。
功能亮点
- 模块化架构 – 切换独立的模块,涵盖聊天、加入/退出体验、公告、MOTD(服务器列表显示)、进度以及第三方钩子。
- 深度聊天自定义 – 直接从 YAML 构建频道层级,应用渐变色、表情符号、悬停/点击动作、标签和提及效果。
- 玩家旅程控制 – 打造首次加入流程、出生点传送规则、欢迎/告别消息以及定时无敌窗口。
- 自动化外联 – 调度混合了聊天、动作栏、标题、Boss 条、声音和控制台命令的公告。
- Discord 就绪 – 使用嵌入模板、按事件路由和跨服务器中继,通过 DiscordSRV 或 EssentialsDiscord 镜像活动。
- 登录与隐身感知 – 与主要身份验证和隐身插件协调,使被静音、隐藏或未认证的玩家遵循你的规则。
- Takion 驱动运行时 – Takion 框架已捆绑,提供你依赖的计划任务、文本处理器、渐变和 Boss 条——无需额外下载。
- 实时更新与指标 – 自动更新检查、可选的彩色控制台日志以及 bStats 分析让管理员保持知情。
兼容性矩阵
| 领域 | 详情 |
|---|---|
| Minecraft 服务器 | Spigot/Paper/Folia API 1.13+(在 plugin.yml 中启用 Folia 标志)。 |
| Java 运行时 | 构建时使用 Maven 编译为 Java 8 目标(支持 Java 21 工具链)。 |
| 权限 | Vault 驱动的聊天适配器,在缺少 Vault 时自动回退。 |
| 占位符支持 | 包含 PlaceholderAPI 扩展;消息、公告和 Discord 桥接中的格式均尊重 PAPI 占位符。 |
| 文本效果 | Takion 渐变与彩虹标签、悬停/点击动作,以及由 InventoryFramework 驱动的聊天颜色菜单 GUI。 |
| 分析 | bStats(ID 25264),提供针对检测到的集成项的下钻图表。 |
内置与可选集成
| 类别 | 支持的插件/库 | 备注 |
|---|---|---|
| 捆绑库 | Takion 1.3, GlobalScheduler, LangUtils | 已阴影打包进 SIR——无需外部 jar。 |
| 指标 | bStats | 重定位包 (me.croabeast.metrics) 以避免冲突。 |
| 聊天与权限 | Vault, InteractiveChat | 自动检测;权限通过 commands.yml 和频道配置暴露。 |
| 占位符系统 | PlaceholderAPI | 可选但完全支持;注册专用扩展。 |
| Discord 桥接 | DiscordSRV, EssentialsDiscord | 使用按频道的嵌入模板路由加入/退出/进度/聊天事件。 |
| 身份验证 | AuthMe, UserLogin, NexAuth, nLogin, OpeNLogin | 通过 modules/hook/login.yml 共享出生点处理。 |
| 隐身处理 | CMI, EssentialsX, SuperVanish, PremiumVanish | 可选的隐身聊天键规则以防止消息泄露。 |
| 管理协同 | AdvancedBan 及其他惩罚套件 | 使用冷却时间、静音命令和违规操作来补充第三方管理。 |
模块化平台概览
| 模块 | 用途 | 关键配置文件 |
|---|---|---|
| 加入/退出 | 欢迎玩家,控制原版加入/退出刷屏,并管理出生点与无敌状态。 | modules/join_quit/config.yml, modules/join_quit/messages.yml |
| 公告 | 基于时间的广播,混合聊天、标题、动作栏、声音和命令。 | modules/announcements/config.yml, modules/announcements/announces.yml |
| MOTD | 轮换服务器列表 MOTD 和图标,带有自定义计数器。 | modules/motd/config.yml, modules/motd/motds.yml |
| 进度 | 广播成就,附带奖励及按世界/模式过滤器。 | modules/advancements/config.yml, modules/advancements/messages.yml |
| 聊天 – 频道 | 具有继承性和颜色治理的层级全局/本地频道。 | modules/chat/channels.yml(参见 wiki 指南) |
| 聊天 – 冷却 | 防刷屏计时器和脚本化惩罚。 | modules/chat/cooldowns.yml |
| 聊天 – 表情与标签 | 用格式化文本替换快捷方式,并管理基于权限的标签。 | modules/chat/emojis.yml, modules/chat/tags.yml |
| 聊天 – 提及 | 通过声音、悬停/点击动作和自定义输出高亮接收者。 | modules/chat/mentions.yml |
| 聊天 – 管理 | 过滤脏话、大写、链接,并强制执行格式标准。 | modules/chat/moderation.yml |
| 钩子 – Discord | DiscordSRV 频道路由和嵌入模板。 | modules/hook/discord.yml, webhooks.yml |
| 钩子 – 登录/隐身 | 与身份验证和隐身插件同步行为。 | modules/hook/login.yml, modules/hook/vanish.yml |
所有模块均可从 modules/modules.yml 进行切换,该文件还管理已随附配置的更新跟踪。
命令套件
| 命令 | 摘要 | 亮点 |
|---|---|---|
/sir |
管理中枢 | 关于、重载、模块状态、帮助、支持链接。 |
/print |
原始格式化广播器 | 定向聊天、标题、操作栏、Discord Webhook。 |
/announcer |
管理自动公告 | 预览、开始/停止、重启序列。 |
/chatview |
频道可见性 | 玩家可选择加入或退出频道订阅。 |
/chatcolor |
GUI 颜色选择器 | 可解锁的颜色、渐变、彩虹样式。 |
/ignore |
个人静音列表 | 每位玩家的持久化忽略数据。 |
/clearchat |
清除本地/全局聊天 | 即时管理工具。 |
/msg, /reply |
私聊消息 | @提及的声音与操作反馈。 |
/mute, /tempmute, /unmute, /checkmute |
管理控制 | 永久或限时静音,由可配置的语言/数据文件驱动。 |
命令行为、别名和语言字符串位于 resources/commands/ 下,以便完全自定义。
格式化与玩家体验工具包
- 消息前缀: 在
config.yml中定义主插件前缀、居中文本标签和行分隔符。 - 渐变与彩虹标签: 在插件解析文本的任何地方使用
<G:#RRGGBB:#RRGGBB>或<R:n>语法。 - 交互组件: 为消息、公告和提及附加悬停列表和点击动作。
- 音效设计: 使用原版声音键分配独特的加入/退出、提及和公告声音。
- 出生点逻辑: 每条消息组的出生点传送器在启用时与登录插件对齐。
- Boss 条与标题: 利用 Takion 的动画 Boss 条实现公告或特定模块的效果。
快速入门
- 将 SIR 放入
plugins/– 无需外部依赖;Takion 已内置于 jar 文件中。 - 启动服务器一次 – 配置文件将在
plugins/SIR/resources/下生成。 - 查看
config.yml和modules/modules.yml– 切换功能并调整更新检查。 - 定制模块 – 编辑每个模块目录下的 YAML 文件以匹配服务器的风格和规则。
- 授予权限 – 使用你的权限管理器(兼容 Vault)分配命令和频道访问权限。
- 重载或重启 –
/sir reload应用配置更改而无需完全重启。
需要更多详情?下面的 Wiki 页面深入介绍了各个子系统,并提供即拿即用的示例。
文档与支持
- Wiki:
- 社区 Discord:
- 问题追踪器:
遥测与隐私
SIR 会向 bStats(指标 ID 25264)报告匿名使用数据,以帮助开发者了解哪些集成处于活动状态。如需禁用指标,请在 plugins/bStats/config.yml 中进行全局设置,或使用防火墙以避免被统计。
贡献与反馈
发现 Bug 或有功能请求?请在 GitHub 上提交 Issue,或通过 Discord 社区联系。欢迎贡献——分叉仓库,进行修改,并提交拉取请求。
通过 SIR,你可以掌控玩家看到的每一步对话。配置一次,永恒愉悦。
Text Description
SIR – Simple In-game Receptionist
A modular Minecraft assistant that centralizes chat management, announcements, onboarding, and cross-platform communication. SIR ships with a rich configuration toolkit so you can tailor every interaction players see without touching Java code.
Feature Highlights
- Modular architecture – Toggle self-contained modules for chat, join/quit experiences, announcements, MOTDs, advancements, and third-party hooks.
- Deep chat customization – Build channel hierarchies, apply gradient colours, emojis, hover/click actions, tags, and mention effects directly from YAML.
- Player journey controls – Craft first-join flows, spawn teleport rules, welcome/farewell messages, and timed invulnerability windows.
- Automated outreach – Schedule announcements that mix chat, action bar, title, boss bar, sounds, and console commands.
- Discord-ready – Mirror activity with DiscordSRV or EssentialsDiscord using embed templates, per-event routing, and cross-server relays.
- Login & vanish awareness – Coordinate with major authentication and vanish plugins so muted, hidden, or unauthenticated players follow your rules.
- Takion-powered runtime – The Takion framework is bundled, providing the scheduler, text processors, gradients, and boss bars you rely on—no extra download needed.
- Live updates & metrics – Automatic update checks, optional coloured console logging, and bStats analytics keep administrators informed.
Compatibility Matrix
| Area | Details |
|---|---|
| Minecraft server | Spigot/Paper/Folia API 1.13+ (Folia flag enabled in plugin.yml). |
| Java runtime | Compiled for Java 8 targets while building with Maven (Java 21 toolchain supported). |
| Permissions | Vault-driven chat adapter with automatic fallback when Vault is absent. |
| Placeholder support | PlaceholderAPI expansion included; formats across messages, announcements, and Discord bridge respect PAPI placeholders. |
| Text effects | Takion gradient & rainbow tags, hover/click actions, and InventoryFramework-powered GUIs for chat colour menus. |
| Analytics | bStats (ID 25264) with drill-down charts for detected integrations. |
Built-in & Optional Integrations
| Category | Supported Plugins / Libraries | Notes |
|---|---|---|
| Bundled libraries | Takion 1.3, GlobalScheduler, LangUtils | Shaded inside SIR—no external jars needed. |
| Metrics | bStats | Relocated package (me.croabeast.metrics) to avoid conflicts. |
| Chat & permissions | Vault, InteractiveChat | Automatically detected; permissions exposed through commands.yml and channel configs. |
| Placeholder system | PlaceholderAPI | Optional but fully supported; registers a dedicated expansion. |
| Discord bridge | DiscordSRV, EssentialsDiscord | Route join/quit/advancement/chat events with per-channel embed templates. |
| Authentication | AuthMe, UserLogin, NexAuth, nLogin, OpeNLogin | Shared spawn handling via modules/hook/login.yml. |
| Vanish handling | CMI, EssentialsX, SuperVanish, PremiumVanish | Optional vanish chat key rules to block message leaks. |
| Moderation synergy | AdvancedBan and other punishment suites | Use cooldowns, mute commands, and violation actions to complement third-party moderation. |
Modular Platform Overview
| Module | Purpose | Key Configuration Files |
|---|---|---|
| Join/Quit | Welcomes players, controls vanilla join/quit spam, and manages spawn & invulnerability. | modules/join_quit/config.yml, modules/join_quit/messages.yml |
| Announcements | Time-based broadcasts mixing chat, titles, action bars, sounds, and commands. | modules/announcements/config.yml, modules/announcements/announces.yml |
| MOTD | Rotates server list MOTDs and icons with custom counters. | modules/motd/config.yml, modules/motd/motds.yml |
| Advancements | Broadcasts achievements with rewards and per-world/mode filters. | modules/advancements/config.yml, modules/advancements/messages.yml |
| Chat – Channels | Hierarchical global/local channels with inheritance and colour governance. | modules/chat/channels.yml (see wiki guide) |
| Chat – Cooldowns | Anti-spam timers and scripted punishments. | modules/chat/cooldowns.yml |
| Chat – Emojis & Tags | Replace shortcuts with formatted text and manage permission-based tags. | modules/chat/emojis.yml, modules/chat/tags.yml |
| Chat – Mentions | Highlight recipients with sounds, hover/click actions, and custom outputs. | modules/chat/mentions.yml |
| Chat – Moderation | Filter swears, caps, links, and enforce format standards. | modules/chat/moderation.yml |
| Hooks – Discord | DiscordSRV channel routing and embed templates. | modules/hook/discord.yml, webhooks.yml |
| Hooks – Login/Vanish | Sync behaviour with authentication and vanish plugins. | modules/hook/login.yml, modules/hook/vanish.yml |
All modules are toggled from modules/modules.yml, which also manages update tracking for shipped configs.
Command Suite
| Command | Summary | Highlights |
|---|---|---|
/sir |
Administrative hub | About, reload, module status, help, support links. |
/print |
Raw formatted broadcaster | Targeted chat, titles, action bars, Discord webhooks. |
/announcer |
Manage automated announcements | Preview, start/stop, reboot sequences. |
/chatview |
Channel visibility | Players opt in/out of channel subscriptions. |
/chatcolor |
GUI colour selector | Unlockable colours, gradients, rainbow styles. |
/ignore |
Personal mute list | Persistent ignore data per player. |
/clearchat |
Clear local/global chat | Instant moderation tool. |
/msg, /reply |
Private messaging | Sound & action feedback for mentions. |
/mute, /tempmute, /unmute, /checkmute |
Moderation controls | Permanent or timed mutes powered by configurable lang/data files. |
Command behaviour, aliases, and language strings live under resources/commands/ for complete customization.
Formatting & Player Experience Toolkit
- Message prefixing: Define the main plugin prefix, centred text tag, and line separators in
config.yml. - Gradient & rainbow tags: Use
<G:#RRGGBB:#RRGGBB>or<R:n>syntax anywhere the plugin parses text. - Interactive components: Attach hover lists and click actions across messages, announcements, and mentions.
- Sound design: Assign unique join/quit, mention, and announcement sounds using vanilla sound keys.
- Spawn logic: Per-message group spawn teleporters align with login plugins when enabled.
- Boss bars & titles: Tap into Takion’s animated boss bars for announcement or module-specific effects.
Getting Started
- Drop SIR into
plugins/– No external dependencies are required; Takion is already shaded inside the jar. - Start your server once – Configuration files populate under
plugins/SIR/resources/. - Review
config.ymlandmodules/modules.yml– Toggle features and adjust update checks. - Tailor modules – Edit the YAML files under each module directory to match your server’s tone and rules.
- Grant permissions – Use your permission manager (Vault-compatible) to assign command and channel access.
- Reload or restart –
/sir reloadapplies configuration changes without a full reboot.
Need more detail? The wiki pages below dive into each subsystem with copy-paste-ready examples.
Documentation & Support
- Wiki:
- Community Discord:
- Issue tracker:
Telemetry & Privacy
SIR reports anonymous usage data to bStats (metrics ID 25264) to help the developer understand which integrations are active. Disable metrics globally in plugins/bStats/config.yml or use your firewall if you prefer to opt out.
Contributing & Feedback
Found a bug or have a feature request? Open an issue on GitHub or reach out through the Discord community. Contributions are welcome—fork the repository, make your improvements, and submit a pull request.
With SIR, you control every step of the conversation players see. Configure once, delight forever.
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SIR
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
占位符修复与迁移
表情符号和标签占位符已恢复正常,新增命令可自动将旧的 SIR 占位符更新为新版格式。
新增
- 新增
/sir migrate Placeholders命令。它会查找旧的 SIR 占位符(%sir_color_...%、%sir_toggle_...%、%sir_emoji_...%、%sir_tag_...%)并将其更改为新名称。 - 不带参数时,仅检查 SIR 文件夹。添加
--all以同时更新其他插件,如 TAB、计分板或菜单。 - 每个被修改的文件都会先复制到
plugins/SIR/back-ups/placeholders-<date>。
已更改
- Emoji 占位符现在为
%sir-emoji_...%,标签占位符现在为%sir-tag_...%。
修复
- 修复了 PlaceholderAPI 中 Emoji 和标签占位符无法使用的问题。
- 修复了未设置持续时间的
[BOSSBAR]消息永久显示在屏幕上的问题,现在它们会在 5 秒后隐藏。
备注 / 建议
- 更新后运行一次
/sir migrate Placeholders --all,或手动更改你的占位符。 - 命令的结果信息会作为新行添加到
commands/main/lang.yml文件中。如果该文件早于本次更新,迁移仍然有效但不会显示结果消息。 - 更新后请重启服务器。
自定义命令与控制台日志
使用全新的自定义命令模块创建您自己的命令,同时提供用于公告、加入/离开以及进度消息的控制台日志选项。
新增
- 自定义命令模块: 每个命令对应一个文件,存放在其
commands文件夹中,支持参数、权限、冷却时间、消耗、随机值以及游戏内编辑器菜单。自带示例命令如 ping、me、try、dice、coin、ball、broadcast 和 daily。 - 在公告、加入/离开和进度系统的
config.yml中添加了log-to-console选项。公告和加入/离开的消息也可以使用它们各自的log选项进行覆盖。
更改
- Clear Chat(清除聊天)和 Print(打印)现在变为自定义命令(
commands/clear-chat.yml和commands/print.yml)。您的编辑设置和消息会自动迁移,旧文件夹将被重命名为<name>-migrated。 - PlaceholderAPI 标识符现在使用连字符:
%sir_color_...%改为%sir-color_...%,%sir_toggle_...%改为%sir-toggle_...%。 - 私人通知(例如禁言和隐身聊天警告)不再记录到控制台。
- PacketEvents 现在是一个软依赖项,因此在安装后 SIR 会在它之后加载。
修复
- 之前被静默忽略的错误现在会记录到控制台。
备注 / 建议
- 请将您的占位符从
%sir_color_...%和%sir_toggle_...%更新为%sir-color_...%和%sir-toggle_...%。 - 更新后请重启服务器。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧