Minecraft plugin AxVaults

🔌 Over AxVaults

AxVaults is een lichtgewicht Minecraft-plugin op basis van permissies die per speler virtuele vaults (opslag) biedt. Het project wordt onderhouden door Artillex-Studios en is ontworpen om elk item op te slaan (inclusief items met NBT), duplicatie te voorkomen en beheerders toegang te geven om vaults te bekijken en aan te passen.

🎯 Doel

AxVaults lost de behoefte op aan permanente, geïsoleerde spelersopslag die werkt met aangepaste items en NBT-data, terwijl het probeert duplicatie-exploits te vermijden. Het is bedoeld voor servers die configureerbare, via permissies beheerde vaults willen als alternatief voor of aanvulling op fysieke kisten.

⚙️ Functies

• Vault-toegang op basis van permissies via nodes in de vorm axvaults.vault.<number>.
• Onbeperkt aantal vault-slots per speler (in de praktijk begrensd door integer-limieten).
• NBT-veilige opslag: items worden binair opgeslagen om aangepaste itemdata te behouden.
• Dupe-bescherming by design (opslag beheerd door de plugin in plaats van ruwe itemserialisatie).
• Selector-GUI/menu om door vault-pagina’s te navigeren met pagination-ondersteuning.
• Blacklistsysteem om te voorkomen dat specifieke items in vaults worden geplaatst.
• Aanpasbare iconen waarmee spelers vault-iconen kunnen kiezen.
• Beheertools om vaults van spelers te bekijken en aan te passen, inclusief offline-toegang voor staff.
• Database-ondersteuning voor H2 en SQLite als opslag-backends.

🧩 Voor wie is dit

• Survival- en SMP-servers die privé-opslag per speler nodig hebben.
• Servers die aangepaste items of crates gebruiken en NBT-veilige opslag vereisen.
• Servers met beheer die stafftoegang nodig hebben om vaults van spelers te inspecteren of aan te passen.

🏗️ Voorbeeldgebruik

• Spelers een vast aantal vaults geven via permissies (bijv. axvaults.vault.1, axvaults.vault.5).
• Het selectormenu gebruiken zodat spelers snel verschillende vault-pagina’s kunnen openen.
• Voorkomen dat crate-sleutels of andere economie-items in vaults worden opgeslagen met de blacklist.
• Staff kan de vault van een speler ophalen of aanpassen terwijl die speler offline is.

🔐 Permissies

⚙️ Installatie

📥 Setup

• Download de officiële plugin-jar en plaats deze in de plugins/-map van je server voor Bukkit/Spigot/Paper-gebaseerde servers.
• Herstart de server en controleer de serverconsole om te bevestigen dat de plugin is geladen.
• Configureer permissies (wijs indien nodig de nodes axvaults.vault.<number> toe) met je permissieplugin.

📦 Afhankelijkheden

• Standaard zijn er geen runtime-afhankelijkheden vereist (geen bevestigde verplichte plugins). De plugin gebruikt zijn eigen opslag-backends.

🧾 Configuratie

• De plugin gebruikt configureerbare opslag-backends (H2, SQLite zijn gedocumenteerd als ondersteund).
• Blacklist, icooninstellingen en vault-opslagrijen zijn configureerbaar (zie de officiële documentatie voor details).

🧠 Technische notities

• De projectrepository en officiële bronnen worden onderhouden door Artillex-Studios.
• De plugin adverteert ondersteuning voor H2- en SQLite-opslag.
• Beheerders kunnen vaults van offline spelers openen (offline admin-toegang is gedocumenteerd).
• De plugin zegt dupe-proof te zijn by design en items binair op te slaan om NBT te behouden.
• Controleer de Java-vereiste en ondersteunde serverversies in de officiële release notes voordat je het uitrolt.

🤝 Wanneer deze plugin nuttig is

Als je NBT-veilige, op permissies gebaseerde virtuele opslag nodig hebt voor spelers, met staff-inspectietools en eenvoudige databasegebaseerde opslag (H2/SQLite), biedt AxVaults een gerichte oplossing zonder extra afhankelijkheden.