WarpPortals

插件

· 作者 GDLev

高度可定制的传送系统,带有动画传送门

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

最新 0.2 · 26.2 · Spigot

一键开服(送7天)

Logo

Features

WarpPortals 专为那些希望传送体验更加刻意、可配置且精致的服务器而设计,而非仅仅作为一个即时的传送指令。

你可以保留经典的 /warp 行为,将传送点转化为动画化的门户旅行,或者根据指令、传送点名称、玩家权限或服务器区域混合使用这两种风格。

适用场景 适配原因
出生点和大厅传送 创建如 /spawn 和 /hub 这样简洁的快捷方式。
VIP 专属目的地 通过自定义权限保护单个传送点。
经济类服务器 对直接传送、门户创建或两者同时收费。
生存类服务器 在传送前添加移动计时器(防止作弊)。
RPG 和副本区域 当即时传送显得过于单调时,使用门户效果。
服务器网络 为不同的快捷方式配置不同的行为,无需编写额外的插件。

每个保存的传送点都会存储目标位置和玩家的朝向,确保玩家到达时面对的是你预设的方向。门户视觉效果、音效、计时、访问规则、提示信息以及费用均可从配置文件中进行调整。

门户功能预览

Portal preview

指令

Commands

大多数服务器管理员会采用以下三种简单的工作流程:

工作流程 操作内容
玩家旅行 玩家使用 /warp <name> 进行直接传送,或使用 /portal <name> 进行门户传送。
传送点管理 管理员创建和删除已保存的目标位置。
访问控制与定价 管理员设置费用、自定义权限并重载插件。

如果在配置中禁用了直接传送功能,/warp <name> 将自动打开一个门户。

指令行为说明

玩家旅行

玩家使用 /warp <name> 进行常规传送,而在需要打开动画门户时使用 /portal <name>。

传送点管理

管理员站在目标位置并运行 /warpportals setwarp <name> 来创建传送点。插件会保存世界、坐标、偏航角(yaw)和俯仰角(pitch)。之后可以使用 /warpportals delwarp <name> 删除传送点。

访问控制与定价

管理员可以为直接传送和门户创建设置独立的价格。他们还可以为传送点附加自定义权限,这使得创建仅限特定等级使用的目的地变得容易,而无需创建多个命令别名或单独的配置部分。

编辑配置文件、存储数据、消息或自定义指令后,请使用 /warpportals reload 重载插件,无需重启服务器。


权限

Permissions

权限复制粘贴
权限名称 权限描述
warpportals.admin 所有 WarpPortals 权限。
warpportals.command.help 显示帮助菜单。
warpportals.command.version 显示插件版本。
warpportals.command.portal 打开门户。
warpportals.command.teleport 使用直接传送功能。
warpportals.command.setwarp 创建传送点。
warpportals.command.delwarp 删除传送点。
warpportals.command.reload 重载插件。
warpportals.command.cost 编辑传送点费用。
warpportals.command.setperm 编辑自定义传送点权限。
warpportals.cost.bypass 绕过传送和门户费用。

默认的权限设置故意保持简单:

用户组类型 建议权限
普通玩家 warpportals.command.teleport, warpportals.command.portal
VIP 玩家 普通玩家权限加上自定义传送点权限,例如 warpportals.warp.vip
工作人员 用于创建、删除、定价和重载的管理员指令权限
受信任用户 如果他们应忽略费用,则赋予 warpportals.cost.bypass
示例等级设置
default:
  warpportals.command.teleport
  warpportals.command.portal

vip:
  warpportals.command.teleport
  warpportals.command.portal
  warpportals.warp.vip

admin:
  warpportals.admin

自定义传送点权限并非硬编码。你可以使用任何你想要的权限字符串,然后通过你的权限插件进行分配。


配置

WarpPortals 使用三个主要的配置区域:

