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 | |---|---|---| | 👁️ | Bedrock-Only | Adds a TPA button with Ender Eye icon to the main GeyserMenu | | 👥 | Bedrock-Only | Shows online players with their skins to send TPA requests | | ⚡ | Bedrock-Only | Optional per-player setting to automatically accept incoming TPA requests | | 💬 | Bedrock-Only | Switch between form-based or chat-based TPA request notifications | | 🦴 | Bedrock-Only | 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 21+ - 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

```yaml

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:

- Forms Delivery — 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

```bash ./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 GNU General Public License v3.0 for details.