?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
HOSH Tpa

HOSH Tpa

Clean GUI-based TPA system with smart UX and zero spam.

27
1
27
1

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x
1.19.x

Platforms

Links

Join Discord server

Tags

Creators

Details

Licensed ARR
Published 2 months ago

HOSH TPA

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.

Requirements

  • Paper (or compatible) — 1.19.x / 1.20.x / 1.21.x
  • Java 17+
  • Hosh Loader (mandatory) — 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.
  • Auto updates via loader — Use /hosh update all to prepare newest compatible HOSH plugin updates for next restart.

Downloads

Modrinth
Hosh Loader (install first) Download Hosh Loader
HOSH TPA (this plugin) Download HOSH TPA

Features

  • Dual command aliases — /tpa and /htpa (same for /tpahere / /htpahere) behave identically
  • Confirmation GUI — Before a request is sent, the requester sees a small inventory GUI with Accept / Cancel buttons and the target's player head
  • Clickable chat actions — Targets receive [ACCEPT] / [DECLINE] clickable messages in chat
  • Title & sound feedback — Configurable titles on request received / accepted / denied, plus success and error sounds
  • Teleport countdown — Configurable delay before the teleport executes; cancelled on movement (toggleable)
  • Request timeout — Pending requests automatically expire after a configurable number of seconds; both parties are notified
  • Toggle system — Players can block incoming requests with /tpatoggle
  • Target self-check — Players cannot send requests to themselves
  • Tab completion — All player-facing commands support tab-completing online player names

Commands

Command Description
/tpa <player> Open the confirmation GUI to send a teleport-to-player request
/htpa <player> Same as /tpa
/tpahere <player> Open the confirmation GUI to send a teleport-here request
/htpahere <player> Same as /tpahere
/tpaaccept [player] Accept the latest pending request (optionally from a specific player)
/tpadeny [player] Deny the latest pending request (optionally from a specific player)
/tpatoggle Toggle whether you accept incoming teleport requests

Configuration

All settings live in the default config.yml generated on first run.

prefix: "&8[&bHOSH TPA&8] "

teleport:
  delay-seconds: 5            # Countdown before teleport (0 = instant)
  cancel-on-move: true        # Cancel countdown if the player moves
  request-timeout-seconds: 60 # How long a pending request stays valid

feedback:
  sounds-enabled: true
  sound-success: ENTITY_EXPERIENCE_ORB_PICKUP
  sound-error: ENTITY_VILLAGER_NO
  titles-enabled: true
  title-received: "&eTPA Request"
  subtitle-received: "&7From &f{player}"
  title-accepted: "&aAccepted"
  subtitle-accepted: "&7Teleport starting..."
  title-denied: "&cDeclined"
  subtitle-denied: "&7Request denied"

gui:
  title: "HOSH Tpa Confirm"
  accept-slot: 11
  head-slot: 13
  deny-slot: 15
  accept-name: "&aAccept"
  deny-name: "&cCancel"
  head-name: "&eTarget: &f{player}"

messages:
  player-only: "&cThis command can only be executed by a player."
  usage-htpa: "&7Usage: /htpa <player>"
  usage-htpahere: "&7Usage: /htpahere <player>"
  player-not-found: "&cPlayer '{player}' not found."
  self-target: "&cYou cannot send a request to yourself."
  target-blocked: "&c{player} is currently not accepting requests."
  request-already-exists: "&cYou already have a pending request to {player}."
  request-sent: "&aRequest sent to {player}."
  request-received-tpa: "&e{player} wants to teleport to you."
  request-received-tpahere: "&e{player} wants you to teleport to them."
  request-cancelled: "&7Request cancelled."
  request-expired: "&cRequest expired."
  no-pending-request: "&cYou have no pending requests."
  teleport-cancel-offline: "&cThe other player is no longer online."
  teleport-countdown: "&7Teleporting in {seconds} seconds... Don't move."
  teleport-started: "&aTeleporting..."
  teleport-cancel-move: "&cTeleport cancelled — you moved."
  toggle-enabled: "&aYou are now blocking incoming teleport requests."
  toggle-disabled: "&aYou are now accepting incoming teleport requests."
  request-accepted-target: "&aYou accepted the request from {player}."
  request-accepted-sender: "&a{player} accepted your request."
  request-denied-target: "&cYou denied the request from {player}."
  request-denied-sender: "&c{player} denied your request."

Config Sections

Section Purpose
prefix Prepended to every chat message
teleport Delay, move-cancellation, and request expiry
feedback Sounds, titles, and subtitles for every interaction state
gui Inventory title, slot positions, and item display names
messages Every user-facing message with {player} / {seconds} placeholders

Permissions

No permissions are required — all commands are open by default. Restrict access with your preferred permission plugin if needed.

Installation

  1. Download and install Hosh Loader in plugins/ (required).
  2. Download HOSH TPA and place hosh-tpa-<version>.jar in plugins/.
  3. Restart the server (full restart recommended after first install).
  4. Edit plugins/HOSH_Tpa/config.yml (folder name matches the plugin) to your liking.
  5. Apply config changes with /hosh tpa reload or another restart.