404Warp Wiki

A survival-friendly travel system built around crafted Warp Stones, a Warp Book, shared destinations, and server-managed warps.

Install plugin→Craft items→Create a warp→Open the Warp Book

Getting started

Run a compatible Spigot or Paper 1.26.1 server on Java 25.
Copy 404warp-1.0b.jar into the server's plugins/ folder.
Start or restart the server. The plugin creates plugins/404Warp/config.yml, warps.yml, and the locale/ folder.
Craft a Warp Stone and Warp Book using the recipes below. Right-click a safe block with the stone, then open the book to manage and use the new warp.

Upgrade safely: stop the server before replacing the JAR. Existing warps.yml data and customized locale values are retained; new language keys are merged automatically.

Custom recipes

404Warp adds two shaped crafting recipes. The result items carry plugin data, so ordinary amethyst shards and books cannot act as warp items.

Warp Stone

Five diamonds arranged as a cross create one Warp Stone. The finished item uses an amethyst shard as its visible material.

5 × DIAMOND → 1 × Warp Stone

Minecraft crafting table with five diamonds forming a cross and producing a Warp Stone. — Warp Stone crafting recipeOpen full size

Warp Book

Four diamonds surround a normal book. Keep the Warp Book in your inventory and right-click it whenever you need the warp menu.

4 × DIAMOND + 1 × BOOK → 1 × Warp Book

Minecraft crafting table with four diamonds surrounding a book and producing a Warp Book. — Warp Book crafting recipeOpen full size

Server Warp Stones are not craftable. An administrator gives them with /survivalwarps give serverstone <player> [amount].

Creating and toggling warps

Hold a genuine Warp Stone in the main hand.
Right-click a block. The destination is centered above that block and stores your current facing direction.
The plugin checks that the block below is solid, the feet and head spaces are clear, and the destination is not dangerous.
The warp is saved immediately, starts active, and receives the next available name such as Warp 1.

By default each player may own up to ten warps, creation is blocked in Creative mode, and one stone is consumed. Right-clicking at or within 1.5 blocks of one of your existing warps toggles it active or inactive and consumes a stone when warps.consume_warpstone_on_toggle is enabled.

Inactive warps stay in storage. Their destination particles stop, and normal teleporting is blocked unless teleport.allow_teleport_to_inactive_warps is enabled.

Warp Book and GUI

Right-click the Warp Book in the main hand to open the overview. The book is a reusable menu item and is not consumed.

The My Warps inventory menu with the My Home warp tooltip showing its world, coordinates, active status, and mouse controls. — My Warps overview and tooltipOpen full size

The Warp Options inventory menu for My Home, showing controls for the warp's settings. — Warp Options management menuOpen full size

My WarpsYour personal destinations. Left-click to teleport and right-click for available management options.

Shared WarpsDestinations another owner has shared with you. Access and contributor settings determine what you can do.

Server WarpsGlobal destinations such as spawn, shops, or events. They are available while the server-warp feature is enabled.

Warp OptionsRename, activate, delete, choose an inventory item as the icon, select a particle color, and manage sharing.

Icons, colors, and particles

The icon picker uses the material of an item clicked in your inventory without consuming it. Ten particle colors are available: cyan, blue, purple, pink, green, yellow, orange, red, white, and gray. Disabling particles hides the destination effect without disabling the warp itself.

Owners with survivalwarps.share can choose Share Warp, enter the name of a player who has joined the server before, and then manage that player from Shared Players. A warp cannot be shared with its owner or with more players than the configured limit.

Access	Effect
Can Use	Allows teleporting through the Shared Warps tab when the player also has `survivalwarps.shared.use`.
Contributor	Allows editing when the player has `survivalwarps.shared.contribute`. Rename, icon, color, and active-toggle abilities are independently controlled in `sharing.*`.
Removed	Immediately removes the warp from that player's shared list and revokes use and contributor access.

Only the owner or a full administrator can manage the shared-player list. Contributors cannot delete the warp or change its shared users.

Server warps

Server warps are global destinations stored separately from player warps. They are created by right-clicking a safe block with a Server Warp Stone, represented by a Nether Star.

Give an authorized player a stone with /survivalwarps give serverstone <player> [amount].
Ensure the player has survivalwarps.serverwarps.create or full admin permission.
Right-click a safe block to create the next Server Warp N.
Open the Server Warps tab and right-click the destination with manage permission to rename it, change its icon or color, toggle it, or delete it.

