fix: YAML lang files and PLAYER_JOINED event name (26.9.2)

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 本文件记录 Iridium 的重要变更。
 
+## [26.9.2] - 2026-09-13
+
+### Fixed
+- 语言文件 YAML 解析失败（值中含 `:` 未加引号导致 `mapping values are not allowed`）
+- 进服事件名错误：`PLAYER_JOIN` → `PLAYER_JOINED`（否则插件 on_load 失败）
+
 ## [26.9.1] - 2026-09-13
 
 ### Added

README.md

@@ -4,7 +4,7 @@ MCDReforged 插件：物品展示 / 戴头 / 获取头颅 / 游戏内计算器 /
 
 | | |
 |---|---|
-| 版本 | **26.9.1** |
+| 版本 | **26.9.2** |
 | 作者 | 云镜之端/SKYMirror |
 | 许可 | 保留所有权益（All Rights Reserved） |
 | 前置 | MCDReforged `>= 2.6.0` |

catalogue/SUBMIT.md

@@ -0,0 +1,97 @@
+# 提交到 MCDReforged 官方插件库
+
+官方库：https://github.com/MCDReforged/PluginCatalogue  
+贡献指南：https://github.com/MCDReforged/PluginCatalogue/blob/master/CONTRIBUTING_zh_cn.md
+
+## 当前进度
+
+仓库：https://github.com/HzSKYMirror/Iridium  
+
+| 步骤 | 状态 |
+|------|------|
+| 公开 GitHub 仓库 | 已创建（当前可能仍为空，需推送） |
+| `plugin_info.json` | 已写好（`catalogue/plugin_info.json`） |
+| GitHub Release + `.mcdr` 附件 | **待完成** |
+| 官方库 PR | **待完成** |
+
+## 硬性前提
+
+1. **公开 GitHub 仓库**（官方脚本只认 GitHub，不认 git.skymirror.top）
+2. **GitHub Release 标签正确，附件为 `.mcdr`**  
+   建议 Tag：`v26.9.1`；附件：`Iridium.mcdr`
+3. **根目录有 `README.md`**（已有）
+4. **许可**：官方强烈建议 OSI 开源许可；专有许可可提但审阅更慢，且提交即授权社区从 GitHub Releases 下载使用
+5. **一个 PR 只加一个插件**
+
+## 提交步骤
+
+### 1. 推送源码到 GitHub
+
+```bash
+cd /Users/l3126596029/Code/MCDR_plg/Iridium
+git remote add github https://github.com/HzSKYMirror/Iridium.git
+git push -u github main
+```
+
+### 2. 在 GitHub 发 Release
+
+- Tag：`v26.9.1`
+- 附件：本地执行 `./pack.sh` 得到的 `Iridium.mcdr`
+
+### 3. 向官方库提 PR
+
+1. Fork https://github.com/MCDReforged/PluginCatalogue  
+2. 新建文件：`plugins/iridium/plugin_info.json`  
+   内容直接使用本仓库 `catalogue/plugin_info.json`  
+3. 向 `MCDReforged/PluginCatalogue` 的 `master` 发起 Pull Request  
+
+### PR 标题
+
+```text
+Add plugin: iridium
+```
+
+### PR 描述
+
+```markdown
+## Plugin
+
+- ID: `iridium`
+- Name: Iridium
+- Repository: https://github.com/HzSKYMirror/Iridium
+- Release: https://github.com/HzSKYMirror/Iridium/releases/tag/v26.9.1
+- Labels: `tool`
+
+## Summary
+
+物品展示（!!share）、戴头（!!hat）、获取玩家头颅（!!head）、
+游戏内计算器（!!c）、进服 MOTD 与命令提示。
+
+面向 Minecraft 1.7.10+，按版本分支；需要 MCDR >= 2.6.0。
+打包插件为 `.mcdr`，Release 已附带成品。
+
+## Checklist
+
+- [x] Packaged plugin (.mcdr) with a release
+- [x] README.md in repository root
+- [x] plugin_id consistent (`iridium`)
+- [x] One plugin per PR
+```
+
+## 可选优化
+
+| 项 | 建议 |
+|----|------|
+| 许可 | 改为 MIT / Apache-2.0 更易过审 |
+| 英文 README | 可另加 `README_en.md` 并写入 introduction |
+| label | `tool`（官方标签：information / tool / management / api / handler） |
+
+## 本地校验（可选）
+
+官方脚本需 Python >= 3.11：
+
+```bash
+cd PluginCatalogue/scripts
+pip3 install -r requirements.txt
+python3 main.py check --help
+```

catalogue/plugin_info.json

@@ -0,0 +1,17 @@
+{
+	"id": "iridium",
+	"authors": [
+		{
+			"name": "云镜之端/SKYMirror",
+			"link": "https://github.com/HzSKYMirror"
+		}
+	],
+	"repository": "https://github.com/HzSKYMirror/Iridium",
+	"branch": "main",
+	"related_path": ".",
+	"labels": ["tool"],
+	"introduction": {
+		"zh_cn": "README.md",
+		"en_us": "README.md"
+	}
+}

