TPA Forms Bridge

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.

---

✨ 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

---

📋 Requirements

Plugin	Status
EssentialsX	Required
Floodgate	Required
GeyserMenuCompanion	Required
SkinsRestorer	Optional

• Paper/Spigot 1.20.4+
• Java 21+

---

🚀 Installation

1. Install all required plugins — EssentialsX, Floodgate, GeyserMenuCompanion
2. Download TPAFormsBridge-2.0.0-SNAPSHOT.jar
3. Place it in your plugins/ folder
4. 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.