WarpStones

插件

· 作者 cripwalktutorial

适用于 1.21.X 的插件,添加了一个“传送菜单”系统,支持完全自定义的传送石!

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

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

我的插件页面的页眉/封面

关于

WarpStones 是一款适用于 Minecraft 1.21.X 的 Paper 插件,它引入了一套完全自定义的传送点系统,核心是一个个人 Warp-Menu(传送菜单) —— 每个玩家都持有一个指南针物品,用于打开自己的 GUI。玩家收集 Warp Stones(传送石)(自定义的玩家头颅物品)并将其放入菜单中,以永久解锁 /warp 传送目的地。

每位玩家的进度各不相同:前四个槽位免费,额外的槽位必须通过经济系统购买。拥有相应权限的玩家还可以解锁额外的页面。该插件与 EssentialsX 无缝集成以实现传送功能,与 Vault 集成以支持基于经济的槽位购买,并与 PlaceholderAPI 集成以支持计分板和标签页支持。


特性

? 个人传送菜单 (Warp-Menu)

  • 每位玩家获得一个 传送菜单指南针,可打开其专属的私人 GUI
  • 手持空的传送石右键点击时,会显示目的地的 预览,而无需打开菜单
  • 可选择在首次加入服务器时自动发放,通过 give-menu-on-join 配置
  • 快捷栏槽位可通过 menu-slot 配置

? 传送石 (Warp Stones)

  • 可收集的 玩家头颅物品,具有自定义纹理、名称和描述
  • 每块石头都与特定的 /warp 目的地及可选的 分类 绑定
  • 玩家将石头放入传送菜单即可永久解锁该传送点
  • 支持使用 & 颜色代码进行完全自定义的显示名称和描述,或使用干净的默认值
  • 每块石头可选配 权限节点 以限制使用者(例如 warpstones.use.vip_lounge)
  • 可选配每次传送之间的 冷却时间(秒)

? 槽位系统

  • 第 1 页起始时有 4 个免费解锁的槽位;第 5–8 个槽位需要购买
  • 槽位必须 按顺序解锁 —— 下一个可购买的槽位会显示价格;其他槽位显示“请先解锁上一个”提示
  • 每个页面最多容纳 8 个传送目的地
  • GUI 中的 排序按钮 可一次性将已放置的石头按字母顺序(A→Z)重新排列
  • 收集进度 物品显示当前页面上已放置的石头数量和已解锁的槽位数量

? 多页面支持

  • 玩家可以使用 warpstones.extrapage 权限解锁额外页面
  • 页面总数由 upgrades.yml 定义 —— 没有硬编码限制
  • 上一页/下一页按钮的导航箭头纹理可自定义

⏱️ 传送冷却

  • 通过 cooldown: 字段为每个传送石设置冷却时间(秒)
  • 如果处于冷却状态,玩家会收到一条清晰的剩余时间消息
  • 冷却时间在 GUI 按钮和直接 /warp 命令中均强制执行

✨ 传送特效

  • 每次传送时可配置的 音效 和 粒子 效果
  • 完全可调:声音名称、音量、音调、粒子类型和粒子数量
  • 设置为 "" 可禁用

?️ 分类

  • 为每个传送石分配 category:(例如 Economy、Towns、Resources)
  • 分类会显示在 GUI 中已放置石头的描述里
  • 帮助玩家一目了然地视觉化组织他们的传送点

? GUI 布局

  • 整洁的 54 格 GUI(6 行),石头槽位和操作槽位并排显示
  • 顶部中央有 书本 进度指示器
  • 底部中央有 漏斗 排序按钮
  • 已解锁且已填充的槽位显示传送石头颅和绿色的 Teleport(传送) 按钮
  • 已解锁且空白的槽位显示白色面板和灰色的 Empty Slot(空槽位) 提示
  • 锁定状态的槽位显示红色面板以及 购买按钮 或 “locked(锁定)” 指示器

? 开发者 API

  • 三个 自定义 Bukkit 事件:WarpStoneTeleportEvent、WarpStoneUnlockEvent、WarpStonePlaceEvent —— 均可取消
  • 其他插件可以挂钩到传送、解锁以及放置/移除操作

?️ 管理员命令

  • /warpstones create <id> <warp> —— 生成一个新的传送石配置文件,包含完整的开发者注释
  • /warpstones give menu <player> —— 给予玩家他们的传送菜单
  • /warpstones give warpstone <id> <player> —— 给予玩家特定的传送石
  • /warpstones setwarp <name> —— 在你当前位置设置一个传送点
  • /warpstones info <player> —— 查看玩家已放置的石头、已解锁的槽位和上次使用的传送点
  • /warpstones reset <player> —— 完全重置玩家的 WarpStones 进度
  • /warpstones reload —— 实时重载所有配置和石头定义

工作原理

  1. 获取传送菜单 —— 玩家在加入时获得(如果启用)或通过 /warpstones give menu 获得
  2. 收集传送石 —— 由管理员通过命令分发,或放置在商店/战利品表中
  3. 预览石头 —— 手持时右键点击以查看目的地、分类和说明
  4. 放置石头 —— 打开传送菜单并将石头拖入已解锁的槽位,以永久注册该传送点
  5. 使用 /warp —— 插件会检查玩家是否已放置石头、是否具有所需权限且未处于冷却状态
  6. 排序与整理 —— 点击排序按钮按字母顺序排列已放置的石头
  7. 解锁更多槽位 —— 点击红色的 Unlock Slot(解锁槽位) 按钮购买额外槽位
  8. 扩展到新页面 —— 一旦所有 8 个槽位都已解锁,且玩家拥有 warpstones.extrapage 权限,就会出现下一页箭头

兼容性

依赖项 类型 备注
PaperMC 1.21.X 必需 必须在 Paper 或其分支上运行
EssentialsX 可选 用于 /warp 传送;内置通过 warps.yml 的回退机制
Vault 可选 用于基于经济的槽位解锁成本
PlaceholderAPI 可选 暴露用于计分板和标签页的占位符

PlaceholderAPI

占位符 描述
%warpstones_placed% 玩家当前菜单中已放置的传送石数量
%warpstones_slots_unlocked% 所有页面中已解锁槽位的总数
%warpstones_last_warp% 玩家上次使用的传送目的地

配置亮点

  • give-menu-on-join — 首次加入时自动发放传送菜单
  • menu-slot — 快捷栏中用于存放传送菜单的槽位(0–8)
  • next-page-texture / prev-page-texture — 导航箭头的 Base64 头像纹理
  • teleport-sound / teleport-particle — 每次传送时播放的效果
  • upgrades.yml — 各页及各槽位的解锁消耗;定义最大页数
  • warpstones/<id>.yml — 每个传送石对应一个文件:包含 name、warp、texture、category、permission、cooldown,可选 display-name / lore

权限

权限 默认值 描述
warpstones.admin OP 可访问所有 /warpstones 管理命令
warpstones.extrapage OP 允许解锁并查看第 1 页之后的页面
warpstones.give.menu OP 允许使用 /warpstones give menu
warpstones.give.warpstone OP 允许使用 /warpstones give warpstone
warpstones.info OP 允许使用 /warpstones info
warpstones.reset OP 允许使用 /warpstones reset

支持与反馈

  • ? 在 Modrinth 留下评论
  • ? 分享给他人

如有问题、建议或 Bug 报告:[加入 Discord 创建工单!]

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源