The NeoEssentials warp system enables server administrators to create public teleportation points that players can easily access.

The warp system provides:

• Public teleportation points
• Category-based organization
• Permission-controlled access
• Economy integration (optional)
• Teleport cooldowns and warmups

Configure the warp system in config/neoessentials/warps.toml:

[warps]
# Enable the warp system
enabled = true

# Warp teleport cooldown (in seconds, 0 to disable)
cooldown = 10

# Warmup time before teleport (in seconds, 0 to disable)
warmup = 3

# Cancel warmup if player moves
cancelWarmupOnMove = true

# Economy integration
[warps.economy]
# Enable economy costs for warps
enableCosts = false

# Default cost to use a warp (can be overridden per warp)
defaultWarpCost = 25.0

# Storage settings
[warps.storage]
# Storage type: "json", "sqlite", or "mysql"
type = "json"

# Storage location (for JSON)
location = "data/neoessentials/warps"

To create a warp:

1. Go to the location where you want to create the warp
2. Run the command: /setwarp <name>
3. Configure additional properties (optional):
   • Set category: /warp category <name> <category>
   • Set cost: /warp cost <name> <amount>
   • Set icon: /warp icon <name> <material>
   • Set description: /warp desc <name> <description>

Example:

/setwarp spawn
/warp category spawn essentials
/warp desc spawn Main server spawn point
/warp icon spawn nether_star

Warps can be organized into categories for better management:

/warp category <name> <category>

Common categories include:

• essentials - Critical server locations
• biomes - Different biome locations
• shops - Shop locations
• games - Minigame locations
• builds - Interesting builds

To view warps in a specific category:

/warps <category>

When enabled, players will be charged for using warps:

/warp cost <name> <amount>

Sets the cost for using a specific warp. Players will be charged this amount when they teleport to the warp.

You can create warp signs for easy access to warps:

1. Place a sign
2. Write the following lines:

   [Warp]
   <warp name>
   

Players can right-click the sign to teleport to the warp.

NeoEssentials provides a graphical interface for warps:

/warps gui

This opens a menu showing all available warps, organized by category, with custom icons.

Server events can be configured to trigger warps:

[warps.events]
# Warp to send players to on joining the server
joinWarp = "spawn"

# Warp to send players to on respawn
respawnWarp = "spawn"

Warps can store additional metadata:

/warp meta <name> set <key> <value>
/warp meta <name> get <key>
/warp meta <name> remove <key>

This is useful for integration with other plugins or custom scripts.

The warp system works alongside the Home System for private teleportation points.

To restrict a warp to players with a specific permission:

/warp permission <name> <permission>

This requires players to have the specified permission to use the warp.

Set notifications for when players use warps:

/warp notify <name> <message>

This message will be shown to players when they teleport to the warp.

For more information about the warp system:

• Check the Commands Reference for detailed command usage
• See the Permissions Guide for permission setup
• Visit our Discord server for support