Plugin Minecraft SimplePets

🔌 O SimplePets

SimplePets to plugin do Minecrafta, który zapewnia towarzyszące pety dla serwerów Java Edition. Oferuje GUI do wybierania i dostosowywania petów, obsługuje wiele petów na gracza oraz zawiera funkcje nastawione na kosmetykę, takie jak jazda na petach i pety jako kapelusz. Projekt jest utrzymywany w publicznym repozytorium i ma oficjalną wiki.

🎯 Cel

SimplePets rozwiązuje problem oferowania graczom lekkich, konfigurowalnych kosmetycznych petów. Jest używany przede wszystkim do zapewniania kosmetycznych nagród, bonusów dla darczyńców lub funkcji hubu/zabawy, gdzie gracze mogą przywoływać, zmieniać nazwy, jeździć i dostosowywać towarzyszące moby.

⚙️ Funkcje

• Wybór i zarządzanie petami przez GUI
• Wiele petów na gracza i indywidualne nazwy petów
• Jazda na petach i funkcja pet jako kapelusz
• Personalizacja petów poprzez wbudowane w plugin GUI "Pet Data Changer"
• System addonów do integracji z innymi pluginami
• Trwały zapis z obsługą MySQL i SQLite
• Opcjonalne integracje wykrywane w czasie uruchomienia (np. wsparcie dla CustomEnderchest)
• API dostępne dla innych pluginów, aby integrować się z SimplePets

🧩 Dla kogo

• Serwery Survival/SMP, które chcą kosmetycznych towarzyszy
• Publiczne sieci oferujące kosmetyki dla darczyńców lub funkcje hubu
• Serwery potrzebujące utrzymywanego zamiennika EchoPets
• Właściciele serwerów szukający rozszerzalnego systemu petów z API dla addonów

🏗️ Przykładowe zastosowania

• Przyznawanie petów jako nagród lub rzeczy do kupienia dla darczyńców
• Pozwalanie graczom dostosowywać i dosiadać pety w lobby lub hubie minigier
• Używanie addonów do integracji zachowania petów z pluginami do claimów lub przechowywania

⌨️ Komendy

Uwaga: SimplePets udostępnia główną komendę /pet z podkomendami; dostępne podkomendy i dokładna składnia mogą się różnić w zależności od wersji pluginu.

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR pluginu dla wersji Minecrafta używanej przez serwer.
• Umieść plik JAR w folderze plugins/ serwera.
• Uruchom serwer ponownie.
• W razie potrzeby edytuj dostępne pliki konfiguracyjne i uruchom ponownie, aby zastosować zmiany.

📦 Zależności

• Opcjonalna integracja: CustomEnderchest (integracja jest wykrywana i używana, jeśli jest obecna).

🧾 Konfiguracja

• Plugin obsługuje trwałe przechowywanie danych przez MySQL lub SQLite (konfigurowalne).
• Plugin tworzy pliki konfiguracyjne i dane w swoim folderze; dokładne nazwy plików zależą od wersji.

🧠 Uwagi techniczne

• Oficjalne źródła wskazują obsługę forków Bukkit/Spigot, w tym Spigot, Paper i Purpur.
• Plugin udostępnia publiczne API, aby inni autorzy pluginów mogli integrować się z SimplePets.
• Licencja: GPL-3.0 (zgodnie z publikacją w repozytorium).

🤝 Kiedy ten plugin jest przydatny

Jeśli chcesz utrzymywanego, opartego na GUI systemu petów do kosmetyki graczy, SimplePets jest przydatny, ponieważ łączy wybór, personalizację, trwałość danych i API addonów, a przy tym obsługuje popularne forki serwerów oraz backendy baz danych.