Over Enchant

插件

· 作者 Axiumyuyu

允许玩家公平地制作超级附魔物品

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)
README(简体中文)

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 中的检查:

// 当前代码(严格要求 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(示例伪代码):
// 伪代码:在 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 的世界。如果你的服务器世界不可达该高度,请自行修改代码或征求开发者帮助。
  • 插件目前为一个功能完整且偏向个人使用,但仍需测试与调优的实现;针对服主有开发能力,建议在测试服充分测试后再放到生产服。
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:插入战利品或由配置好的怪物掉落;材质为 CHARCOAL,并强制显示附魔光效。

  • OverEnchanted Table(可放置):放置后,ItemStack 的 PDC 数据将存储到方块的 TileState 中。右键点击该已放置的方块即可打开 GUI。(需要玩家 Y 坐标 < -64。)

  • 砂轮净化:砂轮可以从符文上移除附魔,同时保留符文等级和 PDC 数据。

  • 战利品注入与怪物掉落:通过配置文件控制;容器战利品使用 setLoot,怪物掉落使用 EntityDeathEvent。

安全性与用户体验 (UX):

  • 放入 GUI 的物品在关闭 GUI 时会退回(尝试放回玩家背包;如果背包已满则掉落至地面)。

  • 无法将附魔书放入目标物品槽位。

  • 限制 Shift-click(快速移动)行为,以防止绕过检查机制。

视觉效果:所有特殊物品在 editMeta{} 中设置 it.setEnchantmentGlintOverride(true)(强制显示附魔光效);Magic Runes 原生显示附魔信息,且仅在背景文本(lore)中显示符文等级。

要求 / 环境

  • 服务端:PaperMC(推荐 1.21.x+)。使用 Paper API(例如 Enchantment.getAnvilCost() 以及 TileState/PDC)。

  • 构建:Kotlin + Gradle(项目源代码为 Kotlin)。

  • 重要的运行时要求:玩家必须能够到达 Y < -64 的位置(严格小于 -64)。插件在允许打开 OverEnchanted Table GUI 之前会严格检查玩家的 Y 坐标。

  • 如果你的世界不允许这样做,你可以简单地添加一个允许在此高度建造的数据包,或者修改代码(参见开发者说明)。

  • 本插件旨在供能够修改代码或服务器数据的服主使用。如果你无法修改世界设置或代码,本插件可能不适合你。

GUI / 游戏细节

布局:

###ABC###
# #   # #
#R##I##S#
         
         
####O####

槽位说明

  • ITEM — 主要物品槽位(目标物品)。不允许放入附魔书。

  • RUNES(3 个槽位)— 放置 Magic Runes(净化的符文仍保留符文等级和 PDC 数据)。

  • CORE(1 个槽位)— OverEnchanted Cores(即使没有符文,也至少需要 1 个核心)。

  • MATERIALS(下方槽位)— 其他所需材料;I 槽位显示所需列表。

  • R — 由物品及任何带有附魔的符文编译而成的附魔列表;左键点击轮换选择。

  • A / B / C — 兼容性检查(绿色/红色指示器)。

  • S — 核心需求显示(每次刷新/点击时更新)。

  • O — 解析/执行按钮(显示成功率;点击进行最终验证并尝试附魔)。

成功率计算

每个符文:等级 1 → +2.5%;等级 2 → +5%;等级 3 → +7.5%。

每个 OverEnchanted Core → +2.5%。

每个满足的材料要求 → +2%。

最高 100%。

解析结果

  • 成功:消耗所有材料,应用超限附魔:
  • 如果选择的附魔来自符文,则该符文的附魔将被强制应用到物品上
  • 如果选择的附魔来自物品,则该附魔的等级增加 1
  • 失败:保留原始物品;一半的核心(向下取整)保留;所有其他材料被消耗

其他行为

放入 GUI 的物品在关闭 GUI 时会退回。如果玩家背包已满,它们将掉落在玩家脚边。

砂轮可以净化符文(移除附魔但保留符文等级和 PDC 数据);净化的符文仍然影响核心需求和成功率,但不向 R 列表贡献附魔。

