?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
TPA Forms Bridge

TPA Forms Bridge

TPA Forms Bridge v2 - Integrates TPA functionality with GeyserMenu for Bedrock players

37
1
37
1

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x

Platforms

Links

View source

Creators

Details

Licensed GPL-3.0-or-later
Published 2 months ago

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

  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.