Set server_warps.require_permission_to_use to true when only players with the configured use permission should be able to travel to global destinations.

Teleport sequence

The plugin verifies access, active status, destination world, safety, cooldown, and available XP levels.
The menu closes and the configured countdown starts. Action-bar text, sounds, dust, and portal particles show progress.
Moving farther than the configured distance, taking damage, attacking directly or with a projectile, changing worlds, or disconnecting cancels the pending teleport when its matching option is enabled.
Immediately before travel, access, active status, safety, and XP are checked again.
After a successful Bukkit teleport, XP is charged and the per-player cooldown begins. Cancelled or failed teleports cost nothing.

Player, shared, and server warps each have independent XP-cost and cooldown switches. The bypass permissions default to operators.

Commands

The aliases /404warp, /warpsystem, and /swarps invoke the same command.

Command	Permission	Purpose
`/survivalwarps`	None	Show the available command help.
`/survivalwarps reload`	`survivalwarps.admin`	Reload configuration, locale files, warp data, and destination particles.
`/survivalwarps give stone <player> [amount]`	`survivalwarps.admin`	Give 1–64 Warp Stones to an online player.
`/survivalwarps give book <player> [amount]`	`survivalwarps.admin`	Give 1–64 Warp Books to an online player.
`/survivalwarps give serverstone <player> [amount]`	`survivalwarps.serverwarps.give` or admin	Give 1–64 non-craftable Server Warp Stones.
`/survivalwarps admin`	`survivalwarps.admin.manage` or admin	Open the player and server warp administration GUI.

Permissions

Permission	Default	Controls
`survivalwarps.use`	true	Opening the Warp Book and starting normal teleports.
`survivalwarps.create`	true	Creating personal warps with a Warp Stone.
`survivalwarps.manage`	true	Editing, toggling, and deleting owned warps.
`survivalwarps.share`	true	Sharing owned warps and managing their access list.
`survivalwarps.shared.use`	true	Using a shared warp whose Can Use flag is enabled.
`survivalwarps.shared.contribute`	true	Using contributor editing rights.
`survivalwarps.serverwarps.use`	true	Using server warps when permission-gated use is enabled.
`survivalwarps.serverwarps.create`	op	Creating server warps.
`survivalwarps.serverwarps.manage`	op	Editing and deleting server warps.
`survivalwarps.serverwarps.give`	op	Giving Server Warp Stones.
`survivalwarps.teleport.bypassxp`	op	Bypassing teleport XP costs.
`survivalwarps.teleport.bypasscooldown`	op	Bypassing teleport cooldowns.
`survivalwarps.admin.manage`	op	Opening and operating the admin GUI for player warps.
`survivalwarps.admin`	op	Full administration and normal access bypass.

Configuration

Language and teleport

Key	Default	Effect
`lang`	`en_us`	`en_us`, `de_de`, or `custom`.
`teleport.countdown_seconds`	5	Seconds before normal travel completes.
`teleport.cancel_on_move`	true	Cancel when movement exceeds the configured distance.
`teleport.move_cancel_distance`	0.15	Allowed positional movement in blocks.
`teleport.cancel_on_damage`	true	Cancel after uncancelled incoming damage.
`teleport.cancel_on_attack`	true	Cancel after dealing direct or projectile damage.
`teleport.allow_teleport_to_inactive_warps`	false	Permit travel to inactive destinations.
`teleport.xp_cost_enabled`	false	Enable XP-level charging.
`teleport.xp_cost_levels`	1	Levels charged after successful travel.
`teleport.xp_cost_apply_to_player_warps`	true	Apply cost to owned warps.
`teleport.xp_cost_apply_to_shared_warps`	true	Apply cost to shared warps.
`teleport.xp_cost_apply_to_server_warps`	true	Apply cost to server warps.
`teleport.xp_cost_bypass_permission`	`survivalwarps.teleport.bypassxp`	Permission exempt from XP cost.
`teleport.cooldown_enabled`	false	Enable per-player teleport cooldowns.
`teleport.cooldown_seconds`	60	Cooldown length; resets on server restart.
`teleport.cooldown_apply_to_player_warps`	true	Apply cooldown to owned warps.
`teleport.cooldown_apply_to_shared_warps`	true	Apply cooldown to shared warps.
`teleport.cooldown_apply_to_server_warps`	true	Apply cooldown to server warps.
`teleport.cooldown_bypass_permission`	`survivalwarps.teleport.bypasscooldown`	Permission exempt from cooldown.

Warps and particles

