清理：移除未使用代码与翻译键，更新文档版本 (26.9.17)

CHANGELOG.md

@@ -5,6 +5,36 @@ This file records notable changes to Iridium.
 
 ---
 
+## [26.9.17] - 2026-09-14
+
+### 清理 / Cleanup
+- 移除未使用的常量、翻译键与导入
+- Removed unused constants, translation keys, and imports
+
+---
+
+## [26.9.16] - 2026-09-14
+
+### 变更 / Changed
+- 配置格式改为 **YAML**：`config/iridium/iridium.yml`（`#` 原生注释）
+- Config format is now **YAML**: `config/iridium/iridium.yml` (native `#` comments)
+- 自动从旧 JSON（`config/iridium.json` 或 `config/iridium/iridium.json`）迁移
+- Auto-migrates from legacy JSON configs
+
+---
+
+## [26.9.15] - 2026-09-14
+
+### 修复 / Fixed
+- 配置文件写到错误路径导致「删掉后重载不生成」：改用 MCDR 数据目录 `config/iridium/iridium.json`（`get_data_folder`）
+- Config written to the wrong path so delete+reload did not recreate it; now uses MCDR data folder `config/iridium/iridium.json`
+
+### 变更 / Changed
+- 文档中的配置路径更新为 `config/iridium/iridium.json`
+- Docs updated to the correct config path
+
+---
+
 ## [26.9.14] - 2026-09-14
 
 ### 修复 / Fixed

README.md

@@ -4,7 +4,7 @@ MCDReforged 插件：物品展示 / 戴头 / 获取头颅 / 游戏内计算器 /
 
 | | |
 |---|---|
-| 版本 | **26.9.14** |
+| 版本 | **26.9.17** |
 | 作者 | 云镜之端/SKYMirror |
 | 许可 | 保留所有权益（All Rights Reserved） |
 | 前置 | MCDReforged `>= 2.6.0` |
@@ -79,26 +79,23 @@ rcon.password=your_password
 
 ## 配置
 
-路径：`config/iridium.json`（首次加载自动生成）
+路径：`config/iridium/iridium.yml`（YAML，`#` 注释；首次加载自动生成；旧的 `config/iridium.json` / `config/iridium/iridium.json` 会自动迁移）
 
-```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}"
-	]
-}
+```yaml
+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}"
 ```
 
 | 字段 | 默认 | 说明 |

README_en.md

@@ -4,7 +4,7 @@ MCDReforged plugin: item share / wear on head / player head / calculator / join
 
 | | |
 |---|---|
-| Version | **26.9.14** |
+| Version | **26.9.17** |
 | Author | 云镜之端/SKYMirror |
 | License | All Rights Reserved |
 | Requires | MCDReforged `>= 2.6.0` |
@@ -48,7 +48,7 @@ rcon.password=your_password
 
 ## Config
 
-Path: `config/iridium.json` (auto-created with comments on first load)
+Path: `config/iridium/iridium.yml` (YAML with `#` comments; auto-created on first load; migrates legacy JSON configs)
 
 | Field | Default | Description |
 |------|---------|-------------|

catalogue/PR_BODY.md

@@ -3,7 +3,7 @@
 - ID: `iridium`
 - Name: Iridium
 - Repository: https://github.com/HzSKYMirror/Iridium
-- Release: https://github.com/HzSKYMirror/Iridium/releases/tag/v26.9.13
+- Release: https://github.com/HzSKYMirror/Iridium/releases/tag/v26.9.17
 - Labels: `tool`
 
 ## Summary

iridium/__init__.py

@@ -10,7 +10,7 @@ import iridium.hat as hat
 import iridium.head as head
 import iridium.join_tip as join_tip
 import iridium.share as share
-from iridium.config import Config, apply_config, load_config
+from iridium.config import apply_config, load_config
 from iridium.version_util import tr
 
 

iridium/config.py

@@ -1,10 +1,17 @@
 import json
+import shutil
 from datetime import date
+from io import StringIO
 from pathlib import Path
-from typing import List, Optional
+from typing import Any, List, Optional
 
 from mcdreforged.api.all import *
 
