
关于
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 —— 实时重载所有配置和石头定义
工作原理
- 获取传送菜单 —— 玩家在加入时获得(如果启用)或通过
/warpstones give menu 获得
- 收集传送石 —— 由管理员通过命令分发,或放置在商店/战利品表中
- 预览石头 —— 手持时右键点击以查看目的地、分类和说明
- 放置石头 —— 打开传送菜单并将石头拖入已解锁的槽位,以永久注册该传送点
- 使用
/warp —— 插件会检查玩家是否已放置石头、是否具有所需权限且未处于冷却状态
- 排序与整理 —— 点击排序按钮按字母顺序排列已放置的石头
- 解锁更多槽位 —— 点击红色的 Unlock Slot(解锁槽位) 按钮购买额外槽位
- 扩展到新页面 —— 一旦所有 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 创建工单!]

About
WarpStones is a Paper plugin for Minecraft 1.21.X that introduces a fully custom warp system built around a personal Warp-Menu — a compass item each player carries that opens their own GUI. Players collect Warp Stones (custom player-head items) and place them into their menu to permanently unlock /warp destinations.
Every player progresses at their own pace: the first four slots are free, while additional slots must be purchased through an economy system. Extra pages can be unlocked for players with the appropriate permission. The plugin integrates seamlessly with EssentialsX for warp teleportation, Vault for economy-based slot purchasing, and PlaceholderAPI for scoreboard & tablist support.
Features
? Personal Warp-Menu
- Each player receives a Warp-Menu compass that opens their own private GUI
- Right-clicking a bare Warp Stone in hand shows a preview of its destination without opening the menu
- Optionally given automatically on first join, configurable via
give-menu-on-join
- Hotbar slot is configurable via
menu-slot
? Warp Stones
- Collectible player-head items with custom textures, names, and lore
- Each stone is tied to a specific
/warp destination and optional category
- Players place a stone into their Warp-Menu to permanently unlock that warp
- Fully custom display names and lore with
& color codes, or clean defaults
- Optional permission node per stone to restrict who can use it (e.g.
warpstones.use.vip_lounge)
- Optional per-stone cooldown in seconds between teleports
? Slot System
- Page 1 starts with 4 slots unlocked for free; slots 5–8 require a purchase
- Slots must be unlocked in order — the next purchasable slot shows its price; others show a "Unlock previous first" hint
- Each page holds up to 8 warp destinations
- Sort button in the GUI rearranges placed stones alphabetically (A→Z) with a single click
- Collection progress item shows how many stones are placed and how many slots are unlocked on the current page
? Multi-Page Support
- Players can unlock additional pages with the
warpstones.extrapage permission
- The total number of pages is defined by
upgrades.yml — no hardcoded limit
- Customizable navigation arrow textures for prev/next page buttons
⏱️ Teleport Cooldowns
- Set a cooldown (in seconds) per Warp Stone via the
cooldown: field
- Players receive a clear message with the remaining time if on cooldown
- Cooldown is enforced both via GUI button and direct
/warp command
✨ Teleport Effects
- Configurable sound and particle effect on every teleport
- Fully adjustable: sound name, volume, pitch, particle type, and particle count
- Set either to
"" to disable
?️ Categories
- Assign a
category: to each Warp Stone (e.g. Economy, Towns, Resources)
- Category is shown in the placed-stone lore inside the GUI
- Helps players visually organize their warps at a glance
? GUI Layout
- Clean 54-slot GUI (6 rows) with stone slots and action slots side by side
- Book progress indicator in the top center
- Hopper sort button in the bottom center
- Unlocked & filled slots show the Warp Stone head and a green Teleport button
- Unlocked & empty slots show a white pane and a gray Empty Slot hint
- Locked slots display a red pane with a buy button or a "locked" indicator
? Developer API
- Three custom Bukkit events:
WarpStoneTeleportEvent, WarpStoneUnlockEvent, WarpStonePlaceEvent — all cancellable
- Other plugins can hook into warp, unlock, and place/remove actions
?️ Admin Commands
/warpstones create <id> <warp> — generate a new Warp Stone config file with full developer comments
/warpstones give menu <player> — give a player their Warp-Menu
/warpstones give warpstone <id> <player> — give a specific Warp Stone to a player
/warpstones setwarp <name> — set a warp location at your current position
/warpstones info <player> — view a player's placed stones, unlocked slots, and last warp
/warpstones reset <player> — fully reset a player's WarpStones progress
/warpstones reload — reload all configs and stone definitions live
How It Works
- Obtain a Warp-Menu — players receive one on join (if enabled) or via
/warpstones give menu
- Collect Warp Stones — distributed by admins via command, or placed in shops/loot tables
- Preview a stone — right-click it in hand to see the destination, category, and instructions
- Place a stone — open the Warp-Menu and drag the stone into an unlocked slot to permanently register that warp
- Use
/warp — the plugin checks that the player has the stone placed, the required permission, and is not on cooldown
- Sort & organize — click the Sort button to arrange placed stones alphabetically
- Unlock more slots — click the red Unlock Slot button to purchase additional slots
- Expand to new pages — once all 8 slots are unlocked and the player has
warpstones.extrapage, a next-page arrow appears
Compatibility
| Dependency |
Type |
Notes |
| PaperMC 1.21.X |
Required |
Must run on Paper or a Paper fork |
| EssentialsX |
Optional |
Used for /warp teleportation; built-in fallback via warps.yml |
| Vault |
Optional |
Required for economy-based slot unlock costs |
| PlaceholderAPI |
Optional |
Exposes placeholders for scoreboards & tablist |
PlaceholderAPI
| Placeholder |
Description |
%warpstones_placed% |
Number of Warp Stones placed in the player's current menu |
%warpstones_slots_unlocked% |
Total number of unlocked slots across all pages |
%warpstones_last_warp% |
The last warp destination the player used |
Configuration Highlights
give-menu-on-join — auto-give Warp-Menu on first join
menu-slot — hotbar slot (0–8) for the Warp-Menu
next-page-texture / prev-page-texture — Base64 head textures for navigation arrows
teleport-sound / teleport-particle — effects played on every teleport
upgrades.yml — slot unlock costs per page and slot; defines the max number of pages
warpstones/<id>.yml — one file per stone: name, warp, texture, category, permission, cooldown, optional display-name / lore
Permissions
| Permission |
Default |
Description |
warpstones.admin |
OP |
Access to all /warpstones admin commands |
warpstones.extrapage |
OP |
Allows unlocking and viewing pages beyond page 1 |
warpstones.give.menu |
OP |
Allows using /warpstones give menu |
warpstones.give.warpstone |
OP |
Allows using /warpstones give warpstone |
warpstones.info |
OP |
Allows using /warpstones info |
warpstones.reset |
OP |
Allows using /warpstones reset |
Support & Feedback
- ? Leave a Review on Modrinth
- ? Share with others
For questions, suggestions & bug reports: [Join the Discord to create a ticket!]
评论 0
登录后参与评分
还没有评论,来抢沙发吧