zTPA

zTPA 2.5 — DOCUMENTATION AND COMMANDS

Developer: SandungaMX Plugin: zTPA Version: 2.5 Minecraft: Paper / Purpur 1.21.11 Java: 21 Compatibility: Java Edition and Bedrock Edition Bedrock Dependencies: Geyser and Floodgate

DESCRIPTION

zTPA is a teleportation plugin for Minecraft Java and Bedrock servers that allows players to send, accept, and reject teleport requests using commands, graphical interfaces, and interactive forms.

It includes an online player selector, configurable menus, protection against unsafe teleports, timeouts, and administrative tools.

FEATURES

• Compatible with Minecraft Java and Bedrock.
• Inventory menus for Java players.
• Interactive forms for Bedrock players.
• Online player selector.
• Confirmation before sending requests via the Bedrock selector.
• Toggleable automatic menu.
• Per-player GUI preference saving.
• Requests with configurable expiration times.
• Configurable cooldown between requests.
• Teleportation with safety checks.
• Administrative teleport commands.
• Permission system compatible with LuckPerms.
• Customizable messages via config.yml.
• Configuration reload without restarting the server.

PLAYER COMMANDS

/tpa Sends a request to teleport to another player.

/tpaccept Accepts a pending teleport request.

/tpdeny Rejects a pending teleport request.

/tpauser Opens a menu showing online players. Allows selecting a user and sending them a TPA request.

/tpagui Manually opens the pending requests menu. /tpagui on Enables the automatic opening of the menu when a TPA request is received.

/tpagui off Disables the automatic opening of the menu. Requests will still arrive via chat and can be accepted using commands.

ADMINISTRATIVE COMMANDS

/tp Teleports the administrator directly to the specified player.

/tphere Teleports the specified player to the administrator's location.

/tpall Teleports all connected players to the administrator's location.

/ztpa reload Reloads the plugin configuration and messages.

PERMISSIONS

ztpa.use Allows use of the TPA request system and the player selector.

ztpa.respond Allows responding to teleportation requests.

ztpa.tp Allows use of /tp.

ztpa.tphere Allows use of /tphere.

ztpa.tpall Allows use of /tpall.

ztpa.reload Allows reloading the plugin configuration.

CONFIGURATION WITH LUCKPERMS

Grant TPA permission to the default group:

/lp group default permission set ztpa.use true /lp group default permission set ztpa.respond true

Grant administrative permissions to the moderator group:

/lp group moderador permission set ztpa.tp true /lp group moderador permission set ztpa.tphere true

Grant mass teleportation permissions to the administrator group:

/lp group administrador permission set ztpa.tpall true /lp group administrador permission set ztpa.reload true

MENU SYSTEM

JAVA EDITION

Players can use /tpauser to view an inventory interface displaying the heads of connected players.

Selecting a player sends a teleportation request.

BEDROCK EDITION

Bedrock players have access to interactive forms to select users and confirm the sending of requests. Incoming requests can be managed using accept or reject buttons.

MENU ACTIVATION

Each player can control whether their interface opens automatically:

/tpagui on — Enable. /tpagui off — Disable.

This preference is saved after disconnecting or restarting the server.

COOLDOWN SYSTEM

The plugin allows you to configure a waiting period between TPA requests.

Example: 60 seconds.

The cooldown helps prevent spam requests and system abuse.

REQUEST EXPIRATION

Pending requests can automatically expire after a configurable amount of time.

Once a request expires, it can no longer be accepted.

SAFE TELEPORTATION

The plugin includes checks to find suitable locations before performing certain teleports.

This helps reduce issues related to solid blocks and dangerous positions.

CONFIGURATION FILES

plugin.yml Defines the plugin's commands, permissions, and core information.

config.yml Allows customization of messages, cooldowns, expiration times, and GUI options.

gui-preferences.yml Stores individual player preferences for enabling or disabling the automatic GUI.

INSTALLATION

1. Download the file.
2. Copy the generated JAR file into the server's plugins folder.
3. Install Geyser and Floodgate if you wish to use Bedrock forms.
4. Restart the server.