+try:
+	from ruamel.yaml import YAML
+except ImportError:  # pragma: no cover
+	YAML = None  # type: ignore
+
 
 def _today() -> str:
 	return date.today().strftime("%Y-%m-%d")
@@ -29,13 +36,7 @@ class Config(Serializable):
 	motd_enabled: bool = True
 	# 开服日期，格式 YYYY-MM-DD；默认为配置生成当天（当天算第 1 天）
 	motd_start_day: str = _today()
-	# MOTD 文本行。支持：
-	#   {player} 玩家名
-	#   {days}   开服天数
-	#   {online} 在线人数（拿不到时显示 ?）
-	#   {link:显示文字|https://url}  可点击链接
-	#   {link:https://url}           链接，显示为完整 URL
-	#   § 颜色代码
+	# MOTD 文本行
 	motd_lines: List[str] = [
 		"§6欢迎 §e{player}§6 加入服务器！",
 		"§7服务器已开服 §b{days}§7 天",
@@ -44,60 +45,59 @@ class Config(Serializable):
 	]
 
 
-CONFIG_FILE = "config/iridium.json"
+# 当前配置：MCDR 数据目录 → config/iridium/iridium.yml
+CONFIG_FILE_NAME = "iridium.yml"
 
 
 def build_default_config_text() -> str:
-	"""带注释的默认配置；开服日期为生成当天。"""
+	"""带注释的默认 YAML 配置；开服日期为生成当天。"""
 	today = _today()
-	return f"""{{
-	// 使用 !!share / !!hat / !!head / !!c 所需的最低权限等级
-	// 0=控制台  1=普通玩家  2=OP/管理员
-	"permission": 1,
+	return f"""# Iridium 配置文件 (YAML)
+# 修改后执行: !!MCDR reload plugin
+# This file uses standard YAML. '#' starts a comment.
 
-	// !!head 冷却时间（秒），0 表示不限制
-	"head_cooldown_seconds": 60,
+# 使用 !!share / !!hat / !!head / !!c 所需的最低权限等级
+# 0=控制台  1=普通玩家  2=OP/管理员
+permission: 1
 
-	// !!hat 冷却时间（秒），0 表示不限制
-	"hat_cooldown_seconds": 3,
+# !!head 冷却时间（秒），0 表示不限制
+head_cooldown_seconds: 60
 
-	// !!share 是否播放提示音
-	"share_sound": true,
+# !!hat 冷却时间（秒），0 表示不限制
+hat_cooldown_seconds: 3
 
-	// 强制指定 Minecraft 版本（如 "1.12.2"、"1.20.1"）
-	// 留空则自动检测；检测失败时可手动填写
-	"force_version": "",
+# !!share 是否播放提示音
+share_sound: true
 
-	// 玩家进服时是否提示可用命令
-	"join_tip": true,
+# 强制指定 Minecraft 版本（如 "1.12.2"、"1.20.1"）
+# 留空则自动检测；检测失败时可手动填写
+force_version: ""
 
-	// 进服消息延迟（秒），0 为立即发送
-	"join_tip_delay_seconds": 1.5,
+# 玩家进服时是否提示可用命令
+join_tip: true
 
-	// 是否发送进服 MOTD（开服天数 + 自定义文案）
-	"motd_enabled": true,
+# 进服消息延迟（秒），0 为立即发送
+join_tip_delay_seconds: 1.5
 
-	// 开服日期，格式 YYYY-MM-DD（当天算第 1 天）
-	// 默认为本配置文件生成当天，可自行修改为真实开服日
-	"motd_start_day": "{today}",
+# 是否发送进服 MOTD（开服天数 + 自定义文案）
+motd_enabled: true
 
