Minecraft plugin SimpleTpa

🔌 O SimpleTPA

SimpleTPA je Minecraft plugin, který pro servery poskytuje jednoduchý systém teleport žádostí (TPA). Umožňuje hráčům posílat teleport žádosti jiným hráčům, přijímat nebo zamítat příchozí žádosti, rušit odchozí žádosti a blokovat příchozí žádosti pomocí přepínače. Plugin se zaměřuje na kompaktní, konfigurovatelný workflow pro teleport žádosti ve hře a serverovou konfiguraci.

🎯 Účel

SimpleTPA řeší běžnou potřebu řízené teleportace mezi hráči na multiplayer serverech. Zabraňuje spamu pomocí cooldownů a pravidla jedné čekající žádosti, podporuje warmup/zpoždění před teleportací a dává administrátorům serveru konfigurovatelné chování pro timeouty, zvuky a logování.

⚙️ Funkce

• Teleport žádosti mezi hráči přes /tpa a zpětné žádosti přes /tpahere.
• Akce přijmutí, zamítnutí a zrušení žádosti (/tpaccept, /tpdeny, /tpacancel).
• Přepnutí přijímání příchozích žádostí pomocí /tpatoggle.
• Konfigurovatelný timeout žádosti (výchozí hodnota zobrazená je 60 sekund).
• Konfigurovatelný cooldown mezi odesíláním žádostí pro omezení spamu.
• Warmup/zpoždění teleportace s odpočtem v action baru a zrušením při pohybu nebo poškození.
• Pouze jedna čekající žádost na hráče, aby se zabránilo překrývání žádostí.
• Přizpůsobitelné zvukové efekty pro žádost, přijetí, zamítnutí a úspěšnou teleportaci.
• Plná podpora barevných kódů pro zprávy a podrobné možnosti logování pro adminy.

🧩 Pro koho je to určeno

• Malé a střední Survival/SMP servery, které chtějí lehký TPA systém.
• Servery, které dávají přednost minimalistickému, konfigurovatelnému chování teleport žádostí před větším teleport balíčkem.
• Administrátoři, kteří chtějí konfiguraci pro každý server pro cooldowny, warmupy a logování.

🏗️ Příklady použití

• Hráč použije /tpa k požadavku na teleport k příteli; přítel přijme pomocí /tpaccept a plugin před teleportací použije nakonfigurovaný warmup.
• Server staff zapne /tpatoggle pro členy staffu, aby během akcí nebo moderace blokoval náhodné teleport žádosti.
• Admini nastaví cooldown, aby zabránili hráčům spamovat teleport žádosti.

⌨️ Příkazy

🔐 Oprávnění

⚙️ Instalace

📥 Nastavení

• Stáhněte JAR pluginu z oficiální stránky zdroje pluginu.
• Umístěte stažený .jar do adresáře plugins/ vašeho Spigot serveru.
• Restartujte server a zkontrolujte konzoli serveru, zda se zobrazují zprávy o načtení pluginu.

📦 Závislosti

• Žádné požadované závislosti nejsou dokumentovány.

🧾 Konfigurace

• Plugin používá konfigurační soubor (na stránce zdroje pluginu označený jako config.yml). Při upgradu mezi hlavními verzemi autor doporučuje před restartem odstranit stávající config.yml, aby se použily nové výchozí klíče.
• Mezi dostupné možnosti konfigurace patří timeout žádosti, cooldowny, teleport warmup, zrušení při pohybu/poškození, nastavení zvuků, barevné kódy zpráv a možnosti logování.

🧠 Technické poznámky

• Potvrzené podporované verze Minecraftu (jak jsou uvedeny na stránce zdroje pluginu): 1.19, 1.20, 1.20.6 a 1.21.
• Potvrzená platforma: Spigot.
• Plugin implementuje server-side timeouty, cooldowny a warmup mechaniky a provádí automatické čištění expirovaných žádostí.

🤝 Kdy je tento plugin užitečný

SimpleTPA je užitečný, když potřebujete zaměřený, konfigurovatelný systém teleport žádostí bez přidání plné teleport/homes sady. Hodí se pro servery, které chtějí přímočarý /tpa workflow, cooldowny proti spamu a warmup chování pro bezpečnější teleporty.