TPA Forms Bridge v2

A Spigot plugin that integrates TPA (Teleport Ask) functionality with GeyserMenu, providing a beautiful form-based TPA experience for Bedrock players.

Version Paper Java License

✨ Features

	Feature	Description
👁️	TPA Button in GeyserMenu	Adds a TPA button with Ender Eye icon to the main GeyserMenu
👥	Player List Form	Shows online players with their skins to send TPA requests
⚡	Auto-Accept TPA	Optional per-player setting to automatically accept incoming TPA requests
💬	Forms Delivery Toggle	Switch between form-based or chat-based TPA request notifications
🦴	SkinsRestorer Support	Shows player skins even on cracked servers
📱	Bedrock-Only	Only shows to Bedrock players via Floodgate detection

📸 Screenshots

TPA Menu	TPA Settings

Teleport Menu	Player Action

TPA Accept Menu

📋 Requirements

Plugin	Status
EssentialsX	Required
Floodgate	Required
GeyserMenuCompanion	Required
SkinsRestorer	Optional

Paper/Spigot 1.20.4+
Java 21+

🚀 Installation

Install all required plugins — EssentialsX, Floodgate, GeyserMenuCompanion
Download TPAFormsBridge-2.0.0-SNAPSHOT.jar
Place it in your plugins/ folder
Restart your server — config generates on first run

⚙️ Configuration

# config.yml

# Default settings for new players
defaults:
  auto-accept-tpa: false    # Auto-accept TPA requests (not TPAHere)
  forms-delivery: true      # Show TPA requests as forms (vs chat)

# Messages
messages:
  tpa-sent:      "&aTPA request sent to %player%"
  tpa-received:  "&e%player% wants to teleport to you"
  auto-accepted: "&aTPA request auto-accepted"

🔄 How It Works

Bedrock player opens inventory
        ↓
  GeyserMenu appears
        ↓
  Player clicks TPA
        ↓
  Player list form opens
        ↓
  Player selects target → TPA sent via EssentialsX
        ↓
  Target receives form (forms-delivery) or chat message

Player Settings

Each player can individually configure:

Auto-Accept TPA — automatically accept TPA requests (TPAHere excluded for safety)
Forms Delivery — receive TPA requests as Bedrock forms instead of chat messages

🔑 Permissions

Permission	Description	Default
`tpaforms.use`	Access TPA forms	`true`
`tpaforms.settings`	Access settings menu	`true`

🔨 Building

./gradlew build

Output: build/libs/TPAFormsBridge-2.0.0-SNAPSHOT.jar

📦 Dependencies

Dependency	Purpose
GeyserMenu	Geyser extension for form menus
GeyserMenuCompanion	Spigot-side API
EssentialsX	TPA functionality
Floodgate	Bedrock player detection

📄 License

Distributed under the GNU General Public License v3.0. See LICENSE for details.