Minecraft plugin SimplePets

🔌 Over SimplePets

SimplePets is een Minecraft-plugin die gezelschapsdieren toevoegt voor Java edition-servers. Het biedt een GUI om pets te kiezen en aan te passen, ondersteunt meerdere pets per speler en bevat cosmetische functies zoals op pets rijden en pets als hoed dragen. Het project wordt onderhouden via een openbare repository en een officiële wiki.

🎯 Doel

SimplePets lost het probleem op van lichte, aanpasbare cosmetische pets voor spelers. Het wordt vooral gebruikt voor cosmetische beloningen, donorvoordelen of hub/fun-functies, waarbij spelers companion mobs kunnen oproepen, hernoemen, berijden en aanpassen.

⚙️ Functies

• Petselectie en -beheer via GUI
• Meerdere pets per speler en individuele petnamen
• Op pets rijden en pets als hoed gebruiken
• Pet-aanpassing via de ingebouwde GUI "Pet Data Changer"
• Addon-systeem voor integraties met andere plugins
• Permanente opslag met ondersteuning voor MySQL en SQLite
• Optionele integraties die tijdens runtime worden gedetecteerd (bijvoorbeeld: ondersteuning voor CustomEnderchest)
• API beschikbaar zodat andere plugins met SimplePets kunnen integreren

🧩 Voor wie is dit

• Survival/SMP-servers die cosmetische companions willen
• Openbare netwerken die donorcosmetica of hub-functies aanbieden
• Servers die een onderhouden vervanger voor EchoPets nodig hebben
• Servereigenaars die op zoek zijn naar een uitbreidbaar petsysteem met een API voor addons

🏗️ Voorbeelden van gebruik

• Pets geven als beloning of als aankoopoptie voor donateurs
• Spelers pets laten aanpassen en berijden in een lobby of minigame-hub
• Addons gebruiken om petgedrag te integreren met claim- of opslagplugins

⌨️ Commando's

Opmerking: SimplePets heeft een root-commando /pet met subcommando's; beschikbare subcommando's en de exacte syntaxis kunnen per pluginversie verschillen.

🔐 Permissies

⚙️ Installatie

📥 Setup

• Download de officiële plugin-JAR voor de Minecraft-versie van de server.
• Plaats het JAR-bestand in de plugins/-map van de server.
• Herstart de server.
• Bewerk de beschikbare configuratiebestanden indien nodig en herstart om wijzigingen toe te passen.

📦 Afhankelijkheden

• Optionele integratie: CustomEnderchest (de integratie wordt gedetecteerd en gebruikt als deze aanwezig is).

🧾 Configuratie

• De plugin ondersteunt permanente opslag via MySQL of SQLite (configureerbaar).
• De plugin maakt configuratie- en databestanden aan in de eigen pluginmap; de exacte bestandsnamen hangen af van de versie.

🧠 Technische opmerkingen

• Officiële bronnen geven ondersteuning aan voor Bukkit/Spigot-forks, waaronder Spigot, Paper en Purpur.
• De plugin biedt een gepubliceerde API zodat andere pluginmakers met SimplePets kunnen integreren.
• Licentie: GPL-3.0 (zoals gepubliceerd in de repository).

🤝 Wanneer deze plugin nuttig is

Als je een onderhouden, op GUI gebaseerde petsystem voor spelerscosmetica wilt, is SimplePets handig omdat het selectie, aanpassing, opslag en een addon-API combineert, terwijl het veelgebruikte serverforks en databasebackends ondersteunt.