# Introduction
\n**WarpUtils** is a lightweight, fully configurable server-side utility mod that provides essential teleportation features: Homes, Warps, and TPA requests.
\nInspired by the VanillaTweaks Datapacks.<\/p>\n
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.<\/p>\n
## Core Functionality
\n* **Homes:** Players can set personal waypoints and teleport back to them.
\n* **Warps:** Operators can set global waypoints (like shops or hubs) accessible to everyone.
\n* **TPAs:** Players can send requests to teleport to one another securely.
\n* **Back:** A convenient command to return to your previous location after a teleport.<\/p>\n
# Features 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.<\/p>\n | Command | Description | Allows players to request teleportation to other players. The requesting player is teleported to the receiving player once they accept the request.<\/p>\n **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.<\/p>\n | Command | Description | Allows operators to manage global points of interest that all players can teleport to.<\/p>\n **The Spawn Warp:** | Command | Description | Commands marked with **(OP)** can only be executed by the<\/p>\n<\/details>\n 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).<\/p>\n | Command | Description | Allows players to teleport to a random location. The maximum and minimum range of the teleport is configurable.<\/p>\n | Command | Description | Personalize your experience using: `\/warputils personal ## Customizable Options: ## Visual Effects *Note: Operators can force effects to be enabled globally, overriding player preferences.*<\/p>\n<\/details>\n # Configuration The command `\/warputils config 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 Accessed using `\/warputils config general | Setting | Default | Description | The exception to the cooldown default is the \/tpr command for which it is set to 24000 (20 minutes).<\/p>\n *ticks: 1 tick = 1\/20th of a second* Accessed using `\/warputils config homes | Setting | Default | Description | Accessed using `\/warputils config tpas | Setting | Default | Description | *ticks: 1 tick = 1\/20th of a second* Accessed using `\/warputils config warps | Setting | Default | Description | Accessed using `\/warputils config back | Setting | Default | Description | The operation modes the `\/back` command: Accessed using `\/warputils config tpr | Setting | Default | Description | The operation modes the `\/back` command: Accessed using `\/warputils config effects | Setting | Default | Description | *Note: To disable one specific effect, select the “None” effect and enforce it.* Accessed using `\/warputils config fightCooldown | Setting | Default | Description | *Note: To disable this feature set the cooldown to 0.* ## Note: Also minecraft version 26.1 and higher will no longer support forge.<\/p>\n","protected":false},"excerpt":{"rendered":" A fully customizable teleportation utility mod for server-side features like tpa requests or homes<\/p>\n","protected":false},"featured_media":168717,"template":"","meta":{"_minecraft_slug":"warputils","_minecraft_project_id":"E7tP6wsR","_minecraft_author":"EternalFlame06","_minecraft_license":"Apache-2.0","_minecraft_downloads":19585,"_minecraft_follows":31,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"warputils.zip","_minecraft_size_bytes":68155311,"_minecraft_version_count":151,"_minecraft_updated_at":"2026-05-17T00:01:27.719776Z","_minecraft_date_created":"2024-01-16T19:52:15.865166Z","_minecraft_date_modified":"2026-05-03T14:56:54.437256Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/warputils","_minecraft_icon_attachment_id":168717,"_minecraft_imported_at":"2026-06-09T19:48:31+00:00","_minecraft_import_hash":"7dab844d85166dee652b0540836bcd36","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,97,104,158,867,869,92],"mod_loader":[99,106,160],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-168716","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-fabric","mod_category-forge","mod_category-neoforge","mod_category-social","mod_category-transportation","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nEvery teleportation feature comes with
\n– **Cooldowns:** Configure how long a player must wait after teleporting before they can use the command again.
\n– **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).
\n– **Configurable:** Every feature can be individually disabled and configured (see configuration details below).<\/p>\nHomes<\/summary>\n
\n| :— | :— |
\n| `\/home
\n| `\/home` | Teleports you to your default home (auto-selects one if no default is set) |
\n| `\/setdefaulthome
\n| `\/sethome
\n| `\/delhome
\n| `\/renamehome
\n| `\/homes` | Lists all your saved homes and their coordinates |<\/p>\n<\/details>\nTPAs (Teleport Requests)<\/summary>\n
\n| :— | :— |
\n| `\/tpa
\n| `\/tpaaccept
\n| `\/tpaaccept` | Accepts the most recent teleport request. |
\n| `\/tpadeny
\n| `\/tpadeny` | Denies all active incoming requests |
\n| `\/tpacancel` | Cancels the outgoing request you sent |
\n| `\/tpas` | Displays all active sent and received requests |<\/p>\n<\/details>\nWarps<\/summary>\n
\nBy default, a `Spawn` warp is enabled and linked to the world spawn point (can be set using `\/setworldspawn …`)
\n– It can be detached from the world spawn by overwriting it: `\/setwarp Spawn`
\n– It can be reattached to the world spawn by deleting the custom warp: `\/delwarp Spawn`<\/p>\n
\n| :— | :— |
\n| `\/warp
\n| `\/warps` | Lists all available warps and their locations |
\n| `\/setwarp
\n| `\/delwarp
\n| `\/renamewarp Back Command<\/summary>\n
\n| :— | :— |
\n| `\/back` | Teleports you back to your last location before a teleport |<\/p>\n<\/details>\nTpr Command<\/summary>\n
\n| :— | :— |
\n| `\/tpr` | Teleports you to a random location |<\/p>\n<\/details>\nPlayer Preferences & Effects<\/summary>\n
\n* **Delay Display:** When teleporting how should the delay progress be displayed: `none`, `percentage` or `seconds`.
\n* **Language:** Set your display language (currently only supports English).
\n* **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).
\n* **Particles:** Adjust the visual effects of the teleportation.<\/p>\n
\nParticles are displayed at three stages:
\n1. **Charge Effect:** During the warm-up delay.
\n2. **Departure:** At the location you leave.
\n3. **Arrival:** At your destination.<\/p>\n
\n*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 General<\/summary>\n
\n| :— | :— | :— |
\n| `cooldown` | 1200 (1 minutes) | The waiting period (in ticks) between teleportations |
\n| `delay` | 60 (3 seconds) | The time (in ticks) between executing the command and being teleported |
\n| `messageTarget` | actionbar | The primary location to display messages to |<\/p>\n
\n<\/details>\nHomes<\/summary>\n
\n| :— | :— | :— |
\n| `maxHomeCount` | 3 | The maximum number of homes a player can have (0 = Infinity) |
\n| `disableHomes` | false | Disables homes (homes won’t be deleted) |
\n<\/details>\nTpas (Teleport Requests)<\/summary>\n
\n| :— | :— | :— |
\n| `duration` | 6000 | The time (in ticks) a tpa request is active (0 = Infinity) |
\n| `disableTpas` | false | Disables tpas |<\/p>\n
\n<\/details>\nWarps<\/summary>\n
\n| :— | :— | :— |
\n| `disableSpawnWarp` | false | Is the spawn warp disabled |
\n| `disableWarps` | false | Disables warps (warps won’t be deleted) |
\n<\/details>\nBack Command<\/summary>\n
\n| :— | :— | :— |
\n| `duration` | 0 | The time (in ticks) a tpa request is active (0 = Infinity) |
\n| `mode` | backBack | The operation mode of the `\/back` command |
\n| `backOnDeath` | false | Does your death set a back location |
\n| `disableBack` | false | Disables the `\/back` command |<\/p>\n
\n– **backBack**: You can teleport back to the location you used `\/back`, `\/home`, `\/tpa` or `\/warp` from
\n– **singleUse**: You can teleport back once after every teleportation using `\/home`, `\/tpa` or `\/warp`
\n– **persistent**: The back location only changes when using `\/home`, `\/tpa` or `\/warp`
\n<\/details>\nTpr Command<\/summary>\n
\n| :— | :— | :— |
\n| `minRange` | 500 | The minimum distance (in blocks) tpa can teleport you away from your position |
\n| `maxRange` | 2000 | The maximum distance (in blocks) tpa can teleport you away from your position |
\n| `disableTpr` | false | Disables the `\/tpr` command |<\/p>\n
\n– **backBack**: You can teleport back to the location you used `\/back`, `\/home`, `\/tpa` or `\/warp` from
\n– **singleUse**: You can teleport back once after every teleportation using `\/home`, `\/tpa` or `\/warp`
\n– **persistent**: The back location only changes when using `\/home`, `\/tpa` or `\/warp`
\n<\/details>\nEffects<\/summary>\n
\n| :— | :— | :— |
\n| `chargeEffect` | RisingRings | The default effect to display during the delay period |
\n| `enforceChargeEffect` | false | Enforces the default charge effect; always plays this effect instead of the effect the player selected |
\n| `teleporationEffect` | Smoke | The default effect to display at the location of departure |
\n| `enforceTeleportEffect` | false | Enforces the default teleportation effect; always plays this effect instead of the effect the player selected |
\n| `arrivalEffect` | Smoke | The default effect to display at the location of arrival |
\n| `enforceArrivalEffect` | false | Enforces the default arrival effect; always plays this effect instead of the effect the player selected |
\n| `disableEffects` | false | Disables all particle effects in this mod |<\/p>\n
\n<\/details>\nFight Cooldown<\/summary>\n
\n| :— | :— | :— |
\n| `cooldown` | 60 | The duration during which you cannot teleport after being attacked |
\n| `onlyPvP` | false | Whether only players can trigger this cooldown |<\/p>\n
\n<\/details>\n
\nFeel free to share any ideas regarding additions or changes on my github issues page.<\/p>\n