AWarp
- By
Server-side warps, homes and teleport essentials for NeoForge and Fabric 26.3, ported from Gecolay's GWarp. Player warps with leaderboards, passwords, locks and arrival effects, private homes, /back, /tpa and /spawn, plus admin tools. No client install.
01-warp-arrival.jpg
02-warp-top.jpg
03-warp-list.jpg
06-homes.jpg
05-effect-tab-complete.jpg
Description
AWarp
A NeoForge and Fabric port of GWarp by Gecolay: player warps, admin warp tools, private homes, plus /back, /tpa and /spawn. It runs on the server only.
Players don't need to install anything. Drop the jar for your loader into your server's mods folder and you're done.
| Loader | File to download | Also needs |
|---|---|---|
| NeoForge | awarp-neoforge-1.3.0.jar |
Nothing else |
| Fabric | awarp-fabric-1.3.0.jar |
Fabric API |
Both versions have the same commands, permissions and features, and save data in the same format.
❤️ Credit
This mod is based on GWarp by Gecolay, and is published with Gecolay's permission. All credit for the original design, the feature set and the command layout goes to them.
I rewrote it from scratch for NeoForge and Fabric, so it contains no code from GWarp, and modded servers can now use the same warp and home system that Spigot and Paper servers have had for years. If you run a plugin server, use the original:
Please don't report bugs in this port to Gecolay. Post them on this project's issue tracker or in the comments.
🔀 How AWarp differs from GWarp
- Platform: runs on NeoForge and Fabric servers and single-player instead of Spigot/Paper, and is server-side only.
- Extra commands:
/back(including back to where you died),/tpa,/tpahere,/tpaccept,/tpdeny,/spawnand/setspawn. - Plays nicely with other mods: every feature can be switched off in the config, so it can run alongside FTB Essentials or similar mods without command clashes.
- Permissions: uses NeoForge's Permission API on NeoForge and fabric-permissions-api on Fabric, so it works with LuckPerms on both. Node names are different from GWarp's.
- Fairer leaderboard: visitors are counted once per player, so one person can't push a warp up
/warp topby warping repeatedly. - Messages: English only, but every message can be edited in
messages.json. - No tracking: no bStats and no update checker.
- Data: existing GWarp warps and homes aren't imported.
✨ Features
Warps
- Player-owned warps that anyone on the server can visit
- Warp limits per player, which you can override per player or per group with a permission
- Visitor counter and a
/warp topleaderboard of the most visited warps - Paginated warp list showing each warp's owner and visitor count
- Welcome messages shown to players when they arrive
- Lock a warp to close it to visitors
- Password-protect a warp (
/warp <name> <password>) - Arrival particles and sounds, chosen from any particle or sound in the game, with tab completion
- Teleport cooldowns, with a bypass permission
- Safe-warp check, which won't drop players into lava, inside solid blocks or over the void (optional)
- Same-dimension-only mode (optional)
- Private warps: only the owner and invited players can see or use them
/warpsopens a chest menu of every warp, with pages, that players click to warp (works on vanilla clients)- Clickable chat: click any warp in
/warp listor/warp topto go there - Shortcut commands:
/setwarp,/delwarp,/updatewarp
Homes
- Private homes, 10 per player by default (configurable)
- Set, move, delete and list your homes, with coordinates and dimension shown. Click a home in the list to go there
- Share a home with friends, who can then visit it with
/home visit - Shortcuts for Essentials habits:
/homes,/sethome,/delhome /home backreturns you to where you last teleported from
Teleport essentials
/backreturns you to where you were before your last teleport, or to where you died/tpaand/tpahereteleport requests with clickable [Accept] and [Deny] buttons, which expire after 60 seconds (configurable)/tpacanceltakes back a request, and/tptogglestops other players sending you requests/spawn, with/setspawnto choose where it goes
For server owners
- Server-side only, so vanilla clients can join
- Full admin toolkit under
/awarpfor managing any warp, changing owners, resetting visitors and sending players to warps - Permission nodes for every command, which work with LuckPerms and other permission mods on both loaders (on Fabric, the permissions library is bundled, so there's nothing extra to install)
- Optional teleport warm-up ("Teleporting in 3 seconds, don't move!") that cancels if the player moves or takes damage, so nobody can teleport out of a fight. Off by default
- Every feature can be turned on or off individually
- Every message can be edited, with
&colour codes, inmessages.json /warpreloadreloads messages (and settings, on Fabric) without a restart- Data is saved as plain JSON per world, so it's easy to back up or edit, and a world can move between the NeoForge and Fabric versions
📜 Commands
Warps: /warp
| Command | Description |
|---|---|
/warp <name> [password] |
Go to a warp |
/warp top |
Most visited warps |
/warp list [page] |
All warps |
/warp set <name> |
Create a warp where you're standing |
/warp delete <name> |
Delete your warp |
/warp update <name> |
Move your warp to where you're standing |
/warp welcome <name> <text>|clear |
Set or clear a welcome message |
/warp warps [player] |
List a player's warps |
/warp lock <name> |
Lock or unlock your warp |
/warp owner <name> |
See who owns a warp |
/warp password <name> [password|clear] |
Show, set or clear a password |
/warp effect [name] [effect|clear] |
Arrival particles |
/warp sound [name] [sound|clear] |
Arrival sound |
/warp private <name> |
Make your warp private or public again |
/warp invite <name> <player> |
Let a player use your private warp |
/warp uninvite <name> <player> |
Take that back |
/warps |
Browse warps in a chest menu |
Shortcuts: /setwarp, /delwarp (or /deletewarp), /updatewarp
Homes: /home
| Command | Description |
|---|---|
/home <name> |
Go to a home |
/home set <name> |
Set a home where you're standing |
/home delete <name> |
Delete a home |
/home update <name> |
Move a home to where you're standing |
/homes or /home homes |
List your homes |
/home back |
Go back to where you last teleported from |
/home invite <player> <home> |
Share a home with a player |
/home uninvite <player> <home> |
Stop sharing it |
/home visit <player> <home> |
Go to a home someone shared with you |
/home shared |
List the homes shared with you |
Shortcuts: /sethome [name] (just /sethome makes a home called "home"), /delhome <name>, /homes
Teleport essentials
| Command | Description |
|---|---|
/back |
Go back to where you were before your last teleport, or where you died |
/tpa <player> |
Ask to teleport to a player |
/tpahere <player> |
Ask a player to teleport to you |
/tpaccept [player] |
Accept the newest request, or the one from that player |
/tpdeny [player] |
Deny the newest request, or the one from that player |
/tpacancel [player] |
Cancel a request you sent (all of them without a name) |
/tptoggle |
Stop or start receiving teleport requests |
/spawn |
Go to spawn |
/setspawn |
Set where /spawn goes (doesn't change the vanilla world spawn) |
Admin: /awarp
| Command | Description |
|---|---|
/awarp warp <player> <warp> |
Send a player to a warp |
/awarp set <name> <player> |
Create a warp owned by a player |
/awarp delete <name> |
Delete any warp |
/awarp update <name> |
Move any warp |
/awarp welcome <name> <text>|clear |
Edit any welcome message |
/awarp lock <name> |
Lock or unlock any warp |
/awarp setowner <name> <player> |
Change a warp's owner |
/awarp reset <name>|all |
Reset visitor counts |
/awarp password <name> [password|clear] |
Manage any warp's password |
/awarp effect [name] [effect|clear] |
Manage any warp's effect |
/awarp sound [name] [sound|clear] |
Manage any warp's sound |
/awarp count <name> |
Turn visitor counting on or off |
/awarp private <name> |
Make any warp private or public |
/awarp version |
Show the mod version |
/warpreload |
Reload messages |
🔑 Permissions
All nodes start with awarp.. Ops get everything. Server owners can change any of these with LuckPerms or another permissions mod.
Default for all players: warp.use, warp.top, warp.list, warp.set, warp.delete, warp.update, warp.welcome, warp.warps, warp.warps_other, warp.lock, warp.owner, warp.password, warp.effect, warp.sound, warp.private (also covers invite and uninvite), warp.menu, home.use, home.set, home.delete, home.update, home.list, home.back, home.share, home.visit (also covers /home shared), back, tpa (also covers /tpaccept, /tpdeny and /tpacancel), tpahere, tpa.toggle, spawn
Ops only by default: warp.cooldown_bypass, warp.lock_bypass, warp.password_bypass, warp.unsafe_bypass, warp.private_bypass, home.cooldown_bypass, tpa.cooldown_bypass, spawn.cooldown_bypass, warmup_bypass, setspawn, reload, and all admin.* nodes
Limits (integer nodes, -1 = unlimited): awarp.warp.limit, awarp.home.limit. In LuckPerms, set them as meta, e.g. /lp group vip meta set awarp.warp.limit 5
⚙️ Configuration
The settings file is created on first launch: config/awarp-local.toml on NeoForge, or config/awarp.json on Fabric. Both use the same option names. Main options and their defaults:
| Option | Default | Notes |
|---|---|---|
use_warp / use_admin_warp / use_shortcuts / use_home |
true | Turn command groups on or off (restart needed) |
use_back / use_tpa / use_spawn |
true | Turn the essentials on or off (restart needed) |
use_home_shortcuts / use_warp_menu |
true | Turn /homes, /sethome, /delhome and the /warps menu on or off (restart needed) |
warmup_seconds |
0 | Teleport warm-up in seconds. 0 = off |
cancel_on_move / cancel_on_damage |
true | What cancels a warm-up |
default_warp_amount |
1 | Warps per player |
default_home_amount |
10 | Homes per player |
warp_cooldown_seconds |
10 | |
home_cooldown_seconds |
0 | |
spawn_cooldown_seconds |
0 | |
back_on_death |
true | /back returns players to where they died |
tpa_timeout_seconds |
60 | How long a teleport request lasts |
tpa_cooldown_seconds |
5 | Wait between sending requests |
use_safe_warp |
false | Blocks unsafe destinations |
same_dimension_only |
false | |
owner_counts_as_visitor |
false | |
broadcast_visitor_reset |
true | Announces /awarp reset all to everyone |
list_page_size / top_amount |
10 | |
top_min_visitors |
1 | Visitors needed to appear in /warp top |
min_name_length / max_name_length |
1 / 20 | |
min_password_length / max_password_length |
1 / 15 | |
| Particle amount / offset / speed, sound volume / pitch | 50 / 1.0 / 0.5, 1.0 / 1.0 | Arrival effect tuning |
Messages are stored in config/awarp/messages.json. Warps, homes, shared homes and the spawn point are saved per world in <world>/awarp/.
📦 Requirements
- Minecraft 26.3
- NeoForge: NeoForge 26.3.0.95 or newer
- Fabric: Fabric Loader 0.20.1 or newer and Fabric API
- Server-side only. Clients can join without the mod.
💬 Support
Found a bug or have an idea? Post in the comments or on the issue tracker. This is an unofficial port, so please don't send support requests to the original author.
GWarp © Gecolay. AWarp is an independent NeoForge and Fabric port published with Gecolay's permission; it isn't maintained or supported by Gecolay.
AWarp Team