Key	Default	Effect
`warps.max_warps_per_player`	10	Maximum personal warps.
`warps.consume_warpstone_on_create`	true	Consume a stone after creation.
`warps.consume_warpstone_on_toggle`	true	Consume a stone when toggling at the destination.
`warps.allow_creative_create`	false	Allow creation in Creative mode.
`warps.check_safe_destination`	true	Validate destinations during creation and travel.
`particles.enabled`	true	Master switch for destination particles.
`particles.range_blocks`	32	Viewer distance for destination particles.
`particles.interval_ticks`	10	Ticks between effect updates.
`particles.points_per_swirl`	12	Particle points in each rotating ring.
`particles.swirl_height`	1.8	Height of the destination funnel.
`particles.swirl_radius`	0.7	Maximum funnel radius.
`particles.default_color`	`CYAN`	Color assigned to new personal warps.

Sharing, server warps, and admin

Key	Default	Effect
`sharing.enabled`	true	Enable shared-warp access and controls.
`sharing.max_shared_players_per_warp`	10	Maximum shared users per warp.
`sharing.allow_contributors_rename`	true	Allow contributors to rename.
`sharing.allow_contributors_icon`	true	Allow contributors to choose an icon.
`sharing.allow_contributors_color`	true	Allow contributors to choose a color.
`sharing.allow_contributors_toggle_active`	false	Allow contributors to activate or deactivate.
`server_warps.enabled`	true	Enable server-warp creation, visibility, use, and particles.
`server_warps.consume_server_warpstone_on_create`	true	Consume the special stone after creation.
`server_warps.default_icon`	`NETHER_STAR`	Item icon for new server warps.
`server_warps.default_particle_color`	`CYAN`	Color for new server warps.
`server_warps.require_permission_to_use`	false	Require the configured use permission.
`server_warps.use_permission`	`survivalwarps.serverwarps.use`	Permission checked when use is restricted.
`admin.manage_gui_enabled`	true	Enable `/survivalwarps admin`.
`admin.manage_gui_teleport_uses_countdown`	false	Use the countdown for admin-GUI teleports.

Storage and language

Warps are stored in plugins/404Warp/warps.yml. Player warps are grouped by owner UUID; server warps have their own section. Each record includes its stable ID, type, owner, world, coordinates, facing, active and particle flags, icon, color, timestamps, and shared-access entries.

Older records without type or shared fields load with safe defaults. Malformed warp IDs and invalid icon materials are ignored or replaced rather than crashing the entire data load.

Locale files

locale/en_us.ymlEnglish defaults, extracted and updated automatically.

locale/de_de.ymlGerman defaults, extracted and updated automatically.

locale/custom.ymlCreated from English when lang: custom; existing values stay intact while missing keys are added.

Backup: stop the server and copy plugins/404Warp/. The plugin saves every completed warp change immediately and saves again during shutdown.

Troubleshooting

The custom recipe does not produce a working item

Use the exact shaped recipes shown above and verify 404Warp enabled successfully. Renamed ordinary shards or books do not contain the plugin's persistent item marker. If another plugin overrides the recipe key, check startup logs for recipe registration errors.

I cannot create a warp

Check survivalwarps.create, your game mode, the per-player maximum, and whether the selected position has solid ground with two clear blocks above it. Creation is blocked in Creative by default.

The Warp Book opens but an option is missing

Options appear only when the player has the relevant permission and relationship to that warp. Check survivalwarps.manage, share, shared.contribute, contributor flags, and the matching sharing.allow_contributors_* key.

A shared warp cannot be used

The owner must enable Can Use, sharing must be enabled, and the receiving player needs both survivalwarps.use and survivalwarps.shared.use. The warp must also be active unless inactive travel is allowed.

Teleporting cancels immediately

With movement cancellation enabled, moving more than teleport.move_cancel_distance blocks cancels. Damage, attacking, world changes, and disconnecting can also cancel. Increase the threshold or disable only the condition you do not want.

The destination is reported as unsafe

Make sure the destination has a solid supporting block, clear feet and head spaces, and no lava, fire, cactus, magma, campfire, or sweet berry bush in the checked blocks. Repair the area or disable safety checking only if you accept the risk.

Server warps are hidden

Confirm server_warps.enabled is true. When require_permission_to_use is enabled, grant the permission named in server_warps.use_permission.

My language edit disappeared or a key is shown literally

Edit the files in plugins/404Warp/locale/, not the copies inside the JAR. Run /survivalwarps reload after editing. Missing keys are merged from the bundled defaults.