# 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](https://vanillatweaks.net/picker/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

TPAs (Teleport 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 ` | Teleports you to the specified global warp | | `/warps` | Lists all available warps and their locations | | `/setwarp ` | **(OP)** Creates or overwrites a warp at your location | | `/delwarp ` | **(OP)** Deletes the specified warp | | `/renamewarp ` | **(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 ...` ## 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: 1. **Charge Effect:** During the warm-up delay. 2. **Departure:** At the location you leave. 3. **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 reset` or `/warputils config default`*. The command `/warputils config ` 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 cooldown ` for example. Accessed using `/warputils config general `. | 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

Tpas (Teleport Requests)

Warps

Back Command

Tpr Command

Effects

Fight Cooldown

## 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.

WarpUtils

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details

Home Demonstration

Logo