简介
WarpUtils 是一款轻量级、完全可配置的服务器端工具模组,提供核心的传送功能:家(Homes)、传送点(Warps)和 TPA 请求。
灵感来源于 VanillaTweaks Datapacks。
由于它是纯服务器端模组,您可以将其安装在服务器上,原版客户端可以在没有任何劣势或额外下载的情况下加入游戏。
核心功能
- 家 (Homes): 玩家可以设置个人路标并传送到这些位置。
- 传送点 (Warps): 管理员可以设置全局路标(如商店或枢纽),所有玩家均可访问。
- TPA: 玩家可以安全地发送互相传送的请求。
- 返回 (Back): 一个便捷指令,用于在传送后返回到之前的位置。
特性
每个传送功能都具备以下选项:
- 冷却时间: 配置玩家在传送后再次使用该指令前必须等待的时间。
- 预热延迟: 配置执行传送前的“静止”计时器。如果玩家移动、运行另一个指令或受到攻击(如果战斗冷却处于激活状态),此延迟将被取消。
- 可配置性: 每个功能都可以单独禁用和配置(详见下方的配置说明)。
家 (Homes)
允许玩家设置个人家园并随时传送回这些地方。服务器所有者可以配置玩家允许保留的最大家园数量。
| 指令 |
描述 |
/home <homeName> |
传送到指定的家园 |
/home |
传送到你的默认家园(如果未设置默认值,则自动选择一个) |
/setdefaulthome <homeName> |
将现有的家园设置为默认 |
/sethome <homeName> |
在当前所在位置创建或覆盖一个家园 |
/delhome <homeName> |
删除指定的家园 |
/renamehome <currentName> <newName> |
重命名现有家园(如果 newName 已存在,也可以进行覆盖) |
/homes |
列出所有保存的家园及其坐标 |
TPA (传送请求)
允许玩家向其他玩家发起传送请求。一旦接收方接受请求,请求方就会被传送到接收方的位置。
注意: 玩家一次只能有一个 出站 请求处于活跃状态,但可以接收多个 入站 请求。冷却时间在传送发生后应用;延迟时间在请求被接受后应用。
| 指令 |
描述 |
/tpa <target> |
向指定玩家发送传送请求 |
/tpaaccept <player> |
接受来自特定玩家的请求 |
/tpaaccept |
接受最近的传送请求。 |
/tpadeny <player> |
拒绝来自特定玩家的请求 |
/tpadeny |
拒绝所有活跃的入站请求 |
/tpacancel |
取消你发出的出站请求 |
/tpas |
显示所有已发送和接收到的活跃请求 |
传送点 (Warps)
允许管理员管理所有玩家都可以传送到的一些全局兴趣点。
出生点传送 (The Spawn Warp):
默认情况下,启用了 Spawn 传送点并链接到世界出生点(可以使用 /setworldspawn ... 设置)
- 可以通过覆盖它来断开与世界出生点的链接:
/setwarp Spawn
- 可以通过删除自定义传送点重新链接到世界出生点:
/delwarp Spawn
| 指令 |
描述 |
/warp <warpName> |
传送到指定的全局传送点 |
/warps |
列出所有可用的传送点及其位置 |
/setwarp <warpName> |
(OP) 在你的位置创建或覆盖一个传送点 |
/delwarp <warpName> |
(OP) 删除指定的传送点 |
/renamewarp <currentName> <newName> |
(OP) 重命名现有传送点 |
标记为 (OP) 的指令只能由拥有操作员权限的玩家执行
返回指令 (Back Command)
允许玩家返回到他们上一次传送前的位置或死亡地点。行为通过配置文件高度可定制(包括 mode 和 duration 设置)。
| 指令 |
描述 |
/back |
传送到你上次传送前的最后位置 |
Tpr 指令
允许玩家传送到随机位置。传送的最大和最小范围是可配置的。
玩家偏好与特效
使用以下命令个性化你的体验:/warputils personal <preference> ...
可定制选项:
- 延迟显示: 传送时如何显示延迟进度:
none(无)、percentage(百分比)或 seconds(秒数)。
- 语言: 设置显示语言(目前仅支持英文)。
- 消息目标: 选择模组消息出现的位置:
chat(聊天栏)或 actionbar(动作栏)(某些消息可能强制在一个或另一个中显示,例如家园列表)。
- 粒子效果: 调整传送的视觉效果。
视觉效果
粒子效果在三个阶段显示:
- 充能效果: 在预热延迟期间。
- 离开: 在你离开的位置。
- 到达: 在你的目的地。
注意:管理员可以强制全局启用特效,覆盖玩家偏好设置。
配置
注意:配置文件不用于直接配置。它仅用于设置创建世界或使用 /warputils config reset、/warputils config <category> reset 或 /warputils config <category> <setting> default 重置世界特定配置时使用的默认值。
指令 /warputils config <category> 允许你作为操作员轻松配置每个功能的行为。非操作员可以读取配置的值,但不能编辑它们。
通用设置
此配置类别允许你设置更通用的配置,例如默认的 `messageTarget` 或用于传送的 `cooldown`(冷却时间)和 `delay`(延迟)。每个传送功能默认继承 `cooldown` 和 `delay` 的值(相应设置的值设为 -1),但你也可以单独使用 `/warputils config <feature> cooldown <value>` 等命令进行设置。
通过 /warputils config general <setting> <value> 访问。
| 设置项 |
默认值 |
描述 |
cooldown |
1200 (1 分钟) |
两次传送之间的等待时间(以刻为单位) |
delay |
60 (3 秒) |
执行命令与完成传送之间的时间间隔(以刻为单位) |
messageTarget |
actionbar |
消息显示的主要位置 |
冷却时间的默认例外是 /tpr 命令,其设置为 24000 (20 分钟)。
刻:1 刻 = 1/20 秒
家 (Homes)
通过 `/warputils config homes <setting> <value>` 访问。
| 设置项 |
默认值 |
描述 |
interDimTP |
true |
允许跨维度传送 |
maxHomeCount |
3 |
玩家最多可以拥有的家数量 (0 = 无限) |
disableHomes |
false |
禁用家功能 (已有的家不会被删除) |
Tpas (传送请求)
通过 `/warputils config tpas <setting> <value>` 访问。
| 设置项 |
默认值 |
描述 |
interDimTP |
true |
允许跨维度传送 |
duration |
6000 |
tpa 请求的有效时间(以刻为单位)(0 = 无限) |
disableTpas |
false |
禁用 tpas 功能 |
刻:1 刻 = 1/20 秒
传送点 (Warps)
通过 `/warputils config warps <setting> <value>` 访问。
| 设置项 |
默认值 |
描述 |
interDimTP |
true |
允许跨维度传送 |
disableSpawnWarp |
false |
是否禁用出生点传送 |
disableWarps |
false |
禁用传送点功能 (已有的传送点不会被删除) |
返回命令 (Back Command)
通过 `/warputils config back <setting> <value>` 访问。
| 设置项 |
默认值 |
描述 |
interDimTP |
true |
允许跨维度传送 |
duration |
0 |
tpa 请求的有效时间(以刻为单位)(0 = 无限) |
mode |
backBack |
/back 命令的操作模式 |
backOnDeath |
false |
死亡时是否设置返回点 |
disableBack |
false |
禁用 /back 命令 |
/back 命令的操作模式:
- backBack: 你可以传送回使用
/back、/home、/tpa 或 /warp 时的位置
- singleUse: 每次使用
/home、/tpa 或 /warp 传送后,你可以传送回一次
- persistent: 只有在使用
/home、/tpa 或 /warp 时,返回点才会更改
Tpr 命令
通过 `/warputils config tpr <setting> <value>` 访问。
| 设置项 |
默认值 |
描述 |
minRange |
500 |
tpa 可以将你传送到离当前位置的最小距离(以方块为单位) |
maxRange |
2000 |
tpa 可以将你传送到离当前位置的最大距离(以方块为单位) |
disableTpr |
false |
禁用 /tpr 命令 |
特效
通过 `/warputils config effects <setting> <value>` 访问。
| 设置项 |
默认值 |
描述 |
chargeEffect |
RisingRings |
在延迟期间显示的默认特效 |
enforceChargeEffect |
false |
强制使用默认充能特效;始终播放此特效,而不是玩家选择的特效 |
teleporationEffect |
Smoke |
在出发地点显示的默认特效 |
enforceTeleportEffect |
false |
强制使用默认传送特效;始终播放此特效,而不是玩家选择的特效 |
arrivalEffect |
Smoke |
在到达地点显示的默认特效 |
enforceArrivalEffect |
false |
强制使用默认到达特效;始终播放此特效,而不是玩家选择的特效 |
disableEffects |
false |
禁用本模组中的所有粒子特效 |
注意:要禁用某个特定特效,请选择“None”特效并强制启用它。
战斗冷却
通过 `/warputils config fightCooldown <setting> <value>` 访问。
| 设置项 |
默认值 |
描述 |
cooldown |
60 |
受到攻击后无法传送的持续时间 |
onlyPvP |
false |
是否仅由玩家触发此冷却 |
注意:要将此功能禁用,请将冷却时间设置为 0。
注意:
欢迎在我的 GitHub Issues 页面上分享关于新增功能或更改的任何想法。
此外,Minecraft 版本 26.1 及更高版本将不再支持 Forge。
Introduction
WarpUtils is a lightweight, fully configurable server-side utility mod that provides essential teleportation features: Homes, Warps, and TPA requests.
Inspired by the VanillaTweaks Datapacks.
Because it is server-side only, you can install this on your server and pure vanilla clients can join without any drawbacks or additional downloads.
Core Functionality
- Homes: Players can set personal waypoints and teleport back to them.
- Warps: Operators can set global waypoints (like shops or hubs) accessible to everyone.
- TPAs: Players can send requests to teleport to one another securely.
- Back: A convenient command to return to your previous location after a teleport.
Features
Every teleportation feature comes with
- Cooldowns: Configure how long a player must wait after teleporting before they can use the command again.
- Warm-up Delays: Configure a "stand-still" timer before a teleport executes. This delay will be cancelled if the player moves, runs another command, or is attacked (if the fight cooldown is active).
- Configurable: Every feature can be individually disabled and configured (see configuration details below).
Homes
Allows players to set personal homes and teleport back to them at will. Server owners can configure the maximum number of homes a player is allowed to keep.
| Command |
Description |
/home <homeName> |
Teleports you to the specific home |
/home |
Teleports you to your default home (auto-selects one if no default is set) |
/setdefaulthome <homeName> |
Sets an existing home as your default |
/sethome <homeName> |
Creates or overwrites a home at your current location |
/delhome <homeName> |
Deletes the specified home |
/renamehome <currentName> <newName> |
Renames an existing home (can also override if the newName already exists) |
/homes |
Lists all your saved homes and their coordinates |
TPAs (Teleport Requests)
Allows players to request teleportation to other players. The requesting player is teleported to the receiving player once they accept the request.
Note: A player can only have one outgoing request active at a time, but can receive multiple incoming requests. Cooldowns apply after the teleport happens; delays apply after the request is accepted.
| Command |
Description |
/tpa <target> |
Sends a teleport request to the specified player |
/tpaaccept <player> |
Accepts a request from a specific player |
/tpaaccept |
Accepts the most recent teleport request. |
/tpadeny <player> |
Denies a request from a specific player |
/tpadeny |
Denies all active incoming requests |
/tpacancel |
Cancels the outgoing request you sent |
/tpas |
Displays all active sent and received requests |
Warps
Allows operators to manage global points of interest that all players can teleport to.
The Spawn Warp:
By default, a Spawn warp is enabled and linked to the world spawn point (can be set using /setworldspawn ...)
- It can be detached from the world spawn by overwriting it:
/setwarp Spawn
- It can be reattached to the world spawn by deleting the custom warp:
/delwarp Spawn
| Command |
Description |
/warp <warpName> |
Teleports you to the specified global warp |
/warps |
Lists all available warps and their locations |
/setwarp <warpName> |
(OP) Creates or overwrites a warp at your location |
/delwarp <warpName> |
(OP) Deletes the specified warp |
/renamewarp <currentName> <newName> |
(OP) Renames an existing warp |
Commands marked with (OP) can only be executed by the
Back Command
Allows players to return to the location they were at before their last teleport or to their death location. The behavior is highly customizable via the config (including mode and duration settings).
| Command |
Description |
/back |
Teleports you back to your last location before a teleport |
Tpr Command
Allows players to teleport to a random location. The maximum and minimum range of the teleport is configurable.
| Command |
Description |
/tpr |
Teleports you to a random location |
Player Preferences & Effects
Personalize your experience using: /warputils personal <preference> ...
Customizable Options:
- Delay Display: When teleporting how should the delay progress be displayed:
none, percentage or seconds.
- Language: Set your display language (currently only supports English).
- Message Target: Choose where mod messages appear:
chat or actionbar (Some messages may be forced to be displayed in one or the other, e.g. homes list).
- Particles: Adjust the visual effects of the teleportation.
Visual Effects
Particles are displayed at three stages:
- Charge Effect: During the warm-up delay.
- Departure: At the location you leave.
- Arrival: At your destination.
Note: Operators can force effects to be enabled globally, overriding player preferences.
Configuration
Note: The config file is not for direct configuration. It only sets the default values used when creating a world or resetting the world specific config using /warputils config reset, /warputils config <category> reset or /warputils config <category> <setting> default.
The command /warputils config <category> allows you to easily configure the functionality of each feature as an operator. Non-operators may read the values of the config but not edit them.
General
This config category allows you to set more general configurations, like the default `messageTarget` or the `cooldown` and `delay` used for teleporation. Each teleportation features inherits the `cooldown` and `delay` values by default (the respective setting's value is set to -1) but they can be set individually using `/warputils config <feature> cooldown <value>` for example.
Accessed using /warputils config general <setting> <value>.
| Setting |
Default |
Description |
cooldown |
1200 (1 minutes) |
The waiting period (in ticks) between teleportations |
delay |
60 (3 seconds) |
The time (in ticks) between executing the command and being teleported |
messageTarget |
actionbar |
The primary location to display messages to |
The exception to the cooldown default is the /tpr command for which it is set to 24000 (20 minutes).
ticks: 1 tick = 1/20th of a second
Homes
Accessed using `/warputils config homes <setting> <value>`.
| Setting |
Default |
Description |
interDimTP |
true |
Allowing to teleport through dimensions |
maxHomeCount |
3 |
The maximum number of homes a player can have (0 = Infinity) |
disableHomes |
false |
Disables homes (homes won't be deleted) |
Tpas (Teleport Requests)
Accessed using `/warputils config tpas <setting> <value>`.
| Setting |
Default |
Description |
interDimTP |
true |
Allowing to teleport through dimensions |
duration |
6000 |
The time (in ticks) a tpa request is active (0 = Infinity) |
disableTpas |
false |
Disables tpas |
ticks: 1 tick = 1/20th of a second
Warps
Accessed using `/warputils config warps <setting> <value>`.
| Setting |
Default |
Description |
interDimTP |
true |
Allowing to teleport through dimensions |
disableSpawnWarp |
false |
Is the spawn warp disabled |
disableWarps |
false |
Disables warps (warps won't be deleted) |
Back Command
Accessed using `/warputils config back <setting> <value>`.
| Setting |
Default |
Description |
interDimTP |
true |
Allowing to teleport through dimensions |
duration |
0 |
The time (in ticks) a tpa request is active (0 = Infinity) |
mode |
backBack |
The operation mode of the /back command |
backOnDeath |
false |
Does your death set a back location |
disableBack |
false |
Disables the /back command |
The operation modes the /back command:
- backBack: You can teleport back to the location you used
/back, /home, /tpa or /warp from
- singleUse: You can teleport back once after every teleportation using
/home, /tpa or /warp
- persistent: The back location only changes when using
/home, /tpa or /warp
Tpr Command
Accessed using `/warputils config tpr <setting> <value>`.
| Setting |
Default |
Description |
minRange |
500 |
The minimum distance (in blocks) tpa can teleport you away from your position |
maxRange |
2000 |
The maximum distance (in blocks) tpa can teleport you away from your position |
disableTpr |
false |
Disables the /tpr command |
Effects
Accessed using `/warputils config effects <setting> <value>`.
| Setting |
Default |
Description |
chargeEffect |
RisingRings |
The default effect to display during the delay period |
enforceChargeEffect |
false |
Enforces the default charge effect; always plays this effect instead of the effect the player selected |
teleporationEffect |
Smoke |
The default effect to display at the location of departure |
enforceTeleportEffect |
false |
Enforces the default teleportation effect; always plays this effect instead of the effect the player selected |
arrivalEffect |
Smoke |
The default effect to display at the location of arrival |
enforceArrivalEffect |
false |
Enforces the default arrival effect; always plays this effect instead of the effect the player selected |
disableEffects |
false |
Disables all particle effects in this mod |
Note: To disable one specific effect, select the "None" effect and enforce it.
Fight Cooldown
Accessed using `/warputils config fightCooldown <setting> <value>`.
| Setting |
Default |
Description |
cooldown |
60 |
The duration during which you cannot teleport after being attacked |
onlyPvP |
false |
Whether only players can trigger this cooldown |
Note: To disable this feature set the cooldown to 0.
Note:
Feel free to share any ideas regarding additions or changes on my github issues page.
Also minecraft version 26.1 and higher will no longer support forge.
评论 0
登录后参与评分
还没有评论,来抢沙发吧