-	// MOTD 文本行
-	// 占位符: {{player}} 玩家名  {{days}} 开服天数  {{online}} 在线人数
-	// 链接:   {{link:显示文字|https://url}}  或  {{link:https://url}}
-	// 颜色:   支持原版 § 颜色代码
-	"motd_lines": [
-		"§6欢迎 §e{{player}}§6 加入服务器！",
-		"§7服务器已开服 §b{{days}}§7 天",
-		"§7官网: {{link:§b点击打开官网|https://www.skymirror.top}}",
-		"§7QQ群: {{link:§f985402607|https://skymirror.top/qq}}"
-	]
-}}
+# 开服日期，格式 YYYY-MM-DD（当天算第 1 天）
+# 默认为本配置文件生成当天，可自行修改为真实开服日
+motd_start_day: "{today}"
+
+# MOTD 文本行
+# 占位符: {{player}} 玩家名  {{days}} 开服天数  {{online}} 在线人数
+# 链接:   {{link:显示文字|https://url}}  或  {{link:https://url}}
+# 颜色:   支持原版 § 颜色代码
+motd_lines:
+  - "§6欢迎 §e{{player}}§6 加入服务器！"
+  - "§7服务器已开服 §b{{days}}§7 天"
+  - "§7官网: {{link:§b点击打开官网|https://www.skymirror.top}}"
+  - "§7QQ群: {{link:§f985402607|https://skymirror.top/qq}}"
 """
 
 
-# 兼容旧引用
-DEFAULT_CONFIG_TEXT = build_default_config_text()
-
 # 模块级单例；on_load 时原地更新字段，避免各模块持有过期引用
 config = Config()
 
@@ -115,8 +115,26 @@ def apply_config(new_cfg: Config) -> None:
 	config.motd_lines = list(new_cfg.motd_lines)
 
 
+def _yaml():
+	if YAML is None:
+		raise RuntimeError("ruamel.yaml is required")
+	return YAML(typ="safe")
+
+
+def _load_yaml_text(text: str) -> Any:
+	return _yaml().load(StringIO(text))
+
+
+def _dump_yaml(data: dict) -> str:
+	buf = StringIO()
+	y = _yaml()
+	y.default_flow_style = False
+	y.dump(data, buf)
+	return buf.getvalue()
+
+
 def _strip_json_comments(text: str) -> str:
-	"""Remove // line comments outside of strings."""
+	"""Remove // line comments outside of strings (legacy JSON only)."""
 	out = []
 	i = 0
 	n = len(text)
@@ -147,80 +165,111 @@ def _strip_json_comments(text: str) -> str:
 	return "".join(out)
 
 
-def _candidate_paths(server: PluginServerInterface) -> List[Path]:
-	"""Possible config file locations, best first."""
-	paths: List[Path] = []
-	seen = set()
+def config_file_path(server: PluginServerInterface) -> Path:
+	"""Canonical path: MCDR data folder → config/iridium/iridium.yml"""
+	return Path(server.get_data_folder()) / CONFIG_FILE_NAME
 
-	def add(p: Path) -> None:
-		try:
-			rp = p.expanduser().resolve()
-		except Exception:
-			rp = p
-		key = str(rp)
-		if key not in seen:
-			seen.add(key)
-			paths.append(rp)
 
+def _working_dir(server: PluginServerInterface) -> Path:
 	try:
-		wd = server.get_mcdr_config().get("working_directory")
-		if wd:
-			add(Path(wd) / CONFIG_FILE)
+		wd = server.get_mcdr_config().get("working_directory") or "."
+		return Path(wd).expanduser()
 	except Exception:
-		pass
-	try:
-		add(Path.cwd() / CONFIG_FILE)
-	except Exception:
-		pass
-	# Fallback: next to CWD if MCDR launched from elsewhere
-	add(Path.cwd() / "config" / "iridium.json")
-	return paths
+		return Path.cwd()
 
 
-def config_path(server: PluginServerInterface) -> Path:
-	"""Prefer an existing file; else the first writable candidate."""
-	candidates = _candidate_paths(server)
-	for p in candidates:
-		if p.is_file():
-			return p
-	return candidates[0]
+def _legacy_json_paths(server: PluginServerInterface) -> List[Path]:
+	data_dir = Path(server.get_data_folder())
+	wd = _working_dir(server)
+	return [
+		data_dir / "iridium.json",
+		wd / "config" / "iridium.json",
+	]
 
 
-def ensure_config_file(server: PluginServerInterface) -> Path:
-	"""Create commented default config if missing. Always returns absolute path."""
-	path = config_path(server)
+def _write_default(path: Path, server: PluginServerInterface) -> bool:
 	try:
 		path.parent.mkdir(parents=True, exist_ok=True)