特殊物品具有强制光效(setEnchantmentGlintOverride(true))。Magic Runes 原生显示附魔;背景文本仅显示符文等级。

开发者说明

插件依赖于玩家能够前往 Y < -64 的位置。这是有意的设计/安全选择。如果你的服务器上无法做到这一点,你有以下选项:

A. 安装允许在 -64 以下建造的数据包。

你可以搜索类似 "height" 的数据包。

B. 修改代码(移除或更改高度检查)

编辑 me.axiumyu.overEnchanted.table.OverEnchantedTableBlockListener,其中插件检查玩家 Y 坐标:

// 当前(严格的 Y < -64 要求) if (p.location.y >= -64.0) { p.sendMessage(MM.c("<red>需要在深层(Y < -64)使用 <aqua>超限附魔台</aqua></red>")) return }

// 将 -64.0 更改为你想要的高度,或者完全删除这四行以禁用检查。

(你可能更倾向于通过 config.yml 使阈值可配置。)

C. 如果你不会编程:请求 Kotlin/Java 开发者的帮助

如果你不擅长修改插件代码,且你的世界无法达到 Y < -64,请寻求帮助,本插件面向的是能够适应它的服主。

热重载示例

插件在内部暴露了 LootConfig.reload()。如果你想添加一个快速重载命令,可以添加如下内容:

// plugin.onEnable() 中的伪代码 getCommand("oereload")?.setExecutor { sender, _, _, _ -> LootConfig.reload() sender.sendMessage("OverEnchanted config reloaded") true }

(根据你的命令框架实现命令处理。)

文件 / 类

me.axiumyu.overEnchanted.OverEnchantedPlugin — 主类(onEnable 注册组件)

me.axiumyu.overEnchanted.items.OEItems — Magic Runes / Cores / Table ItemStacks 的工厂方法

me.axiumyu.overEnchanted.items.RuneSmeltListener — 附魔书熔炼为符文的工作流程(与 Recipes.register() 配合使用)

me.axiumyu.overEnchanted.items.RuneGrindstoneListener — 砂轮的符文净化功能

me.axiumyu.overEnchanted.recipes.Recipes — 注册 BlastingRecipe 占位符

me.axiumyu.overEnchanted.menu.OEMenu* — 菜单视图、监听器和逻辑(R / A B C / S / I / O)

me.axiumyu.overEnchanted.table.OverEnchantedTableBlockListener — 放置桌子时将 ItemStack PDC 存储到 TileState;右键点击打开 GUI(带 Y 坐标检查)

me.axiumyu.overEnchanted.loot.* — LootConfig, LootInsertListener, CoreMobDropListener

me.axiumyu.overEnchanted.util.MM — 文本序列化器(在斜体前添加 以取消斜体效果)

常见问题 (FAQ)

问:放入 GUI 的物品消失了 — 修复了吗? 答:是的 — 关闭 GUI 现在会退还物品。(如果你希望在玩家退出或插件禁用时也能退还,请添加 PlayerQuitEvent 或 onDisable 处理逻辑。)

Q:在高炉中熔炼附魔书没有任何效果? A:插件在 onEnable() 阶段注册了一个 BlastingRecipe 占位符。真正的符文生成发生在 FurnaceSmeltEvent(熔炉熔炼事件)中。如果你的服务器有自定义的熔炉行为,请相应地进行调整。

Q:我不想要 Y < -64 的限制 A:请参阅开发者说明 B —— 编辑 OverEnchantedTableBlockListener.onRightClick 以修改或移除高度检查。

Q:为什么没有使用第三方库? A:目前保持最小化;如果后续需要,会考虑引入外部库。

免责声明(面向服务器管理员)

本插件假定玩家可以访问 Y < -64 的区域。如果你的服务器不允许这样做,你必须修改代码/配置或寻求开发者帮助。

该插件是一个功能完整的原型,但仍需进行测试和调整。它旨在供能够编辑和测试代码的服务器管理员使用。请在部署到正式服之前先在测试服上进行测试。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源