iridium/join_tip.py

@@ -239,4 +239,5 @@ def on_player_joined(server: PluginServerInterface, player: str, info: Info) ->
 
 
 def register(server: PluginServerInterface) -> None:
-	server.register_event_listener(MCDRPluginEvents.PLAYER_JOIN, on_player_joined)
+	# MCDR event name is PLAYER_JOINED (not PLAYER_JOIN)
+	server.register_event_listener(MCDRPluginEvents.PLAYER_JOINED, on_player_joined)

lang/en_us.yml

@@ -1,32 +1,32 @@
-iridium.loaded: Iridium loaded
+iridium.loaded: 'Iridium loaded'
-iridium.unloaded: Iridium unloaded
+iridium.unloaded: 'Iridium unloaded'
-iridium.version_mode: Version detection mode: {0}
+iridium.version_mode: 'Version detection mode: {0}'
-iridium.bad_force_version: Invalid force_version in config: {0}
+iridium.bad_force_version: 'Invalid force_version in config: {0}'
-iridium.version_unknown: Unable to detect Minecraft version. Wait for VersionDetector, or set force_version in config
+iridium.version_unknown: 'Unable to detect Minecraft version. Wait for VersionDetector, or set force_version in config'
-iridium.player_only: This command can only be used by a player in-game
+iridium.player_only: 'This command can only be used by a player in-game'
-iridium.required_permission: Insufficient permission, requires level {0}
+iridium.required_permission: 'Insufficient permission, requires level {0}'
-iridium.on_cooldown: Cooldown, wait {0}s
+iridium.on_cooldown: 'Cooldown, wait {0}s'
-iridium.hand_is_empty: No usable item in hand
+iridium.hand_is_empty: 'No usable item in hand'
-iridium.share_help: Show the item in your main hand (hover to view)
+iridium.share_help: 'Show the item in your main hand (hover to view)'
-iridium.share_done: Item shared to chat
+iridium.share_done: 'Item shared to chat'
-iridium.share_unsupported_version: Version {0} cannot read held item (needs Minecraft 1.8+)
+iridium.share_unsupported_version: 'Version {0} cannot read held item (needs Minecraft 1.8+)'
-iridium.share_timeout: Timed out reading held item, try again later
+iridium.share_timeout: 'Timed out reading held item, try again later'
-iridium.click_copy: click to copy data
+iridium.click_copy: 'click to copy data'
-iridium.click_suggest: click for data command
+iridium.click_suggest: 'click for data command'
-iridium.share_showing: is showing
+iridium.share_showing: 'is showing'
-iridium.hat_help: Swap the item in your hand with your head slot
+iridium.hat_help: 'Swap the item in your hand with your head slot'
-iridium.hat_success: Swapped hand item with head equipment
+iridium.hat_success: 'Swapped hand item with head equipment'
-iridium.hat_unsupported_version: Version {0} does not support !!hat (needs Minecraft 1.8+)
+iridium.hat_unsupported_version: 'Version {0} does not support !!hat (needs Minecraft 1.8+)'
-iridium.hat_need_rcon: !!hat requires RCON enabled to read and swap item data
+iridium.hat_need_rcon: '!!hat requires RCON enabled to read and swap item data'
-iridium.hat_query_failed: Failed to query player item data
+iridium.hat_query_failed: 'Failed to query player item data'
-iridium.head_help: Get one player head (optional player name, cooldown {0}s)
+iridium.head_help: 'Get one player head (optional player name, cooldown {0}s)'
-iridium.head_help_short: Get one player head (optional player name)
+iridium.head_help_short: 'Get one player head (optional player name)'
-iridium.head_success: You received a head of {0}
+iridium.head_success: 'You received a head of {0}'
-iridium.calc_help: Evaluate an expression, e.g. !!c 1+2*(3-1)
+iridium.calc_help: 'Evaluate an expression, e.g. !!c 1+2*(3-1)'
-iridium.calc_usage: Usage: !!c <expression>, e.g. !!c 1+2*(3-1)
+iridium.calc_usage: 'Usage: !!c <expression>, e.g. !!c 1+2*(3-1)'
-iridium.calc_error: Cannot calculate {0}: {1}
+iridium.calc_error: 'Cannot calculate {0}: {1}'
-iridium.calc_div_zero: Division by zero
+iridium.calc_div_zero: 'Division by zero'
-iridium.join_tip_header: Iridium is enabled. Available commands: (click to fill chat)
+iridium.join_tip_header: 'Iridium is enabled. Available commands: (click to fill chat)'
-iridium.join_tip_click: click to fill chat
+iridium.join_tip_click: 'click to fill chat'
-iridium.motd_header: Server Info
+iridium.motd_header: 'Server Info'
-iridium.motd_days: Day {0} since server start
+iridium.motd_days: 'Day {0} since server start'

lang/zh_cn.yml

