HOSH Tpa

Minecraft 版本： 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper purpur

标签： utility

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

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

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

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.