5.5 KiB
Iridium
MCDReforged 插件：物品展示 / 戴头 / 获取头颅 / 游戏内计算器 / 进服 MOTD。
| 版本 | 26.9.14 |
| 作者 | 云镜之端/SKYMirror |
| 许可 | 保留所有权益（All Rights Reserved） |
| 前置 | MCDReforged >= 2.6.0 |
| MC | 1.7.10+（按版本分支；不支持的功能会提示） |
| 依赖 | 无第三方 Python 包 |
功能一览
| 功能 | 说明 |
|---|---|
!!share |
展示主手物品：聊天栏显示物品名，悬停查看完整数据 |
!!hat |
主手与头部装备互换 |
!!head [player] |
给自己或指定玩家 1 个 头颅；有冷却 |
!!c <表达式> |
四则运算 + 括号：+ - * / // % ** ^ |
| 进服 MOTD | 开服天数、自定义行、可点击链接、§ 颜色 |
| 进服命令提示 | 可点击填入聊天框 |
安装
方式 A：使用发布包
- 下载
Iridium.mcdr - 放入 MCDR 的
plugins/目录 !!MCDR reload plugin或重启 MCDR
方式 B：从源码打包
./pack.sh
# 或
zip -r Iridium.mcdr iridium lang mcdreforged.plugin.json LICENSE
使用 !!hat / 无 RCON 的 !!share
在 server.properties 中启用 RCON，并在 MCDR 配置里填好连接信息：
enable-rcon=true
rcon.port=25575
rcon.password=your_password
| 功能 | 无 RCON | 有 RCON |
|---|---|---|
!!share |
可用（解析控制台回包，空手可能超时提示） | 推荐 |
!!hat |
不可用（会提示） | 必需 |
命令
| 命令 | 权限（默认） | 说明 |
|---|---|---|
!!share |
permission |
展示主手物品 |
!!hat |
permission |
手与头盔交换 |
!!head |
permission |
给自己一个头颅 |
!!head <player> |
permission |
给自己一个该玩家的头颅 |
!!c <表达式> |
permission |
计算并私聊回复结果 |
帮助列表可用 !!help 查看（已注册 help message）。
版本能力
| 功能 | 1.7.10 | 1.8–1.12 | 1.13–1.16 | 1.17–1.20.4 | 1.20.5+ |
|---|---|---|---|---|---|
!!c |
✅ | ✅ | ✅ | ✅ | ✅ |
!!head |
✅ | ✅ | ✅ | ✅ | ✅ profile 组件 |
!!share |
❌ 提示 | ✅ entitydata | ✅ data get | ✅ | ✅ |
!!hat |
❌ 提示 | ✅ RCON | ✅ RCON | ✅ RCON | ✅ RCON |
| MOTD / 进服提示 | ✅ | ✅ | ✅ | ✅ | ✅ |
无法检测版本时会提示；可在配置中设置 force_version（如 "1.12.2"）。
配置
路径：config/iridium/iridium.yml（YAML，# 注释；首次加载自动生成；旧的 config/iridium.json / config/iridium/iridium.json 会自动迁移）
permission: 1
head_cooldown_seconds: 60
hat_cooldown_seconds: 3
share_sound: true
force_version: ""
join_tip: true
join_tip_delay_seconds: 1.5
motd_enabled: true
motd_start_day: "2026-09-14"
motd_lines:
- "§6欢迎 §e{player}§6 加入服务器！"
- "§7服务器已开服 §b{days}§7 天"
- "§7官网: {link:§b点击打开官网|https://www.skymirror.top}"
- "§7QQ群: {link:§f985402607|https://skymirror.top/qq}"
| 字段 | 默认 | 说明 |
|---|---|---|
permission |
1 |
各命令最低权限（0 控制台 / 1 普通玩家 / 2 OP） |
head_cooldown_seconds |
60 |
!!head 冷却；0 不限制 |
hat_cooldown_seconds |
3 |
!!hat 冷却；0 不限制 |
share_sound |
true |
!!share 是否播放提示音 |
force_version |
"" |
强制 MC 版本；留空自动检测 |
join_tip |
true |
进服是否提示可用命令 |
join_tip_delay_seconds |
1.5 |
进服消息延迟；0 立即 |
motd_enabled |
true |
是否发送 MOTD |
motd_start_day |
生成配置当天 | 开服日期 YYYY-MM-DD（当天算第 1 天）；可改成真实开服日 |
motd_lines |
见上 | MOTD 文本行 |
修改配置后执行 !!MCDR reload plugin 生效。
MOTD 语法
| 语法 | 含义 |
|---|---|
{player} |
进服玩家名（已清洗） |
{days} / {day} |
开服天数 |
{online} |
在线人数，拿不到为 ? |
{link:文字|https://url} |
可点击链接 |
{link:https://url} |
可点击链接，显示完整 URL |
§ |
原版颜色/样式（§a §e §l §r 等） |
仅当 motd_lines 中没有 {days}/{day} 时，才会在末尾自动追加「开服第 N 天」。
常见问题
!!hat 说需要 RCON？
未开启 RCON，或 MCDR 未配置 RCON 连接。见上文「使用 !!hat」。
进服没有 MOTD？
检查 motd_enabled、join_tip_delay_seconds；若延迟 >0，消息会在进服后约 1.5 秒出现。
版本检测失败？
等待 VersionDetector 完成，或配置 force_version。
!!share 超时？
多为无 RCON 且空手（控制台无 SelectedItem 回包）。可开 RCON 或先手持物品再试。
如何关闭进服提示？
join_tip 与 motd_enabled 可分别设为 false。
安全说明
- 计算器：字符 + AST 白名单，不执行任意 Python；指数上限 64。
- 玩家名进入游戏命令前统一清洗为
[A-Za-z0-9_]（最长 32）。 - 控制台命令会去掉换行，避免拆成多行执行。
- MOTD 链接仅
http(s)。 !!head每次固定 1 个，并受冷却限制。
开发与测试
python3 tests/test_pure.py
无需启动 Minecraft；覆盖命令拼装、NBT 解析、计算器、MOTD 与清洗逻辑。
版权
Copyright (c) 2026 云镜之端/SKYMirror. All Rights Reserved.
未经书面许可，不得复制、修改、分发或用于商业用途。详见 LICENSE。