玩家快速指南

1. 插件简介

LIEMC 是一个基于 EMC 的资源兑换插件，核心流程是：

1. 玩家通过“转换”界面出售物品获得 EMC。
2. 玩家在“获取”界面消耗 EMC 取出物品。
3. 服务器可选择是否启用“先解锁再取出”机制。

当前默认：开启解锁机制（unlock.require-before-withdraw: true）。

2. 基础指令

• /liemc 或 /emc：打开主界面。
• /liemc reload：重载配置（管理员）。
• /liemc give <玩家> <数量>：发放 EMC（管理员）。
• /liemc giveall <数量>：全服发放 EMC（管理员）。
• /liemc unlockall <玩家>：为目标玩家解锁全部物品（管理员）。
• /liemc stats：查看 EMC 物品统计（管理员）。

3. 解锁机制说明（默认开启）

当 unlock.require-before-withdraw: true 时：

1. 玩家第一次需要先在“转换界面”卖出该物品。
2. 系统自动记录该物品为“已解锁”。
3. 之后玩家可在“获取界面”中正常取出该物品。

若未解锁直接取出，会收到“该物品未解锁”的提示。

4. 经济来源

可在 config.yml 的 currency.provider 中切换：

• internal：插件内置经济（默认）。
• vault：对接 Vault 经济插件。
• playerpoints：对接 PlayerPoints 点券。

5. 常见服主配置

1. 慢节奏/生存服：保持 require-before-withdraw: true。
2. 快节奏/空岛服：可改为 false，降低门槛。
3. 新手服：建议配合较低 EMC 单价和清晰菜单引导。

6. 常见问题

• 看不到某个物品： 可能该物品未加入 items，或物品 ID/材质名填写不正确。

• 提示未解锁： 先去转换界面卖出一次对应物品，或让管理员执行 unlockall。

• 重载后配置没变化： 使用 /liemc reload，并确认修改的是插件实际使用的 config.yml。

7. 版本与兼容

• 基准运行环境：Paper 26.1.2
• 插件端遵循 Bukkit 标准写法，并预留 Vault、PlaceholderAPI 兼容。