Plugin Minecraft SimpleTpa

🔌 Informazioni su SimpleTPA

SimpleTPA è un plugin Minecraft che fornisce un semplice sistema di richiesta di teletrasporto (TPA) per i server. Permette ai giocatori di inviare richieste di teletrasporto ad altri giocatori, accettare o rifiutare le richieste in arrivo, annullare le richieste in uscita e bloccare le richieste in arrivo con un interruttore. Il plugin si concentra su un flusso di lavoro compatto e configurabile per le richieste di teletrasporto in gioco e sulla configurazione lato server.

🎯 Scopo

SimpleTPA risolve il bisogno comune di un teletrasporto controllato tra giocatori nei server multiplayer. Previene lo spam tramite cooldown e la regola di una sola richiesta in sospeso, supporta un warmup/ritardo prima del teletrasporto e offre agli amministratori del server un comportamento configurabile per timeout, suoni e registrazione.

⚙️ Funzionalità

• Richieste di teletrasporto tra giocatori tramite /tpa e richieste inverse tramite /tpahere.
• Azioni per accettare, rifiutare e annullare le richieste (/tpaccept, /tpdeny, /tpacancel).
• Attiva o disattiva la ricezione delle richieste con /tpatoggle.
• Timeout della richiesta configurabile (il valore predefinito mostrato è 60 secondi).
• Cooldown configurabile tra l'invio delle richieste per ridurre lo spam.
• Warmup/ritardo del teletrasporto con conto alla rovescia nella barra azioni e annullamento in caso di movimento o danni.
• Una sola richiesta in sospeso per giocatore per evitare richieste sovrapposte.
• Effetti sonori personalizzabili per richiesta, accettazione, rifiuto e teletrasporto riuscito.
• Supporto completo ai codici colore per i messaggi e opzioni di log dettagliate per gli amministratori.

🧩 Per chi è

• Server Survival/SMP piccoli e medi che vogliono un sistema TPA leggero.
• Server che preferiscono un comportamento minimo e configurabile per le richieste di teletrasporto invece di una suite di teletrasporto più grande.
• Amministratori che vogliono configurazioni per server per cooldown, warmup e log.

🏗️ Casi d'uso di esempio

• Un giocatore usa /tpa per chiedere di teletrasportarsi da un amico; l'amico accetta con /tpaccept e il plugin applica un warmup configurato prima del teletrasporto.
• Lo staff del server abilita /tpatoggle per i membri dello staff per bloccare richieste di teletrasporto casuali durante eventi o attività di moderazione.
• Gli amministratori impostano un cooldown per impedire ai giocatori di inviare richieste di teletrasporto in spam.

⌨️ Comandi

🔐 Permessi

⚙️ Installazione

📥 Configurazione

• Scarica il JAR del plugin dalla pagina ufficiale della risorsa del plugin.
• Inserisci il file .jar scaricato nella cartella plugins/ del tuo server Spigot.
• Riavvia il server e controlla la console per i messaggi di caricamento del plugin.

📦 Dipendenze

• Non sono documentate dipendenze richieste.

🧾 Configurazione

• Il plugin usa un file di configurazione (indicato come config.yml nella risorsa del plugin). Durante l'aggiornamento tra versioni principali, l'autore consiglia di rimuovere il config.yml esistente prima di riavviare, così da applicare le nuove chiavi predefinite.
• Le opzioni di configurazione disponibili includono timeout delle richieste, cooldown, warmup del teletrasporto, annullamento per movimento/danni, impostazioni audio, codici colore dei messaggi e opzioni di log.

🧠 Note tecniche

• Versioni di Minecraft supportate confermate (come elencato nella risorsa del plugin): 1.19, 1.20, 1.20.6 e 1.21.
• Piattaforma confermata: Spigot.
• Il plugin implementa timeout, cooldown e meccaniche di warmup lato server ed esegue la pulizia automatica delle richieste scadute.

🤝 Quando questo plugin è utile

SimpleTPA è utile quando hai bisogno di un sistema di richieste di teletrasporto mirato e configurabile senza aggiungere una suite completa di teletrasporto/case. Si adatta ai server che vogliono flussi /tpa semplici, cooldown per evitare lo spam e comportamento di warmup per teletrasporti più sicuri.