IGNGMedals 勋章称号插件教程

IGNGMedals 是 IGNG 服务器的个人综合荣誉与生涯档案系统。它如同一张专属的“玩家名片”，自动记录你在 IGNG 旗下各个服务器的游玩足迹、累计时长、官方颁发的成就勋章，并允许你展示专属的个性化头衔。

核心概念：这个系统是干什么的？

在游戏内，你随时可以打开履历面板查看自己的“游戏生涯”：

累计游玩时长：精准统计你在所有 IGNG 子服务器的在线与探索时间；
官方成就勋章：由服务器管理员或活动颁发的官方荣誉（如开荒先锋、建筑大赛优胜、社区杰出贡献等）；
个人自定义头衔：你为自己设定的个性展示名称；
非刷屏设计：本插件专注于个人荣誉档案展示，不占用聊天框前缀或头顶称号，随时输入指令即可优雅呼出。

一、查看个人与他人荣誉档案

1. 查看自己的履历

在聊天框中输入以下任意指令：

/medal

(或别名 /medals)

系统会立即打开你的个人专属荣誉档案界面。

2. 瞻仰其他玩家/好友的档案

想了解服务器里的大佬玩了多久、拿过什么稀有勋章？直接输入对方的 Minecraft 游戏名：

/medal <玩家游戏名>

示例：/medal Steve
支持离线查询：对方无需在线，只要曾经进入过服务器即可随时查阅。

3. 档案界面怎么看？

打开档案面板后，你将看到以下主要板块：

界面板块	内容说明	交互方式
⏱️ 游玩时长	显示你在整个 IGNG 服务器群累计的在线总时长	点击可展开查看你在各个子服务器的分项时长
🌟 全服综合勋章	跨越所有子服的全局性官方荣誉勋章	点击可进入勋章列表查看每枚勋章的详细信息
🏷️ 自定义头衔	你当前设置的个性化展示名称	纯展示，可在聊天框中使用指令修改
🏰 服务器分服卡片	对应子服（如周目服、生存服）的专属时长与专属勋章	点击可进入该子服的专属勋章馆查看详情

勋章详情：在勋章列表中点击任意一枚已解锁的勋章，可以查看它的获得时间、授予人以及官方颁发理由！

二、设置个性化自定义头衔（Custom Medal）

除了官方授予的荣誉勋章外，每位玩家都可以为自己设置一个独一无二的个性展示头衔！

设置方法

输入命令：

/medal custom <你的头衔名称>

示例与规则

示例 1：/medal custom 资深红石建筑师
示例 2（支持空格）：/medal custom 古代遗迹首席考古官

命名规范：

字符长度：支持 1 ~ 32 个字符；
纯文本设计：禁止换行、特殊控制字符，不解析颜色代码（如 &c、§a）或标签，以保证界面清爽美观；
文明用语：自定义头衔对所有玩家公开可见，请遵守服务器文明交流规范；
提示：自定义头衔是你的个性名片，不会替代由官方权威评定的成就勋章。

三、官方成就勋章如何获取？

官方成就勋章是 IGNG 社区的最高荣誉见证，分为两类：

全服综合勋章：针对全平台重大贡献或全服活动的成就（例如“IGNG 早期拓荒者”、“MOD 开发者”）；
分服专属勋章：针对某个具体子服或周目的专属纪念（例如“纯净服 S1 完结纪念”、“建筑大赛一等奖”）。

获取方式：官方勋章由服务器管理员在后台评定或在特定社区活动结束后统一授予。授予后即刻写入云端档案，无需重启服务器，玩家在游戏内重新输入 /medal 即可点亮新勋章！

四、常见问题解答（FAQ）

Q1：为什么我输入 /medal <玩家名> 提示找不到玩家？

请检查对方的 Minecraft 英文游戏名是否拼写正确。该玩家需要至少进入过一次服务器并完成注册。

Q2：自定义头衔为什么不支持彩色文字？

为了保证全服档案界面的统一视觉风格与严肃性，防止恶意遮挡或伪造官方勋章标识，自定义头衔统一采用标准高亮纯文本渲染。

Q3：游玩时长是如何统计的？如果服务器突然掉线会丢失时间吗？

插件会在玩家在线期间定期自动保存游玩进度，并在玩家正常下线时精确结算。即便遇到偶发断线或服务器重启，系统也会自动恢复最近的同步节点，无需担心时长丢失。