SignWarpX
PluginMIT

SignWarpX

SignWarpX is a Minecraft Paper plugin that lets players create and manage teleportation warps easily with signs, groups, and a web/GUI interface.

185
Downloads
2
Followers
2 months ago
Updated
📦
18
Versions

📖About SignWarpX

Introduction

SignWarpX is a teleportation plugin for Minecraft Paper servers.
It lets players create personal, group, or public warps using a simple sign system.
Perfect for city networks or private adventure hubs.

Features

Core Features

  • Sign-based warp system
  • Public / Private / Group warps - with permission control
  • Invite system - for private warps
  • Group management - with batch access control
  • In-game GUI & Web interface - for administration
  • Compass navigation - Navigate to warps using compass with auto permission check every 5 minutes
  • Transfer confirmation setting - with the ability to skip the transfer delay after confirmation

Advanced Teleportation

  • Mount teleportation - Teleport while riding horses, pigs, etc.
  • Boat teleportation - Teleport with boat and entities inside
  • Leash teleportation - Teleport with leashed entities

Customization

  • Customizable messages with placeholders and Markdown syntax support
  • Cooldown system - Configurable teleport delay and cooldowns
  • Item consumption - Require items for teleportation (default: Ender Pearl)
  • Warp limits - Set max warps per player

Requirements

  • Minecraft: 1.21.8+
  • Server: Paper or Paper-based fork
  • Java: 21+

Installation

  1. Download SignWarpX.jar
  2. Place into plugins/ folder
  3. Restart server
  4. (Optional) Edit config.yml

Usage

Create Warp Target

[WPT] or [wpt]
Home

Create Warp Sign

[WP] or [wp]
Home

Warp

  • Hold required item (default: Ender Pearl)
  • Right-click warp sign → Teleport

⚠️ Note: You must create a WarpTarget before creating a Warp sign.

Web Interface

SignWarpX provides a full-featured Web management interface for administrators.

Features

  • Dark/Light mode - One-click theme switching
  • Real-time sync via WebSocket
  • Smart filters & search - Filter by type (public/private/group), creation time, usage frequency
  • RESTful API support for third-party integration
  • Detailed info display - Coordinates, world name, dimension, visibility, usage stats, creator info

Enable in config.yml:

web:
  enabled: true
  port: 8080

Then open: http://your-server-ip:8080

In-Game GUI

/wp gui
  • Warp list & details
  • Visibility & permissions

Preview

🛠 Commands

Main Commands

Command Alias Description Permission
/signwarp reload /wp reload Reload config signwarp.reload
/signwarp gui /wp gui Open GUI signwarp.admin
/signwarp set <public|private> <warp> /wp set Set warp visibility signwarp.private.set
/signwarp invite add <player> <warp> /wp invite add Invite player signwarp.invite
/signwarp invite remove <player> <warp> /wp invite remove Remove player invitation signwarp.invite
/signwarp invite list <warp> /wp invite list View invite list signwarp.invite.list
/signwarp tp <warp> /wp tp Admin teleport signwarp.tp
/signwarp owned [player] /wp owned View own or (OP) others' warps signwarp.admin
/signwarp history [warp|player] /wp history View teleport history signwarp.use
/signwarp navigate start <warp> /wp navigate start Start compass navigation signwarp.use
/signwarp navigate stop /wp navigate stop Stop navigation signwarp.use
/signwarp version /wp version Check plugin version OP
/signwarp group ... /wp group ... Group commands varies

Group Commands

Command Alias Description Permission
/signwarp group create <name> /wp group create Create new group signwarp.group.create
/signwarp group add <group> <warp> /wp group add Add warp to group signwarp.group.manage
/signwarp group remove <group> <warp> /wp group remove Remove warp from group signwarp.group.manage
/signwarp group invite <group> <player> /wp group invite Invite to group signwarp.group.manage
/signwarp group uninvite <group> <player> /wp group uninvite Remove from group signwarp.group.manage
/signwarp group list /wp group list List your groups signwarp.group.create
/signwarp group info <name> /wp group info Show group details Group member or admin
/signwarp group delete <name> /wp group delete Delete group signwarp.group.manage

🖌 Custom Messages

Configurable in config.yml with placeholders:

messages:
  teleport-success: "&aTeleported to {warp-name}!"
  private_warp: "&cThis is a private warp, invitation required."
  invite_success: "&aInvited {player} to use warp '{warp-name}'!"
  group_created: "&aSuccessfully created group '{group-name}'!"

Available Placeholders

{warp-name}, {player}, {inviter}, {use-item}, {use-cost}, {time}, {cooldown}, {visibility}, {current}, {max}, {group-name}, {group-owner}, {member-count}, {warp-count}

Screenshots

Usage Example

Support

License

Licensed under MIT.

🙏 Credits

Forked from siriusbks/SignWarp.
Thanks to the original author for their great work.