文件 用途
config.yml 全局行为、门户、音效、计时器和自定义指令。
storage.yml 已保存的传送点、传送点权限及每个传送点的费用。
messages/*.yml 语言文件和 MiniMessage 格式的消息。
核心配置

全局传送设置

teleport:
  delay-seconds: 3
  cancel-on-move: true
  title: true
  actionbar: false

将 delay-seconds 设置为 0 以禁用计时器。任何大于 0 的值都会在传送前启用预热时间。

直接传送还是门户传送

commands:
  direct-warp-teleport: true

当此值为 true 时,/warp <name> 会直接传送。当此值为 false 时,/warp <name> 则会打开一个门户。

优化选项

optimizations:
  cache-warps: true
  shared-particle-scheduler: true
  portal-spatial索引: true
  cache-portal-calculations: true
  cache-settings: true
  cache-vault-provider: true

这些高级设置默认开启,适用于大多数服务器。仅在分析性能或特定服务器配置显示其他模式更有效时才更改它们。

门户设置

portal:
  protection-mode: block
  material: TINTED_GLASS
  width: 1.25
  height: 2.5
  distance-from-player: 1.5
  min-distance: 10
  animation-enabled: true
  use-display-transitions: true
  animation-ticks: 10
  hold-ticks: 60

portal.min-distance 用于防止玩家在与目的地过近时开启传送门。将其设置为 0 可禁用此检查。

portal.use-display-transitions 允许 Minecraft 客户端将每个显示实体从起始变换动画过渡到结束变换。仅在需要服务器端每秒更新的传统动画时才禁用它。

已保存的传送点示例
warps:
  vip:
    world: world
    x: 120.5
    y: 70.0
    z: -40.5
    yaw: 180.0
    pitch: 0.0
    permission: warpportals.warp.vip
    costs:
      teleport:
        enabled: true
        type: xp
        amount: 100
        item: DIAMOND
      portal:
        enabled: true
        type: item
        amount: 5
        item: DIAMOND

permission 字段是可选的。如果所有拥有传送点访问权限的玩家都可以使用该目的地,请留空。

费用类型
类型 含义
xp 移除原始经验值点数。
level 移除经验等级。
vault 通过 Vault 经济系统移除货币。
item 从玩家背包中移除物品。
none 禁用费用。

传送费用和门户费用是分开计算的,因此开启传送门的定价可以与直接传送不同。

自定义命令示例
custom-commands:
  spawn:
    aliases:
      - hub
    warp: spawn
    mode: direct
    delay-seconds: 0
    cooldown-seconds: 0
    message: ""
    cost:
      enabled: false
      type: xp
      amount: 0
      item: DIAMOND

对于即时或基于计时器的传送,请使用 mode: direct。当命令应开启传送门时,请使用 mode: portal。

语言

默认包含英语和波兰语:

language: en_us
language: pl_pl

您可以在 messages 文件夹中添加自己的语言文件。插件重载时,缺失的键会从英语文件中复制。


常见问题解答 (Q&A)

传送点创建与基本旅行

如何创建新的传送点?

站在玩家应该到达的位置并运行:

/warpportals setwarp spawn

插件会保存位置、世界、偏航角和俯仰角。

如何让 /warp 开启传送门而不是直接传送?

commands:
  direct-warp-teleport: false

重载后,/warp <name> 将开启一个传送门。

如何保持 /warp 为正常的传送命令?

commands:
  direct-warp-teleport: true
传送计时器

如何创建带有延迟的传送点?

设置全局延迟:

teleport:
  delay-seconds: 3
  cancel-on-move: true

玩家需要等待 3 秒才能直接传送。如果启用了 cancel-on-move,移动会取消传送。

如何禁用延迟?

teleport:
  delay-seconds: 0
VIP 和自定义权限

如何创建仅限 VIP 玩家使用的传送点?

创建传送点:

/warpportals setwarp vip

分配权限:

/warpportals setperm vip warpportals.warp.vip

然后将 warpportals.warp.vip 赋予你的 VIP 用户组。

如何移除传送点的 VIP 限制?

/warpportals setperm vip reset

如何手动编辑传送点的权限?

打开 storage.yml 并编辑:

warps:
  vip:
    permission: warpportals.warp.vip

使用空字符串表示无限制:

permission: ""
费用和经济学

如何对传送收取经验值费用?

/warpportals cost spawn teleport xp 100

如何对开启传送门收取经验值费用?

/warpportals cost spawn portal xp 100

如何对传送收取等级费用?

/warpportals cost spawn teleport level 10

如何对传送收取 Vault 货币费用?

/warpportals cost spawn teleport vault 20

必须安装 Vault 和经济插件。

如何对传送收取物品费用?

/warpportals cost spawn portal item 5 DIAMOND

这会在开启传送门时扣除 5 颗钻石。

如何移除费用?

/warpportals cost spawn teleport none 0

对于传送门费用:

/warpportals cost spawn portal none 0

如何让工作人员豁免所有费用?

赋予他们以下权限:

warpportals.cost.bypass
自定义命令

如何创建 /spawn 命令?

custom-commands:
  spawn:
    warp: spawn
    mode: direct
    delay-seconds: 0

如何让 /hub 也执行出生点传送?

custom-commands:
  spawn:
    aliases:
      - hub
    warp: spawn
    mode: direct

如何使特定快捷方式开启传送门?

custom-commands:
  dungeon:
    warp: dungeon
    mode: portal

之后玩家可以使用 /dungeon 来开启通往该传送点的传送门。

如何为自定义命令添加冷却时间?

custom-commands:
  spawn:
    warp: spawn
    mode: direct
    cooldown-seconds: 30

如何添加自定义成功消息?

custom-commands:
  spawn:
    warp: spawn
    mode: direct
    message: "<gray>Teleported to <#e23a6f>spawn<gray>."
仅传送门设置

如何使传送点只能通过传送门访问?

为玩家应使用的命令使用传送门模式:

自定义命令:
  地牢:
    传送: dungeon
    模式: 传送门

那么请不要给这些玩家授予 warpportals.command.teleport 权限,或者仅允许管理员直接使用 /warp 命令。

如何为某个用户组完全禁用传送门?

不要授予该用户组以下权限:

warpportals.command.portal

如果 /warp 配置为打开传送门,请确保仅对需要直接使用传送功能的用户组保留 commands.direct-warp-teleport: true。

传送门距离与保护

如何防止玩家在离目标过近的地方打开传送门?

portal:
  min-distance: 10

如果入口传送门距离目的地传送门小于 10 格,则无法打开。

如何禁用此距离检查?

portal:
  min-distance: 0

如何防止重复激活的传送门?

portal:
  protection-mode: block

当新传送门打开时,如何替换旧的传送门?

portal:
  protection-mode: replace
传送门通行规则

如何让传送门变为单向?

portal:
  teleport:
    one-way: true

如何允许所有人穿过传送门?

portal:
  teleport:
    only-owner: false

如何让传送门仅对创建者生效?

portal:
  teleport:
    only-owner: true

如何在创建者使用传送门后关闭它?

portal:
  teleport:
    close-after-owner-use: true
传送门视觉效果与计时

如何更改传送门大小?

portal:
  width: 1.25
  height: 2.5
  depth: 0.1875

如何更改入口传送门相对于玩家的显示距离?

portal:
  distance-from-player: 1.5

如何更改传送门动画速度?

portal:
  animation-enabled: true
  use-display-transitions: true
  animation-ticks: 10

将 animation-enabled 设置为 false 可使传送门立即出现和消失。animation-ticks 值越低速度越快,值越高速度越慢。

如何更改传送门保持开启的时间?

portal:
  hold-ticks: 60

20 ticks 等于 1 秒。

音效

如何禁用某种音效?

使用 none:

portal:
  sounds:
    open:
      sound: none

如何更改传送音效?

teleport:
  sounds:
    complete:
      sound: ENTITY_EXPERIENCE_ORB_PICKUP
      volume: 1.0
      pitch: 2.0
    cancel:
      sound: BLOCK_NOTE_BLOCK_BASS
      volume: 1.0
      pitch: 0.6

如何更改传送门音效?

portal:
  sounds:
    open:
      sound: BLOCK_PORTAL_TRIGGER
      volume: 0.7
      pitch: 1.6
    close:
      sound: BLOCK_PORTAL_TRAVEL
      volume: 0.4
      pitch: 1.8
重载与语言文件

如何重载插件?

/warpportals reload

重载会刷新配置文件、存储数据、消息提示和自定义命令。

如果配置文件或消息文件缺失会发生什么?

插件在启动或重载时会重新生成缺失的配置和消息文件。

我可以添加其他语言吗?

可以。创建一个类似以下的文件:

messages/de_de.yml

然后设置:

language: de_de

缺失的键将从英文文件中复制。

预期会有 Bug

我试图预见所有可能导致错误或 Bug 的情况,但独自测试可能会遗漏一些内容。如果您发现任何 Bug,请立即通过项目 GitHub 固定链接中的问题追踪器或我的 Discord 进行报告。 谢谢您 ❤️

如果您觉得这个插件有用、独特或仅仅是很酷,请考虑通过在 Modrinth 上关注该项目来支持我。如果您想提供更多支持,也可以查看我的 Ko-fi。每一份支持都激励我继续完善这个插件。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源