PerfectWarps

Complete warp teleportation system with custom icons, categories, favorites, cooldowns, movement cancellation, teleport stats, and a full admin UI.

Buy on BuiltByBit

Installation

1. Drop PerfectWarps-1.0.jar in mods/
2. Start the server
3. Use /pw admin to create your first warp
4. Players use /warps to open the warp menu

Warp Menu (/warps)

Players see a paginated list with:

• Item icon per warp (configurable by admin)
• Name in bold white
• Description + teleport count
• Delay/cooldown info in cyan
• Favorite star (gold) to bookmark
• "Warp" button to teleport

Empty rows and pagination are hidden automatically. Category tabs filter the list.

Admin Panel (/pw admin)

• Left sidebar: paginated warp list, "New Warp" button
• Right panel: editable text fields for name, description, icon, delay, permission, priority
• Icon preview: shows the selected item icon
• Teleport stats: total teleports displayed
• "Set Here": updates warp position to your location
• "Delete": requires double-click confirmation
• "Create": fill in name and click Save to create at your position

Categories

Set a category on each warp (e.g. "Spawn", "Shop", "Arena"). Players see category tabs at the top of the warp menu and can filter by category.

Favorites

Players click the gold star next to any warp to add it to their favorites. Click "Fav" tab to see only favorited warps. Favorites persist across sessions.

Cooldowns & Movement Cancel

• Cooldown: set per warp in seconds. Players see remaining cooldown in the UI.
• Delay: countdown before teleport. If the player moves during the countdown, teleportation is cancelled instantly.

Commands

Configuration

File: UserData/Saves/MODDING/mods/KatsuyaTV_PerfectWarps/config.json

{
  "lang": "EN",
  "maxWarps": 0,
  "defaultParticle": "VFX_Teleport",
  "defaultSound": "SFX_UI_Teleport"
}

maxWarps: 0 = unlimited.

Import / Export

/pw export saves all warps to warps_export.json in the plugin data folder. Copy this file to another server and run /pw import to load them. Only new warps (by name) are added — existing warps are not overwritten.

FAQ

Teleportation cancelled when I move?

Intended behavior. If a warp has a delay, you must stay still during the countdown. Moving more than ~1.4 blocks cancels the teleport.

How do categories work?

Set a category name on a warp via the admin UI. Players see tabs at the top of the warp menu to filter by category.

Can players create warps?

Only admins can create warps. Players can only view and use them via /warps.