Over Enchant

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper purpur

标签： equipment

README(简体中文） # OverEnchanted（超限附魔） > 这是一个面向有开发能力的 Paper 服主的插件原型，提供“超限附魔”玩法：用**魔法符文** + **超限魔法核心** + 一堆材料，在专门的“超限附魔台”上将物品打上不兼容/超出最大等级限制的附魔/在此基础上继续提升某项附魔等级。 > **本插件并非开箱即用** — 它假定你你的主世界最低高度低于-64并且玩家有能力进入并在那里放置方块（或者你可以自己修改这里的逻辑，详见“重要限制与开发提示”）。 --- ## 玩法： - 玩家手持附魔台，右键一个满级的，有效果的，激活的信标，获得一个超限附魔台物品 - 将超限附魔台放置到**Y= 21。 * **极重要（必须注意）**：世界最低高度需要小于-64 * 如果你的地图/服务端无法把玩家带到 Y - 若选中来自符文的附魔，则强制把符文上的附魔写到物品上 > - 若选中物品上附魔，则该附魔等级 +1 * 失败：保留原物品与**一半**超限魔法核心，其他材料全部消耗 * **其他 UX**： * 放入物品后关闭界面，不会丢失物品：所有投入在关闭时会返还玩家（若背包满则掉落在玩家脚下）。 * 符文在磨石（Grindstone）可以净化（移除附魔但保留符文等级 & PDC），净化后的符文仍然提供核心需求/成功率，但不会贡献可选附魔项（R 列表会忽略无附魔的符文）。 * 特殊物品都已在 `editMeta{}` 中设置 `it.setEnchantmentGlintOverride(true)`（强制光效）；魔法符文会**原生显示附魔**（无隐藏），lore 只显示符文等级。 --- ## 开发者提示 本插件**强依赖**“世界最低高度小于-64且玩家能到达”，如果你的世界无法把玩家带到该高度，下面是常见的三种处理方式（任选一种）： ### A. 增加一个调整世界高度下限的数据包（最简单） ### B. 修改代码并重新编译（去掉或调整高度检查） 修改 `me.axiumyu.overEnchanted.table.OverEnchantedTableBlockListener` 中的检查： ```kotlin // 当前代码（严格要求 y = -64.0) { p.sendMessage(MM.c("需要在深层（Y 超限附魔台")) 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` — 文本序列化（自动在最前面加 `` 以取消斜体） --- ## 常见问题 **Q：玩家丢失放入的物品？** A：已修复 —— 界面关闭（玩家主动关闭 / 断线需另加处理）时会把投入物品返还或掉落脚下。 **Q：为什么高炉熔炼附魔书不起作用？** A：插件在 `onEnable()` 注册了一个 `BlastingRecipe`（占位），并在 `FurnaceSmeltEvent` 中把真正的符文/附魔转移到符文上。若你在一个极端化的服务端实现下（自定义 Furnace 行为），可能需要检查服务器日志或自定义适配。 **Q：我不想要 Y README(English) > 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 and place blocks there (or you can modify the code). See the Developer Notes section. --- ## How to play - Right click an activated, effect chosen and full-level beacon with an enchanting table to obtain an OverEnchanted Table - Place OverEnchanted Table **under world Y level -64**, right click it to open GUI - consume some materials, **enchantment rune(get by blasting any enchantment book in blast furance)** and **OverEnchant Core(can be found in any configurated loot chests or mob that killed by player)** to upgrade enchantments of item ## Highlights/Features - GUI menu (inventory) created from a string layout — click to cycle enchants, run compatibility checks, show required materials and success chance. - Magic Runes: created by smelting enchanted books (BlastingRecipe + event). Runes keep their enchants (shown natively, not hidden) and have a rune level saved in PDC. - OverEnchanted Cores: inserted into loot or dropped by configured mobs; material = CHARCOAL, with forced glint. - OverEnchanted Table (placeable): when placed, the ItemStack PDC is stored into the block’s TileState. Right-clicking that placed block opens the GUI. (Requires player Y - if selected enchant is from rune, that rune’s enchants are applied to the item forcely > - if selected enchant is from item, that enchant’s level is incremented by 1) - Failure: original item is kept; half of the cores (rounded down) remain; all other materials are consumed ## Other behavior Items put into the GUI are returned when the GUI is closed. If player inventory is full, they drop at the player’s feet. Grindstone can purify runes (removes enchants but keeps rune level and PDC); purified runes still affect core requirement and success chance, but do not contribute enchants to the R list. Special items have forced glint (setEnchantmentGlintOverride(true)). Magic Runes natively display enchants; lore only shows rune level. ## Developer Notes The plugin depends on players being able to go to Y = -64.0) { p.sendMessage(MM.c("需要在深层（Y 超限附魔台")) return } // Change -64.0 to the height you want, or remove the four lines entirely to disable the check. (You may prefer to make the threshold configurable via config.yml.) C. If you cannot code: ask a Kotlin/Java developer for help If you’re not comfortable changing plugin code and your world can’t reach Y LootConfig.reload() sender.sendMessage("OverEnchanted config reloaded") true } (Implement command handling according to your command framework.) ## Files / Classes me.axiumyu.overEnchanted.OverEnchantedPlugin — main class (onEnable registers components) me.axiumyu.overEnchanted.items.OEItems — factories for Magic Runes / Cores / Table ItemStacks me.axiumyu.overEnchanted.items.RuneSmeltListener — blasting smelt of enchanted books → runes (works with Recipes.register()) me.axiumyu.overEnchanted.items.RuneGrindstoneListener — grindstone purification of runes me.axiumyu.overEnchanted.recipes.Recipes — registers the BlastingRecipe placeholder me.axiumyu.overEnchanted.menu.OEMenu* — menu view, listener, logic (R / A B C / S / I / O) me.axiumyu.overEnchanted.table.OverEnchantedTableBlockListener — stores ItemStack PDC into TileState when placing table; right-click to open GUI (with Y check) me.axiumyu.overEnchanted.loot.* — LootConfig, LootInsertListener, CoreMobDropListener me.axiumyu.overEnchanted.util.MM — text serializer (prepends to cancel italics) ## FAQ Q: Items placed in the GUI are disappearing — fixed? A: Yes — GUI close now refunds items. (If you want refunds on player quit or plugin disable, add PlayerQuitEvent or onDisable handling.) Q: Smelting enchanted books in a blast furnace does nothing? A: The plugin registers a BlastingRecipe placeholder in onEnable(). The real rune creation happens in FurnaceSmeltEvent. If your server has custom furnace behavior, adapt accordingly. Q: I don’t want the Y