Player Warps

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper

标签： adventure transportation utility

Player Warps

A lightweight, fully configurable player warp plugin with GUI browsing, item-based costs, featured warps, favorites, and no economy dependency.

Player Warps allows players to create, manage, and share their own warps through an intuitive GUI while giving server owners complete control over costs, limits, messages, aliases, world naming, and menu layouts.

Unlike many alternatives, Player Warps does not require Vault or an economy plugin, making it perfect for survival, SMP, and community servers that prefer item-based progression.

Features

Warp Management

• Create and manage player-owned warps
• Easy-to-use GUI warp browser
• Custom warp descriptions
• Custom warp icons
• Player head icon support
• Visit tracking and statistics
• Warp favorites system
• Featured warps system

GUI Features

• Favorites appear first in the GUI
• Right-click warps to favorite/unfavorite them
• Dedicated featured warp slots
• Configurable GUI layouts
• Configurable GUI items and slots
• Configurable GUI titles
• Pagination support
• Fully customizable menus

Warp Name Support

PlayerWarps supports advanced warp names including:

• Uppercase letters
• Unicode characters
• Legacy color codes (&a, &b, etc.)
• Hex color codes (&#RRGGBB)
• Spaces in warp names
• Automatic dash-to-space formatting in GUIs

Examples:

/pwarp set Shopping District
/pwarp set &#ff66ccPink Plaza
/pwarp set &bOcean Market
/pwarp set 日本ショップ

Economy-Free Costs

• Item-based warp creation costs
• Item-based featured warp costs
• No Vault dependency
• No economy plugin required

Server Owner Features

• Configurable warp limits
• Teleport delay support
• Teleport cancellation on movement
• Cross-world teleport support
• Configurable command aliases
• Configurable world display names
• YAML-based storage
• Lightweight and performance-friendly

Commands

Player Commands

Admin Commands

Permissions

Configuration

PlayerWarps is designed to be highly configurable.

You can customize:

• Warp creation costs
• Featured warp costs
• Warp limits
• Teleport delays
• GUI titles
• GUI layouts
• GUI items and slots
• Featured warp slots
• Messages and formatting
• Warp aliases
• World display names
• Cross-world teleport settings

Example config.yml

settings:
  max-warps-per-player: -1
  teleport-delay-seconds: 3
  cancel-teleport-on-move: true

  gui-aliases:
    - warps
    - pwarps

world-naming:
  world: Spawn
  world_nether: Nether
  world_2: Pod

costs:
  enabled: true

  create-warp:
    - material: DIAMOND
      amount: 3

  featured-cost:
    - material: DIAMOND
      amount: 5

Example gui.yml

browse:
  featured:
    slots:
      - 45
      - 46
      - 47
      - 51
      - 52
      - 53

Why Player Warps?

Many player warp plugins rely on Vault or economy plugins for warp creation costs.

PlayerWarps uses a simple item-based system instead, making it easy to integrate into survival and progression-focused servers without adding unnecessary dependencies.

Whether you're running a small SMP or a large community server, PlayerWarps provides a clean and configurable way for players to create destinations, shops, towns, attractions, and public points of interest.

Requirements

• Paper 1.21.x
• Java 21+

Support

If you encounter any issues, bugs, or have suggestions for new features, please create an issue on the GitHub repository or contact me on Discord (onlyarial).

Please note that Player Warps is a side project developed in my spare time. While I do my best to review issues and respond to questions, support and updates may not always be immediate. I appreciate your patience and feedback as the project continues to improve.

Links

• Source Code: https://github.com/onlyarial/Player-Warps
• Issues: https://github.com/onlyarial/Player-Warps/issues