
描述
让玩家打造值得探访的地方。PlayerWarps 添加了一个可浏览的传送菜单,包含收藏、搜索、可配置的限制数量,以及在将玩家传送到不安全的落脚点之前提供确认提示。
✦ 功能说明
- 在分页的物品栏菜单中浏览玩家创建的传送点。
- 收藏传送点,并按传送点名称或所有者进行搜索。
- 设置带有可选描述的传送点;传送数据和收藏会在服务器重启后保留。
- 设置每个玩家的传送点数量限制,并通过权限节点提供额外的槽位。
- 添加传送前摇(warmup)和冷却时间,并可在玩家移动或受到伤害时选择取消前摇。
- 授予可配置的传送后无敌时间,免疫所有伤害,包括 PvP 和环境伤害。
- 检查是否有坚实的地面、足够的空间、陷阱门以及常见危险物。不安全的地点需要执行
/warps confirm 才能传送,或者可以使用 /warps cancel 取消。
- 可通过 Vault 和经济插件向访问者收费。
命令
| 命令 |
作用 |
/warps |
打开传送点浏览器。 |
/warps set <name> [description] |
在你站立的位置创建传送点。 |
/warps delete <name> |
删除你自己的一个传送点。 |
/warps favorite <name> |
切换某个传送点的收藏状态。 |
/warps visit <name> |
开始直接传送到指定传送点。 |
/warps search |
在聊天栏中按名称或所有者搜索传送点。 |
/warps confirm |
接受不安全落脚点的警告。 |
/warps cancel |
取消对不安全落脚点的确认。 |
/warps reload |
重新加载 config.yml(管理员权限)。 |
别名:/pwarp, /playerwarp。
权限
| 权限节点 |
默认分配 |
用途 |
playerwarps.use |
所有人 |
浏览传送点和进行传送。 |
playerwarps.create |
所有人 |
创建传送点。 |
playerwarps.delete.own |
所有人 |
删除自己的传送点。 |
playerwarps.delete.others |
操作员 (Operators) |
删除任何玩家的传送点。 |
playerwarps.admin |
操作员 (Operators) |
重新加载配置,并绕过传送点数量限制和传送冷却时间。 |
playerwarps.limit.<number> |
默认未授予 |
增加玩家的传送点限制数量,例如 playerwarps.limit.10。最高匹配且不超过 100 的权限层级生效。 |
配置指南
编辑 plugins/PlayerWarps/config.yml,然后运行 /warps reload。
settings.default-warp-limit 设置每个玩家默认的传送点数量。
settings.warp-limit-permissions 开启或关闭基于权限节点的传送点数量层级。
settings.name-min-length 和 settings.name-max-length 控制传送点名称的长度限制。
settings.teleport-cooldown-seconds 和 settings.teleport-warmup-seconds 设置传送冷却和前摇时间。
settings.post-teleport-damage-immunity-seconds 设置全伤害保护窗口的时长。默认值:60 秒。
settings.unsafe-confirmation-seconds 设置不安全地点确认状态的有效期时长。默认值:30 秒。
settings.cancel-warmup-on-move 和 settings.cancel-warmup-on-damage 控制是否因移动或受伤而取消前摇。
settings.allow-cross-world-warps 控制跨世界浏览和访问;settings.blocked-worlds 隐藏并禁止选定的世界中的传送点。
settings.economy.enabled 和 settings.economy.visit-cost 启用可选的付费访问功能。这需要安装 Vault 和经济类插件。
gui.* 控制菜单标题、行数、槽位、填充物、传送点物品及其描述文本。在物品文本中使用 %warp%、%owner%、%world%、%x%、%y%、%z%、%visits% 和 %description% 占位符。
messages.* 允许你自定义插件的聊天消息和前缀。
兼容性
基于 Spigot API 1.13.2 构建,使用 Java 8 字节码,api-version 为 1.13。适用于 Paper 1.13.2 及更高版本。Paper 26.3 尚未在此版本中进行运行时测试。仅在使用付费传送点访问功能时才需要 Vault。
安装
- 将
PlayerWarps-1.0.2.jar 放入服务器的 plugins 文件夹中。
- 重启服务器。
- 根据需要调整
plugins/PlayerWarps/config.yml 并运行 /warps reload。
传送点位置和收藏数据存储在 plugins/PlayerWarps/warps.yml 中,并在服务器重启后得以保留。