+		path.write_text(build_default_config_text(), encoding="utf-8")
+		server.logger.info(f"已生成配置文件: {path}")
+		return True
 	except Exception as e:
-		server.logger.error(f"无法创建配置目录 {path.parent}: {e}")
-		return path
-	if not path.is_file():
+		server.logger.error(f"写入配置文件失败 {path}: {e}")
+		return False
+
+
+def _try_load_dict_from_text(text: str) -> Optional[dict]:
+	text = text.strip()
+	if not text:
+		return None
+	if text.startswith("{"):
+		return json.loads(_strip_json_comments(text))
+	data = _load_yaml_text(text)
+	return data if isinstance(data, dict) else None
+
+
+def _migrate_legacy_json(server: PluginServerInterface, dest: Path) -> None:
+	"""Convert old JSON config (with optional // comments) to YAML if dest is missing."""
+	if dest.is_file():
+		return
+	for src in _legacy_json_paths(server):
 		try:
-			path.write_text(build_default_config_text(), encoding="utf-8")
-			server.logger.info(f"已生成配置文件: {path}")
+			if not src.is_file():
+				continue
+			raw = src.read_text(encoding="utf-8")
+			data = _try_load_dict_from_text(raw)
+			if not data:
+				continue
+			dest.parent.mkdir(parents=True, exist_ok=True)
+			# keep comments in default template + overlay known keys via dump
+			cfg = Config.deserialize(data)
+			overlay = {
+				"permission": cfg.permission,
+				"head_cooldown_seconds": cfg.head_cooldown_seconds,
+				"hat_cooldown_seconds": cfg.hat_cooldown_seconds,
+				"share_sound": cfg.share_sound,
+				"force_version": cfg.force_version,
+				"join_tip": cfg.join_tip,
+				"join_tip_delay_seconds": cfg.join_tip_delay_seconds,
+				"motd_enabled": cfg.motd_enabled,
+				"motd_start_day": cfg.motd_start_day,
+				"motd_lines": list(cfg.motd_lines),
+			}
+			# Prefer commented default template when values match defaults is complex;
+			# dump parsed values with a short header for clarity.
+			header = (
+				"# Iridium 配置 (从旧 JSON 迁移)\n"
+				"# Migrated from legacy JSON config\n\n"
+			)
+			dest.write_text(header + _dump_yaml(overlay), encoding="utf-8")
+			server.logger.info(f"已从旧 JSON 迁移配置: {src} -> {dest}")
+			return
 		except Exception as e:
-			server.logger.error(f"写入配置文件失败 {path}: {e}")
-	return path
+			server.logger.warning(f"迁移旧配置失败 {src}: {e}")
 
 
 def load_config(server: PluginServerInterface) -> Config:
-	"""Load config; recreate a commented default whenever the file is missing."""
-	path = ensure_config_file(server)
+	"""
+	Load config/iridium/iridium.yml (MCDR data folder).
+	Create commented default if missing; migrate legacy JSON if needed.
+	"""
+	path = config_file_path(server)
+	_migrate_legacy_json(server, path)
+
+	if not path.is_file():
+		_write_default(path, server)
+
 	if not path.is_file():
 		server.logger.warning(f"配置文件不存在且无法创建，使用内存默认值: {path}")
 		return Config()
+
 	try:
 		raw = path.read_text(encoding="utf-8")
-	except Exception as e:
-		server.logger.error(f"读取配置失败 {path}: {e}，使用默认值")
-		return Config()
-	try:
-		data = json.loads(_strip_json_comments(raw))
-	except json.JSONDecodeError as e:
-		server.logger.error(f"配置文件 JSON 解析失败 {path}: {e}，使用默认值")
-		return Config()
-	try:
+		data = _load_yaml_text(raw)
+		if not isinstance(data, dict):
+			raise ValueError("YAML root must be a mapping")
+		server.logger.info(f"配置已加载: {path}")
 		return Config.deserialize(data)
 	except Exception as e:
-		server.logger.error(f"配置反序列化失败 {path}: {e}，使用默认值")
+		server.logger.error(f"读取/解析 YAML 配置失败 {path}: {e}，使用默认值")
 		return Config()

