Plugin Minecraft SimpleTpa

🔌 Tentang SimpleTPA

SimpleTPA adalah plugin Minecraft yang menyediakan sistem permintaan teleport sederhana (TPA) untuk server. Plugin ini memungkinkan pemain mengirim permintaan teleport ke pemain lain, menerima atau menolak permintaan yang masuk, membatalkan permintaan yang dikirim, dan memblokir permintaan masuk dengan toggle. Plugin ini berfokus pada alur kerja yang ringkas dan dapat dikonfigurasi untuk permintaan teleport di dalam game serta konfigurasi sisi server.

🎯 Tujuan

SimpleTPA menyelesaikan kebutuhan umum akan teleportasi pemain-ke-pemain yang terkontrol di server multipemain. Plugin ini mencegah spam melalui cooldown dan aturan satu permintaan tertunda, mendukung warmup/delay sebelum teleportasi, dan memberi administrator server perilaku yang dapat dikonfigurasi untuk timeout, suara, dan pencatatan log.

⚙️ Fitur

• Permintaan teleport pemain-ke-pemain melalui /tpa dan permintaan balik melalui /tpahere.
• Aksi menerima, menolak, dan membatalkan permintaan (/tpaccept, /tpdeny, /tpacancel).
• Toggle menerima permintaan masuk atau tidak dengan /tpatoggle.
• Timeout permintaan yang dapat dikonfigurasi (default yang ditampilkan adalah 60 detik).
• Cooldown yang dapat dikonfigurasi antar pengiriman permintaan untuk mengurangi spam.
• Warmup/delay teleport dengan hitung mundur action bar dan pembatalan saat bergerak atau terkena damage.
• Hanya satu permintaan tertunda per pemain untuk menghindari permintaan yang saling tumpang tindih.
• Efek suara yang dapat disesuaikan untuk permintaan, menerima, menolak, dan teleportasi yang berhasil.
• Dukungan penuh kode warna untuk pesan dan opsi logging yang detail untuk admin.

🧩 Untuk Siapa Ini

• Server Survival/SMP kecil dan menengah yang menginginkan sistem TPA yang ringan.
• Server yang lebih suka perilaku permintaan teleport yang minimal dan dapat dikonfigurasi daripada paket teleportasi yang lebih besar.
• Administrator yang menginginkan konfigurasi per server untuk cooldown, warmup, dan logging.

🏗️ Contoh Penggunaan

• Seorang pemain menggunakan /tpa untuk meminta teleportasi ke teman; teman tersebut menerima dengan /tpaccept dan plugin menerapkan warmup yang dikonfigurasi sebelum teleportasi.
• Staf server mengaktifkan /tpatoggle untuk anggota staf agar memblokir permintaan teleport acak selama acara atau tugas moderasi.
• Admin menetapkan cooldown untuk mencegah pemain spam permintaan teleport.

⌨️ Perintah

🔐 Izin

⚙️ Instalasi

📥 Penyiapan

• Unduh JAR plugin dari halaman resource resmi plugin.
• Letakkan file .jar yang diunduh ke direktori plugins/ server kamu untuk server Spigot.
• Restart server dan periksa konsol server untuk pesan pemuatan plugin.

📦 Dependensi

• Tidak ada dependensi yang diperlukan yang didokumentasikan.

🧾 Konfigurasi

• Plugin ini menggunakan file konfigurasi (dicatat sebagai config.yml pada resource plugin). Saat melakukan upgrade lintas versi mayor, penulis menyarankan menghapus config.yml yang ada sebelum restart agar kunci default baru diterapkan.
• Opsi konfigurasi yang tersedia mencakup timeout permintaan, cooldown, warmup teleport, pembatalan karena gerakan/damage, pengaturan suara, kode warna pesan, dan opsi logging.

🧠 Catatan Teknis

• Versi Minecraft yang dikonfirmasi didukung (sesuai yang tercantum di resource plugin): 1.19, 1.20, 1.20.6, dan 1.21.
• Platform yang dikonfirmasi: Spigot.
• Plugin ini menerapkan timeout, cooldown, dan mekanik warmup di sisi server serta melakukan pembersihan otomatis untuk permintaan yang kedaluwarsa.

🤝 Kapan Plugin Ini Berguna

SimpleTPA berguna saat kamu membutuhkan sistem permintaan teleport yang fokus dan dapat dikonfigurasi tanpa menambahkan paket teleportasi/homes lengkap. Ini cocok untuk server yang menginginkan alur /tpa yang sederhana, cooldown untuk mencegah spam, dan perilaku warmup untuk teleport yang lebih aman.