@@ -1,32 +1,32 @@
-iridium.loaded: Iridium 已加载
+iridium.loaded: 'Iridium 已加载'
-iridium.unloaded: Iridium 已卸载
+iridium.unloaded: 'Iridium 已卸载'
-iridium.version_mode: 版本检测模式: {0}
+iridium.version_mode: '版本检测模式: {0}'
-iridium.bad_force_version: 配置 force_version 无效: {0}
+iridium.bad_force_version: '配置 force_version 无效: {0}'
-iridium.version_unknown: 无法检测 Minecraft 版本，请等待服务器完成 VersionDetector，或在配置中设置 force_version
+iridium.version_unknown: '无法检测 Minecraft 版本，请等待服务器完成 VersionDetector，或在配置中设置 force_version'
-iridium.player_only: 该命令只能由玩家在游戏内使用
+iridium.player_only: '该命令只能由玩家在游戏内使用'
-iridium.required_permission: 权限不足，需要权限等级 {0}
+iridium.required_permission: '权限不足，需要权限等级 {0}'
-iridium.on_cooldown: 冷却中，请再等待 {0} 秒
+iridium.on_cooldown: '冷却中，请再等待 {0} 秒'
-iridium.hand_is_empty: 手上没有可处理的物品
+iridium.hand_is_empty: '手上没有可处理的物品'
-iridium.share_help: 展示手上物品的完整信息（悬停查看）
+iridium.share_help: '展示手上物品的完整信息（悬停查看）'
-iridium.share_done: 已在聊天栏展示物品
+iridium.share_done: '已在聊天栏展示物品'
-iridium.share_unsupported_version: 当前版本 {0} 无法读取手持物品（需要 Minecraft 1.8+）
+iridium.share_unsupported_version: '当前版本 {0} 无法读取手持物品（需要 Minecraft 1.8+）'
-iridium.share_timeout: 读取手持物品超时，请稍后再试
+iridium.share_timeout: '读取手持物品超时，请稍后再试'
-iridium.click_copy: 点击复制完整数据
+iridium.click_copy: '点击复制完整数据'
-iridium.click_suggest: 点击获取完整数据命令
+iridium.click_suggest: '点击获取完整数据命令'
-iridium.share_showing: 正在展示
+iridium.share_showing: '正在展示'
-iridium.hat_help: 将手上物品与头部装备互换
+iridium.hat_help: '将手上物品与头部装备互换'
-iridium.hat_success: 已交换手上物品与头部装备
+iridium.hat_success: '已交换手上物品与头部装备'
-iridium.hat_unsupported_version: 当前版本 {0} 不支持 !!hat（需要 Minecraft 1.8+）
+iridium.hat_unsupported_version: '当前版本 {0} 不支持 !!hat（需要 Minecraft 1.8+）'
-iridium.hat_need_rcon: !!hat 需要启用 RCON 才能读取并交换物品数据
+iridium.hat_need_rcon: '!!hat 需要启用 RCON 才能读取并交换物品数据'
-iridium.hat_query_failed: 读取玩家物品数据失败
+iridium.hat_query_failed: '读取玩家物品数据失败'
-iridium.head_help: 获取一个玩家头颅（可指定玩家名，冷却 {0} 秒）
+iridium.head_help: '获取一个玩家头颅（可指定玩家名，冷却 {0} 秒）'
-iridium.head_help_short: 获取一个玩家头颅（可指定玩家名）
+iridium.head_help_short: '获取一个玩家头颅（可指定玩家名）'
-iridium.head_success: 已给予你 {0} 的头颅
+iridium.head_success: '已给予你 {0} 的头颅'
-iridium.calc_help: 计算表达式，例如 !!c 1+2*(3-1)
+iridium.calc_help: '计算表达式，例如 !!c 1+2*(3-1)'
-iridium.calc_usage: 用法: !!c <表达式>，例如 !!c 1+2*(3-1)
+iridium.calc_usage: '用法: !!c <表达式>，例如 !!c 1+2*(3-1)'
-iridium.calc_error: 无法计算 {0}: {1}
+iridium.calc_error: '无法计算 {0}: {1}'
-iridium.calc_div_zero: 除数不能为 0
+iridium.calc_div_zero: '除数不能为 0'
-iridium.join_tip_header: 本服已启用 Iridium，可用命令：（点击命令可填入聊天框）
+iridium.join_tip_header: '本服已启用 Iridium，可用命令：（点击命令可填入聊天框）'
-iridium.join_tip_click: 点击填入聊天栏
+iridium.join_tip_click: '点击填入聊天栏'
-iridium.motd_header: 服务器信息
+iridium.motd_header: '服务器信息'
-iridium.motd_days: 开服第 {0} 天
+iridium.motd_days: '开服第 {0} 天'

mcdreforged.plugin.json

@@ -1,6 +1,6 @@
 {
 	"id": "iridium",
-	"version": "26.9.1",
+	"version": "26.9.2",
 	"name": "Iridium",
 	"description": {
 		"zh_cn": "物品展示 / 戴头 / 获取头颅 / 游戏内计算器 / 进服 MOTD",