# HOSH TPA<\/p>\n
A lightweight, feature-rich teleport-request plugin for Spigot servers. Send, accept, and deny `\/tpa` and `\/tpahere` requests with a polished GUI, clickable chat actions, titles, sounds, and configurable timeouts.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
– **Paper** (or compatible) \u2014 **1.19.x \/ 1.20.x \/ 1.21.x**
\n– **Java 17+**
\n– **Hosh Loader (mandatory)** \u2014 This plugin **will not stay enabled** without it. If `HoshLoader.jar` is missing, HOSH TPA disables itself and **server operators** get a message on join. Use **`\/hosh tpa reload`** (via Hosh Loader) to reload this plugin after config changes.
\n– **Auto updates via loader** \u2014 Use `\/hosh update all` to prepare newest compatible HOSH plugin updates for next restart.<\/p>\n
## Downloads<\/p>\n
| | Modrinth |
\n|—|———-|
\n| **Hosh Loader** (install first) | Download Hosh Loader |
\n| **HOSH TPA** (this plugin) | Download HOSH TPA |<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Dual command aliases** \u2014 `\/tpa` and `\/htpa` (same for `\/tpahere` \/ `\/htpahere`) behave identically
\n– **Confirmation GUI** \u2014 Before a request is sent, the requester sees a small inventory GUI with Accept \/ Cancel buttons and the target’s player head
\n– **Clickable chat actions** \u2014 Targets receive `[ACCEPT]` \/ `[DECLINE]` clickable messages in chat
\n– **Title & sound feedback** \u2014 Configurable titles on request received \/ accepted \/ denied, plus success and error sounds
\n– **Teleport countdown** \u2014 Configurable delay before the teleport executes; cancelled on movement (toggleable)
\n– **Request timeout** \u2014 Pending requests automatically expire after a configurable number of seconds; both parties are notified
\n– **Toggle system** \u2014 Players can block incoming requests with `\/tpatoggle`
\n– **Target self-check** \u2014 Players cannot send requests to themselves
\n– **Tab completion** \u2014 All player-facing commands support tab-completing online player names<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | —<\/p>\n ## Configuration<\/p>\n All settings live in the default `config.yml` generated on first run.<\/p>\n “`yaml teleport: feedback: gui: messages: ### Config Sections<\/p>\n | Section | Purpose | —<\/p>\n ## Permissions<\/p>\n No permissions are required \u2014 all commands are open by default. Restrict access with your preferred permission plugin if needed.<\/p>\n —<\/p>\n ## Installation<\/p>\n 1. Download and install **Hosh Loader** in `plugins\/` (required). Clean GUI-based TPA system with smart UX and zero spam.<\/p>\n","protected":false},"featured_media":82204,"template":"","meta":{"_minecraft_slug":"hosh-tpa","_minecraft_project_id":"DUGFDhFh","_minecraft_author":"Hoshiy","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":14,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hosh-tpa.zip","_minecraft_size_bytes":103149,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:52:52.678710Z","_minecraft_date_created":"2026-04-11T21:34:12.612108Z","_minecraft_date_modified":"2026-04-07T15:57:40.869521Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hosh-tpa","_minecraft_icon_attachment_id":82204,"_minecraft_imported_at":"2026-06-04T17:17:13+00:00","_minecraft_import_hash":"d82bbed379e1815acfef26735c5ac9cd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,92],"mod_loader":[132,133],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-82203","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|
\n| `\/tpa
\n| `\/htpa
\n| `\/tpahere
\n| `\/htpahere
\n| `\/tpaaccept [player]` | Accept the latest pending request (optionally from a specific player) |
\n| `\/tpadeny [player]` | Deny the latest pending request (optionally from a specific player) |
\n| `\/tpatoggle` | Toggle whether you accept incoming teleport requests |<\/p>\n
\nprefix: “&8[&bHOSH TPA&8] ”<\/p>\n
\n delay-seconds: 5 # Countdown before teleport (0 = instant)
\n cancel-on-move: true # Cancel countdown if the player moves
\n request-timeout-seconds: 60 # How long a pending request stays valid<\/p>\n
\n sounds-enabled: true
\n sound-success: ENTITY_EXPERIENCE_ORB_PICKUP
\n sound-error: ENTITY_VILLAGER_NO
\n titles-enabled: true
\n title-received: “&eTPA Request”
\n subtitle-received: “&7From &f{player}”
\n title-accepted: “&aAccepted”
\n subtitle-accepted: “&7Teleport starting…”
\n title-denied: “&cDeclined”
\n subtitle-denied: “&7Request denied”<\/p>\n
\n title: “HOSH Tpa Confirm”
\n accept-slot: 11
\n head-slot: 13
\n deny-slot: 15
\n accept-name: “&aAccept”
\n deny-name: “&cCancel”
\n head-name: “&eTarget: &f{player}”<\/p>\n
\n player-only: “&cThis command can only be executed by a player.”
\n usage-htpa: “&7Usage: \/htpa
\n usage-htpahere: “&7Usage: \/htpahere
\n player-not-found: “&cPlayer ‘{player}’ not found.”
\n self-target: “&cYou cannot send a request to yourself.”
\n target-blocked: “&c{player} is currently not accepting requests.”
\n request-already-exists: “&cYou already have a pending request to {player}.”
\n request-sent: “&aRequest sent to {player}.”
\n request-received-tpa: “&e{player} wants to teleport to you.”
\n request-received-tpahere: “&e{player} wants you to teleport to them.”
\n request-cancelled: “&7Request cancelled.”
\n request-expired: “&cRequest expired.”
\n no-pending-request: “&cYou have no pending requests.”
\n teleport-cancel-offline: “&cThe other player is no longer online.”
\n teleport-countdown: “&7Teleporting in {seconds} seconds… Don’t move.”
\n teleport-started: “&aTeleporting…”
\n teleport-cancel-move: “&cTeleport cancelled \u2014 you moved.”
\n toggle-enabled: “&aYou are now blocking incoming teleport requests.”
\n toggle-disabled: “&aYou are now accepting incoming teleport requests.”
\n request-accepted-target: “&aYou accepted the request from {player}.”
\n request-accepted-sender: “&a{player} accepted your request.”
\n request-denied-target: “&cYou denied the request from {player}.”
\n request-denied-sender: “&c{player} denied your request.”
\n“`<\/p>\n
\n|—|—|
\n| `prefix` | Prepended to every chat message |
\n| `teleport` | Delay, move-cancellation, and request expiry |
\n| `feedback` | Sounds, titles, and subtitles for every interaction state |
\n| `gui` | Inventory title, slot positions, and item display names |
\n| `messages` | Every user-facing message with `{player}` \/ `{seconds}` placeholders |<\/p>\n
\n2. Download **HOSH TPA** and place `hosh-tpa-
\n3. Restart the server (full restart recommended after first install).
\n4. Edit `plugins\/HOSH_Tpa\/config.yml` (folder name matches the plugin) to your liking.
\n5. Apply config changes with **`\/hosh tpa reload`** or another restart.<\/p>\n","protected":false},"excerpt":{"rendered":"