Description
Let players make places worth visiting. PlayerWarps adds a browsable warp menu with favorites, search, configurable limits, and a confirmation before sending someone to an unsafe landing spot.
✦ What it does
- Browse player warps in a paginated inventory menu.
- Favorite warps and search by warp name or owner.
- Set warps with an optional description; warp data and favorites persist through restarts.
- Set per-player warp limits, with permission tiers for extra slots.
- Add a teleport warmup and cooldown, with optional cancellation when the player moves or takes damage.
- Grant configurable post-teleport immunity from all damage, including PvP and environmental damage.
- Check for a solid floor, clear space, trapdoors, and common hazards. Unsafe spots require
/warps confirm or can be cancelled with /warps cancel.
- Optionally charge visitors through Vault and an economy provider.
Commands
| Command |
What it does |
/warps |
Open the warp browser. |
/warps set <name> [description] |
Create a warp where you are standing. |
/warps delete <name> |
Delete one of your warps. |
/warps favorite <name> |
Toggle a warp as a favorite. |
/warps visit <name> |
Start a direct warp teleport. |
/warps search |
Search warps by name or owner in chat. |
/warps confirm |
Accept an unsafe landing warning. |
/warps cancel |
Cancel an unsafe landing confirmation. |
/warps reload |
Reload config.yml (admin permission). |
Aliases: /pwarp, /playerwarp.
Permissions
| Permission |
Default |
Purpose |
playerwarps.use |
Everyone |
Browse warps and teleport. |
playerwarps.create |
Everyone |
Create warps. |
playerwarps.delete.own |
Everyone |
Delete your own warps. |
playerwarps.delete.others |
Operators |
Delete any player's warp. |
playerwarps.admin |
Operators |
Reload config and bypass warp limits and teleport cooldowns. |
playerwarps.limit.<number> |
Not granted by default |
Increase a player's limit, for example playerwarps.limit.10. Highest matching tier up to 100 applies. |
Config guide
Edit plugins/PlayerWarps/config.yml, then run /warps reload.
settings.default-warp-limit sets the normal number of warps per player.
settings.warp-limit-permissions turns permission-based limit tiers on or off.
settings.name-min-length and settings.name-max-length control warp name length.
settings.teleport-cooldown-seconds and settings.teleport-warmup-seconds set teleport timing.
settings.post-teleport-damage-immunity-seconds sets the all-damage protection window. Default: 60 seconds.
settings.unsafe-confirmation-seconds sets how long the unsafe-spot confirmation remains valid. Default: 30 seconds.
settings.cancel-warmup-on-move and settings.cancel-warmup-on-damage control warmup cancellation.
settings.allow-cross-world-warps controls cross-world browsing and visits; settings.blocked-worlds hides and blocks selected worlds.
settings.economy.enabled and settings.economy.visit-cost enable optional paid visits. This requires Vault and an economy plugin.
gui.* controls the menu title, rows, slots, filler, warp item, and lore. Use %warp%, %owner%, %world%, %x%, %y%, %z%, %visits%, and %description% placeholders in the item text.
messages.* lets you customize the plugin's chat messages and prefix.
Compatibility
Built against Spigot API 1.13.2 with Java 8 bytecode and an api-version of 1.13. Intended for Paper 1.13.2 and newer. Paper 26.3 has not yet been runtime-tested for this release. Vault is only needed if paid warp visits are enabled.
Install
- Place
PlayerWarps-1.0.2.jar in your server's plugins folder.
- Restart the server.
- Adjust
plugins/PlayerWarps/config.yml and run /warps reload if needed.
Warp locations and favorites are stored in plugins/PlayerWarps/warps.yml and survive server restarts.
评论 0
登录后参与评分
还没有评论,来抢沙发吧