开源 工具 [1.21+]较高制作门槛双向定点传送亭——MagicTeleport V1.0.0

本插件已开源，完全依赖DeepSeek-V41-Flash开发​

我说句实话，这个插件大部分功能我没测试，只试用了传送功能，如果有bug请联系我，我去抽大肥鱼，上回爆金币给我爆了不少够维护了。​

如对AI制作插件有不满的开发者请回避一下，个人在这里感到抱歉
单纯做服务器的时候突然冒出来个点子，让我省不少建筑的事，似乎可以实现肉鸽那种房间之间的传送之类的
亭子的模板已插入，按ds的想法应该不必非得长这样：

DS:把眼前这个 3×3×6 逐格录成模板存进配置。之后所有隧道按这个模板比对。好处：不用你写 54 格表格；以后想改样子，重搭一个再录一次就行；"一模一样"天然满足

如是说，也就是本体插件至少得有个哭泣黑曜石

【适用】Paper 1.21+ ｜ Java 21+
【前置】无（金币收费需 Vault + 经济插件，可选）

一、玩法
1. 搭建一座 3×3×6 的亭子，底面中心放"核心方块"（默认 强化深板岩）。
核心方块可以在 config 里换：/magicteleport block <方块>
2. 由管理员建造模板传送亭后把其中一座亭子录成服务器模板：
站在核心方块上执行 /magicteleport template set
（控制台：/magicteleport template set <世界> <x> <y> <z>）
3. 允许玩家在该世界创建通道：/magicteleport createallow true <世界>
4. 玩家执行 /magicteleport add 进入绑定模式，用木棍依次右键两座亭子的核心方块，
通道即创建成功；之后右键核心方块、站在上面不动，读秒结束就会传到对面。

二、核心机制
· 结构校验：插件按录制的模板逐格比对 3×3×6 的 54 格，差一格都不认（任何造型都能用，录一次即可）
· 核心方块：既是"绑定/传送的触发点"，也是"落点锚点"和"通道代表点"；模板里核心格存为占位符，
所以换核心方块后模板依然有效
· 读秒取消：读秒期间必须站在那块核心方块上，离开或换世界立即取消
· 权限：通道主人可设置是否允许他人；未获许可者会在读秒结束后收到"你没有权限进行隧穿"
· 收费：可设多种物品（每种最多 1 组）+ 金币；主人免费；物品进主人用木棍左键选定的箱子/木桶，
金币经 Vault 直接转给主人
· 上限：默认每人 4 条，可购买（金币）或用 VIP 等级额度（接口已留，未接 VIP 系统）

三、命令
玩家：
/magicteleport 打开管理界面（54 格）
/magicteleport add 进入/退出绑定模式（木棍右键两个核心方块）
/magicteleport delete 删除模式（点通道 → 再确认）
/magicteleport items [编号] 设置收费物品（每种≤64）
/magicteleport container [编号] 用木棍左键箱子/木桶作为收费容器
/magicteleport buy [confirm] 用金币购买一个通道上限
/magicteleport info 查看自己的通道
/magicteleport setallow <编号> <true|false>
管理（magicteleport.admin）：
/magicteleport amount <n> 每人通道上限（默认 4）
/magicteleport time <秒> 传送读秒（默认 3）
/magicteleport sell <true|false> 是否允许金币买上限（默认 false）
/magicteleport price <金币> 买一个上限的价格（默认 0）
/magicteleport charge <true|false> 使用通道是否收费（默认 false）
/magicteleport vipallow VIP 接口（占位）
/ vipamount VIP 接口（占位）
/magicteleport createallow <true|false> [世界] 某世界是否允许创建通道
/magicteleport block <方块> 更换核心方块
/magicteleport template set [世界 x y z] 录制结构模板
/magicteleport admin create <主人> <世界> <x1 y1 z1> <x2 y2 z2> 控制台建通道
/magicteleport admin validate <世界> <x> <y> <z> 校验某结构是否与模板一致
/magicteleport admin container <编号> <世界> <x> <y> <z>
/magicteleport reload 重载配置/数据/语言

四、权限
magicteleport.use 默认所有人 使用界面、绑定与传送
magicteleport.admin 默认 OP 所有管理命令（同时绕过上限、权限与收费）

五、安装
1. 把 magic-teleport-1.0.0.jar 放进 plugins/，启动服务器
2. 生成 plugins/MagicTeleport/{config.yml, tunnels.yml, lang/}
3. 按"一、玩法"的 1~4 步录模板、放权限，即可让玩家使用
4. 语言在 config.yml 的 lang 里切（en_US / zh_CN），改完 /magicteleport reload

六、说明与边界
· 不依赖 NMS / ProtocolLib，不改客户端，纯服务端原版方块与粒子
· GUI 只能手动点击（没有指令替代收费物品编辑）
· 结构校验按方块类型判断（不校验 slab 上下半砖这类状态）
· 若服务器有"禁止方块交互"的保护插件（主城锁等），需要把核心方块加白名单，
可用插件的静态方法：MagicTeleport.isTunnelCore(block)

七、许可
GPL-3.0 ｜ 仓库：https://github.com/Hongju613/magic-teleport