Plugin Minecraft PlayerPoints

🔌 O PlayerPoints

PlayerPoints to plugin do Minecraft, który zapewnia serwerom system waluty oparty na punktach. Udostępnia API, dzięki czemu inne pluginy mogą integrować się bezpośrednio, oferuje opcjonalne hooki dla popularnych pluginów i zawiera obsługę przechowywania opartą na SQL.

🎯 Cel

PlayerPoints ma zapewniać serwerom lekką, drugorzędną ekonomię (punkty), którą inne pluginy mogą przyznawać, wydawać lub odczytywać. Rozwiązuje potrzebę prostego, skryptowalnego systemu punktów/waluty bez konieczności używania pełnego pluginu ekonomicznego.

⚙️ Funkcje

• System waluty oparty na punktach dla kont graczy.
• Publiczne API, aby inne pluginy mogły odczytywać i modyfikować punkty.
• Obsługa SQL do trwałego przechowywania (repozytorium opisuje obsługę SQL).
• Opcjonalne hooki integracyjne dla Vault i PlaceholderAPI.
• Przy pierwszym uruchomieniu tworzy własny folder danych pluginu i zapisuje tam konfigurację/dane.

🧩 Dla kogo

• Serwery Survival i SMP, które chcą dodatkowej waluty w punktach.
• Serwery potrzebujące prostego API, aby autorzy pluginów mogli przyznawać lub sprawdzać punkty graczy.
• Serwery, które preferują opcjonalną integrację z Vault/PlaceholderAPI.

🏗️ Przykładowe zastosowania

• Przyznawanie punktów jako nagród za minigry lub questy.
• Używanie punktów jako waluty do kupowania kosmetyków lub uprawnień serwera przez inny plugin.
• Pluginy odczytujące punkty do tworzenia systemów rang, rankingów lub śledzenia postępów.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik jar pluginu z oficjalnego zasobu i umieść go w katalogu plugins/ swojego serwera.
• Uruchom serwer. Przy pierwszym starcie PlayerPoints utworzy folder plugins/PlayerPoints zawierający pliki konfiguracji i danych.
• Potwierdź, że plugin został załadowany, sprawdzając konsolę serwera pod kątem komunikatów PlayerPoints.

📦 Zależności

• Brak wymaganych zależności.
• Opcjonalnie: Vault (opcjonalny hook) i PlaceholderAPI (opcjonalny hook).

🧠 Uwagi techniczne

• Oficjalne źródła podają kompatybilność ze Spigot i jego forkami; zalecany jest Paper. CraftBukkit nie jest obsługiwany.
• Projekt deklaruje wsparcie dla wersji Minecraft 1.8.8 i nowszych.
• Plugin jest open-source na licencji GPL-3.0 i udostępnia API do integracji przez inne pluginy.

🤝 Kiedy ten plugin jest przydatny

Gdy potrzebujesz prostego, skryptowalnego systemu punktów z API i opcjonalną integracją z popularnymi pluginami ekosystemu, PlayerPoints oferuje skupione rozwiązanie, do którego inne pluginy mogą niezawodnie się podłączyć.