Plugin Minecraft SimplePets

🔌 Despre SimplePets

SimplePets este un plugin Minecraft care oferă pet-uri companion pentru serverele Java edition. Include un GUI pentru selectarea și personalizarea pet-urilor, suportă mai multe pet-uri per jucător și are funcții orientate spre cosmetice, precum călăritul pe pet și pet-ul purtat ca pălărie. Proiectul este întreținut printr-un repository public și un wiki oficial.

🎯 Scop

SimplePets rezolvă problema oferirii unor pet-uri cosmetice ușoare și personalizabile pentru jucători. Este folosit în principal pentru recompense cosmetice, beneficii pentru donatori sau funcții de hub/fun, unde jucătorii pot genera, redenumi, călări și personaliza mob-uri companion.

⚙️ Funcții

• Selectare și administrare a pet-urilor bazată pe GUI
• Mai multe pet-uri per jucător și nume individuale pentru fiecare pet
• Călăritul pe pet și funcția pet-as-hat
• Personalizare pet prin GUI-ul din plugin "Pet Data Changer"
• Sistem de addon-uri pentru integrări cu alte plugin-uri
• Stocare persistentă cu suport MySQL și SQLite
• Integrări opționale detectate la rulare (exemplu: suport CustomEnderchest)
• API disponibil pentru ca alte plugin-uri să se integreze cu SimplePets

🧩 Pentru cine este

• Servere Survival/SMP care vor companioni cosmetici
• Rețele publice care oferă cosmetice pentru donatori sau funcții de hub
• Servere care au nevoie de un înlocuitor întreținut pentru EchoPets
• Proprietari de servere care caută un sistem de pet-uri extensibil, cu API pentru addon-uri

🏗️ Exemple de utilizare

• Acordarea de pet-uri ca recompense sau obiecte cumpărabile pentru donatori
• Permiterea jucătorilor să personalizeze și să călărească pet-uri într-un lobby sau hub de minigame
• Folosirea addon-urilor pentru a integra comportamentul pet-urilor cu plugin-uri de claim sau storage

⌨️ Comenzi

Notă: SimplePets oferă o comandă rădăcină /pet cu subcomenzi; subcomenzile disponibile și sintaxa exactă pot varia în funcție de versiunea pluginului.

🔐 Permisiuni

⚙️ Instalare

📥 Configurare

• Descărcați JAR-ul oficial al pluginului pentru versiunea Minecraft a serverului.
• Puneți fișierul JAR în folderul plugins/ al serverului.
• Reporniți serverul.
• Editați fișierele de configurare disponibile după nevoie și reporniți pentru a aplica modificările.

📦 Dependențe

• Integrare opțională: CustomEnderchest (integrarea este detectată și folosită dacă este prezentă).

🧾 Configurare

• Pluginul suportă stocare persistentă prin MySQL sau SQLite (configurabil).
• Pluginul creează fișiere de configurare și date în folderul său; numele exacte ale fișierelor depind de versiune.

🧠 Note tehnice

• Sursele oficiale indică suport pentru fork-uri Bukkit/Spigot, inclusiv Spigot, Paper și Purpur.
• Pluginul oferă un API publicat pentru ca alți autori de plugin-uri să se poată integra cu SimplePets.
• Licență: GPL-3.0 (așa cum este publicată în repository).

🤝 Când este util acest plugin

Dacă vrei un sistem de pet-uri întreținut, bazat pe GUI, pentru cosmeticele jucătorilor, SimplePets este util deoarece combină selecția, personalizarea, persistența și un API pentru addon-uri, oferind în același timp suport pentru fork-uri comune de server și backend-uri de baze de date.