Minecraft plugin SimpleTpa

🔌 Over SimpleTPA

SimpleTPA is een Minecraft-plugin die een eenvoudig teleportverzoek-systeem (TPA) voor servers biedt. Hiermee kunnen spelers teleportverzoeken sturen naar andere spelers, inkomende verzoeken accepteren of weigeren, uitgaande verzoeken annuleren en inkomende verzoeken blokkeren met een toggle. De plugin richt zich op een compacte, configureerbare workflow voor teleportverzoeken in-game en serverconfiguratie.

🎯 Doel

SimpleTPA lost de veelvoorkomende behoefte aan gecontroleerde teleportatie van speler naar speler op multiplayerservers op. Het voorkomt spam via cooldowns en regels voor één open verzoek, ondersteunt warmup/delay vóór teleportatie en geeft serverbeheerders configureerbaar gedrag voor time-outs, geluiden en logging.

⚙️ Functies

• Teleportverzoeken tussen spelers via /tpa en omgekeerde verzoeken via /tpahere.
• Acties om verzoeken te accepteren, te weigeren en te annuleren (/tpaccept, /tpdeny, /tpacancel).
• Ontvangen van verzoeken aan of uit zetten met /tpatoggle.
• Configureerbare time-out voor verzoeken (standaard weergegeven als 60 seconden).
• Configureerbare cooldown tussen het versturen van verzoeken om spam te verminderen.
• Teleport-warmup/delay met een action-bar-aftelling en annulering bij bewegen of schade.
• Slechts één open verzoek per speler om overlappende verzoeken te voorkomen.
• Aanpasbare geluidseffecten voor verzoek, acceptatie, weigering en succesvolle teleportatie.
• Volledige ondersteuning voor kleurcodes in berichten en uitgebreide logopties voor admins.

🧩 Voor wie is dit

• Kleine en middelgrote Survival/SMP-servers die een lichtgewicht TPA-systeem willen.
• Servers die liever minimale, configureerbare teleportverzoek-gedragingen hebben dan een grotere teleportatiesuite.
• Beheerders die per server configuratie willen voor cooldowns, warmups en logging.

🏗️ Voorbeeldgebruik

• Een speler gebruikt /tpa om teleportatie naar een vriend aan te vragen; de vriend accepteert met /tpaccept en de plugin past een ingestelde warmup toe vóór de teleportatie.
• Serverpersoneel zet /tpatoggle aan voor stafleden om willekeurige teleportverzoeken te blokkeren tijdens evenementen of moderatietaken.
• Admins stellen een cooldown in om te voorkomen dat spelers teleportverzoeken spammen.

⌨️ Commando's

🔐 Permissies

⚙️ Installatie

📥 Setup

• Download de plugin-JAR vanaf de officiële resourcepagina van de plugin.
• Plaats de gedownloade .jar in je plugins/-map voor een Spigot-server.
• Herstart de server en controleer de serverconsole op laadberichten van de plugin.

📦 Afhankelijkheden

• Er zijn geen vereiste afhankelijkheden gedocumenteerd.

🧾 Configuratie

• De plugin gebruikt een configuratiebestand (aangeduid als config.yml op de plugin-resource). Bij het upgraden over grote versies heen raadt de auteur aan om het bestaande config.yml te verwijderen vóór het herstarten, zodat nieuwe standaardkeys worden toegepast.
• Beschikbare configuratie-opties zijn onder andere time-out voor verzoeken, cooldowns, teleport-warmup, annulering bij beweging/schade, geluidsinstellingen, kleurcodes voor berichten en logopties.

🧠 Technische notities

• Bevestigde ondersteunde Minecraft-versies (zoals vermeld op de plugin-resource): 1.19, 1.20, 1.20.6 en 1.21.
• Bevestigd platform: Spigot.
• De plugin implementeert server-side time-outs, cooldowns en warmup-mechanieken en voert automatische opschoning uit van verlopen verzoeken.

🤝 Wanneer deze plugin nuttig is

SimpleTPA is nuttig wanneer je een gerichte, configureerbare teleportverzoek-systeem nodig hebt zonder een volledige teleportatie/homes-suite toe te voegen. Het past bij servers die een eenvoudige /tpa-workflow willen, cooldowns om spam te voorkomen en warmup-gedrag voor veiligere teleports.