SpellCraft – Magic World Lessons Addon

Arcanum Lessons

将 Arcanum 咒语学习变成课程。通过一条命令和两种任务奖励物品，你可以一次授予一个咒语——永久授予，或在课堂练习期间临时授予——还可以用命令发放魔法等级和经验值。本模组专为任务模组设计：完成课程，赢得咒语。

基础版 Arcanum 只能通过咒语桌（材料 + 经验值）教授咒语，而且命令只能一次性授予或移除全部咒语。Arcanum Lessons 增加了霍格沃茨风格成长体系所需的单个咒语控制功能，并能立即让客户端同步（无需重新登录）。

命令

/arcanumlesson ...（需要权限等级 2，因此以管理员身份运行的任务模组可以使用）：

grant <players> <spell> — 永久教授一个咒语。

temp <players> <spell> [seconds] — 临时授予一个咒语（供学生在课程期间练习）；时间到后会自动移除。

revoke <players> <spell> — 移除单个咒语（基础版 Arcanum 只能“忘记全部”）。

addlevel <players> [amount] — 提升玩家的魔法等级（默认 1 级）。

addxp <players> <amount> — 授予原始魔法经验值。

grantall / forgetall / list — 便捷快捷命令。

<spell> 参数会自动补全所有 Arcanum 咒语 ID（wingardium_leviosa、expelliarmus、…）。

物品（任务奖励）

目标咒语会存储在物品的 Spell NBT 标签中，因此任务可以发放预先配置好的物品，例如 /give @p arcanum_lessons:diploma{Spell:"wingardium_leviosa"}。创造模式物品栏中已为每个咒语准备好一份文凭和一张练习卷轴，可直接发放。

文凭 — 使用后永久学会对应咒语（物品会被消耗）。

练习卷轴 — 临时授予对应咒语（使用物品的 Seconds 标签，或配置中的默认时长），供课程期间练习。它确实会教授该咒语，因此能够原生使用——咒语会显示在咒语菜单中，可供选择和施放——并会在计时结束后移除。

禁忌咒语

黑魔法和不可饶恕咒不会在学校里教授，因此它们的解锁物品以特定的黑暗来源为主题，而非学校文凭（并以深红色显示）；每种物品都有自己的纹理：

Salazar Slytherin 的档案 — 不可饶恕咒（Avada Kedavra、Imperio、Crucio）。

Half-Blood Prince 的日记 — Sectumsempra（Snape 的独创咒语）。

Grindelwald 的日记 — Protego Diabolica 咒语（他的招牌黑色火焰）。

黑魔法典籍 — 其余黑魔法（Fiendfyre、Umbravolo、…）。

基础版 Arcanum 中较弱的 protego_diabolica 会显示为“文凭：…（练习）”，以区别于 Grindelwald 的真正版本。

推荐的霍格沃茨流程

开始课程任务 → 用 temp 临时授予咒语（学生进行练习）→ 完成课程 → 发放文凭（或使用 grant），使咒语永久保留；再用 addlevel 提升等级。

兼容性与说明

Arcanum（必需）。兼容任何能够运行命令或发放物品的任务模组（FTB Quests、Heracles、MeBahel RPG、…）。

配置：defaultTempSeconds（默认 300）— 临时授予的备用持续时间。

临时授予计时器保存在内存中；如果临时授予持续时间超过服务器重启时间，它就会变成永久授予（短时课堂练习不受影响）。