iridium/hat.py

@@ -260,7 +260,6 @@ def _extract_item_payload(payload: str, version: Version) -> Optional[str]:
 def _do_swap(server: PluginServerInterface, src: CommandSource, player: str, version: Version) -> bool:
 	name = sanitize_name(player)
 	head_slot = _head_slot(version)
-	hand_slot = _hand_slot(version, 0)
 
 	# 1.17+: true swap via offhand buffer — no need to rebuild item NBT
 	if is_at_least(version, "1.17"):

iridium/version_util.py

@@ -6,8 +6,6 @@ from iridium.config import config
 
 # Fallback strings when ServerInterface is unavailable (unit tests / early import)
 _FALLBACK = {
-	"click_copy": "click to copy data",
-	"click_suggest": "click for data command",
 	"calc_usage": "Usage: !!c <expression>",
 	"share_showing": "is showing",
 }

lang/en_us.yml

@@ -11,8 +11,6 @@ iridium.share_help: 'Show the item in your main hand (hover to view)'
 iridium.share_done: 'Item shared to chat'
 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.click_copy: 'click to copy data'
-iridium.click_suggest: 'click for data command'
 iridium.share_showing: 'is showing'
 iridium.hat_help: 'Swap the item in your hand with your head slot'
 iridium.hat_success: 'Swapped hand item with head equipment'

lang/zh_cn.yml

@@ -11,8 +11,6 @@ iridium.share_help: '展示手上物品的完整信息（悬停查看）'
 iridium.share_done: '已在聊天栏展示物品'
 iridium.share_unsupported_version: '当前版本 {0} 无法读取手持物品（需要 Minecraft 1.8+）'
 iridium.share_timeout: '读取手持物品超时，请稍后再试'
-iridium.click_copy: '点击复制完整数据'
-iridium.click_suggest: '点击获取完整数据命令'
 iridium.share_showing: '正在展示'
 iridium.hat_help: '将手上物品与头部装备互换'
 iridium.hat_success: '已交换手上物品与头部装备'

mcdreforged.plugin.json

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

tests/test_pure.py

@@ -1,6 +1,7 @@
 """Pure-function unit tests (no live MCDR server required)."""
-import sys
+import json
 import os
+import sys
 
 sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
@@ -268,20 +269,35 @@ def test_extract_display_name():
 
 
 def test_strip_json_comments():
-	import json
 	from datetime import date
 
-	from iridium.config import build_default_config_text, _strip_json_comments
+	from iridium.config import _strip_json_comments, build_default_config_text
 
-	text = build_default_config_text()
-	parsed = json.loads(_strip_json_comments(text))
-	assert parsed["permission"] == 1
-	assert "skymirror.top" in parsed["motd_lines"][2]
-	assert parsed["motd_start_day"] == date.today().strftime("%Y-%m-%d")
-	# comment-looking text inside string is kept
+	# legacy JSON comment stripper still works
+	assert json.loads(_strip_json_comments('{"a": 1 // x\n}'))["a"] == 1
 	assert json.loads(_strip_json_comments('{"a": "http://x"}'))["a"] == "http://x"
 
 
+def test_default_yaml_config():
+	from datetime import date
+
+	from iridium.config import _load_yaml_text, build_default_config_text
+
+	data = _load_yaml_text(build_default_config_text())
+	assert data["permission"] == 1
+	assert data["motd_start_day"] == date.today().strftime("%Y-%m-%d")
+	assert any("skymirror.top" in line for line in data["motd_lines"])
+	assert any("skymirror.top/qq" in line for line in data["motd_lines"])
+
+
+def test_legacy_json_to_yaml_parse():
+	from iridium.config import _try_load_dict_from_text
+
+	assert _try_load_dict_from_text('{"permission": 2}')["permission"] == 2
+	assert _try_load_dict_from_text('{\n // c\n "permission": 3\n} ')["permission"] == 3
+	assert _try_load_dict_from_text("permission: 4\nmotd_start_day: '2020-01-01'\n")["permission"] == 4
+
+
 if __name__ == "__main__":
 	fns = [v for k, v in sorted(globals().items()) if k.startswith("test_") and callable(v)]
 	failed = 0