Over Enchant

<details> <summary>README(简体中文）</summary> # OverEnchanted（超限附魔） > 这是一个面向有开发能力的 Paper 服主的插件原型，提供“超限附魔”玩法：用**魔法符文** + **超限魔法核心** + 一堆材料，在专门的“超限附魔台”上将物品打上不兼容/超出最大等级限制的附魔/在此基础上继续提升某项附魔等级。 > **本插件并非开箱即用** — 它假定你你的主世界最低高度低于-64并且玩家有能力进入并在那里放置方块（或者你可以自己修改这里的逻辑，详见“重要限制与开发提示”）。 --- ## 玩法： - 玩家手持附魔台，右键一个满级的，有效果的，激活的信标，获得一个超限附魔台物品 - 将超限附魔台放置到**Y<-64**的位置，然后右键打开超限附魔台界面 - 在此界面中可以消耗指定的材料与**魔法符文（通过在高炉中熔炼附魔书获得）**与**超限附魔核心（通过打开某些战利品箱子或者玩家击杀某些怪物概率获得）**对物品进行超限附魔 --- ## 主要功能 * **GUI 栈式配置界面**：基于字符串布局创建箱子菜单，支持点击切换附魔、实时检查兼容性、显示材料需求与成功率。 * **魔法符文（Rune）**：通过熔炼附魔书（高炉/BlastingRecipe + 事件处理）得来，保存其附魔（附魔原生展示，不隐藏），并保留符文等级（PDC）。 * **超限魔法核心（Core）**：通过战利品/生物掉落插入，可配置概率；物品材质为木炭（Charcoal），带 glint。 * **超限附魔台（放置型）**：把超限附魔台物品放置到世界后，会把 ItemStack 的 PDC 转储到方块 TileState 中；右键该方块打开 GUI（要求玩家处于 Y < -64）。 * **磨石净化**：可用磨石移除符文上的附魔（但符文等级与标识保留）。 * **战利品注入与生物掉落**：通过配置控制容器 loot table 与指定生物的掉落概率（使用 `setLoot`/`EntityDeathEvent`）。 * **安全与 UX**： * GUI 关闭时会把玩家放入的所有物品返还（优先塞背包，背包满则掉落脚下）。 * 阻止把附魔书塞进目标物品槽。 * shift-click 等行为被限制以避免绕过校验。 * **外观**：所有特殊物品在 `editMeta{}` 中设置 `it.setEnchantmentGlintOverride(true)`（强制光效）；魔法符文原生显示附魔，lore 仅写符文等级。 --- ## 适用环境/要求 * **服务器**：PaperMC （建议 1.21.x 及以上，**不兼容spigot**）。 * **JDK版本**：>= 21。 * **极重要（必须注意）**：世界最低高度需要小于-64 * 如果你的地图/服务端无法把玩家带到 Y < -64，**你必须修改代码或配置**（见下方“开发者提示”）。 * 本插件**面向有开发能力的服主**：若你不知道或者不愿意增加世界高度上下限或改代码，请慎用。 --- ## GUI/插件玩法细节 * **界面布局**： ``` ###ABC### # # # # #R##I##S# ####O#### ``` （空格代表空格槽位） * **槽位说明**： * ITEM（左上空位，主要物品槽）—— 放入要被超限附魔的物品（不允许附魔书） * RUNES（中上3个空位）—— 放魔法符文 * CORE（右上空位）—— 放超限魔法核心（即使没有符文，也至少需要 1 个核心） * MATERIALS（下方所有槽位）—— 放需要消耗的材料（I 槽会显示需求） * **信息显示**： * R（附魔列表）—— 列出物品与（有附魔的）符文上的附魔，左键循环选中 * A/B/C（检查位）—— 显示兼容性检查（Green/Red 标示，每多一条不兼容，所有材料消耗数量增加） * S（核心需求）—— 显示当前需要的核心数量（每次界面刷新/点击都会更新） * O（结算）—— 显示成功率并用于尝试结算（点击时会再次进行完整检查） * **成功率计算**： * 每个 1 级符文 +2.5%，每个 2 级符文 +5%，每个 3 级符文 +7.5%； * 每个超限魔法核心 +2.5%； * 每满足一种材料需求 +2%； * 上限 100%。 * **结算行为**： * 成功：消耗全部材料，应用超限结果： > - 若选中来自符文的附魔，则强制把符文上的附魔写到物品上 > - 若选中物品上附魔，则该附魔等级 +1 * 失败：保留原物品与**一半**超限魔法核心，其他材料全部消耗 * **其他 UX**： * 放入物品后关闭界面，不会丢失物品：所有投入在关闭时会返还玩家（若背包满则掉落在玩家脚下）。 * 符文在磨石（Grindstone）可以净化（移除附魔但保留符文等级 & PDC），净化后的符文仍然提供核心需求/成功率，但不会贡献可选附魔项（R 列表会忽略无附魔的符文）。 * 特殊物品都已在 `editMeta{}` 中设置 `it.setEnchantmentGlintOverride(true)`（强制光效）；魔法符文会**原生显示附魔**（无隐藏），lore 只显示符文等级。 --- ## 开发者提示 本插件**强依赖**“世界最低高度小于-64且玩家能到达”，如果你的世界无法把玩家带到该高度，下面是常见的三种处理方式（任选一种）： ### A. 增加一个调整世界高度下限的数据包（最简单） ### B. 修改代码并重新编译（去掉或调整高度检查） 修改 `me.axiumyu.overEnchanted.table.OverEnchantedTableBlockListener` 中的检查： ```kotlin // 当前代码（严格要求 y < -64） if (p.location.y >= -64.0) { p.sendMessage(MM.c("<red>需要在深层（Y < -64）使用 <aqua>超限附魔台</aqua></red>")) return } // 把 `-64.0` 改成你服务器的可达高度。（或者直接注释掉这四行） /* // remove or change threshold // if (p.location.y >= -64.0) { ... } */ ``` ### C. 为没有开发经验的服主：请找会 Kotlin/Java 的同伴帮忙 如果你不会改代码但想要在标准世界里用此插件，找一个熟悉 Paper 插件的小伙伴会比反复折腾配置来得快。 --- ## 热重载配置示例 * 插件内部有 `LootConfig.reload()` 方法，因为我没有这样的需求，所以当前没有暴露成命令。你可以快速加一个命令来调用它，例如在 `onEnable()` 中注册一个简单的 `/overenchanted reload`（示例伪代码）： ```kotlin // 伪代码：在 plugin.onEnable() getCommand("oereload")?.setExecutor { sender, _, _, _ -> LootConfig.reload() sender.sendMessage("OverEnchanted config reloaded") true } ``` --- ## 文件/类一览（供开发者定位修改） * `me.axiumyu.overEnchanted.OverEnchantedPlugin` — 主类（onEnable 注册） * `me.axiumyu.overEnchanted.items.OEItems` — 魔法符文 / 核心 / 台 的 ItemStack 工厂 * `me.axiumyu.overEnchanted.items.RuneSmeltListener` — 高炉熔炼附魔书 -> 符文（配合 Recipes.register） * `me.axiumyu.overEnchanted.items.RuneGrindstoneListener` — 磨石净化符文 * `me.axiumyu.overEnchanted.recipes.Recipes` — 注册 BlastingRecipe（占位） * `me.axiumyu.overEnchanted.menu.OEMenu*` — 菜单视图与监听、逻辑（S/R/ABC/O 等） * `me.axiumyu.overEnchanted.table.OverEnchantedTableBlockListener` — 放置台时把 PDC 写入 TileState；右键打开 GUI（含 Y 检查） * `me.axiumyu.overEnchanted.loot.*` — `LootConfig` / `LootInsertListener` / `CoreMobDropListener` * `me.axiumyu.overEnchanted.util.MM` — 文本序列化（自动在最前面加 `<!i>` 以取消斜体） --- ## 常见问题 **Q：玩家丢失放入的物品？** A：已修复 —— 界面关闭（玩家主动关闭 / 断线需另加处理）时会把投入物品返还或掉落脚下。 **Q：为什么高炉熔炼附魔书不起作用？** A：插件在 `onEnable()` 注册了一个 `BlastingRecipe`（占位），并在 `FurnaceSmeltEvent` 中把真正的符文/附魔转移到符文上。若你在一个极端化的服务端实现下（自定义 Furnace 行为），可能需要检查服务器日志或自定义适配。 **Q：我不想要 Y < -64 限制** A：见“开发者提示”，修改 `OverEnchantedTableBlockListener.onRightClick` 中的高度判断。 **Q：为什么不使用现成的第三方库** A：因为我服用不到，未来如果需要可能会考虑重写，目前没有打算 --- ## 面向服主的免责声明 * 本插件**默认设计为需要能访问 Y < -64 的世界**。如果你的服务器世界不可达该高度，请**自行修改代码或征求开发者帮助**。 * 插件目前为一个功能完整且偏向个人使用，但仍需测试与调优的实现；**针对服主有开发能力**，建议在测试服充分测试后再放到生产服。 </details> <details> <summary>README(English)</summary> > OverEnchanted is a prototype Paper plugin aimed at server owners with development ability. It implements an “over-enchanting” system: use Magic Runes + OverEnchanted Cores + a pile of materials on a special OverEnchanted Table to apply incompatible or over-maxed enchants, or to further raise an existing enchant’s level. > Not plug-and-play. The plugin assumes your overworld minimum height is below Y = -64 and that players can access a