Minecraft plugin AxVaults

🔌 O AxVaults

AxVaults je lehký Minecraft plugin založený na oprávněních, který poskytuje virtuální vaulty pro každého hráče (úložiště). Projekt spravuje Artillex-Studios a je navržen tak, aby ukládal jakoukoli položku (včetně položek s NBT), zabránil duplikaci a nabídl admin přístup pro zobrazení a úpravu vaultů.

🎯 Účel

AxVaults řeší potřebu perzistentního, izolovaného hráčského úložiště, které funguje s vlastními předměty a daty NBT a zároveň se snaží vyhnout exploitům s duplikací. Je určen pro servery, které chtějí konfigurovatelné vaulty řízené oprávněními jako alternativu nebo doplněk k fyzickým truhlám.

⚙️ Funkce

• Přístup do vaultů na základě oprávnění pomocí node ve tvaru axvaults.vault.<number>.
• Neomezený počet slotů vaultu pro každého hráče (prakticky omezený limity integeru).
• NBT-safe ukládání: předměty jsou ukládány v binární podobě, aby se zachovala vlastní data předmětů.
• Ochrana proti dupe podle návrhu (úložiště spravované pluginem místo surové serializace předmětů).
• Výběrové GUI/menu pro procházení stránek vaultu s podporou pagination.
• Systém blacklistu pro zabránění ukládání určitých předmětů do vaultů.
• Přizpůsobitelné ikony umožňující hráčům vybrat si ikony vaultu.
• Admin nástroje pro zobrazení a úpravu vaultů hráčů, včetně offline přístupu pro staff.
• Podpora databází H2 a SQLite jako storage backendů.

🧩 Pro koho je to určeno

• Servery Survival a SMP, které potřebují soukromé úložiště pro každého hráče.
• Servery používající vlastní předměty nebo crates a vyžadující NBT-safe ukládání.
• Servery se správou administrátory, které potřebují přístup staffu ke kontrole nebo úpravě vaultů hráčů.

🏗️ Příklady použití

• Poskytnout hráčům pevný počet vaultů pomocí oprávnění (např. axvaults.vault.1, axvaults.vault.5).
• Použít menu výběru, aby hráči mohli rychle otevírat různé stránky vaultů.
• Zabránit ukládání klíčů ke crates nebo jiných ekonomických předmětů do vaultů pomocí blacklistu.
• Staff může získat nebo upravit vault hráče, když je hráč offline.

🔐 Oprávnění

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální jar pluginu a vložte jej do adresáře plugins/ vašeho serveru pro servery založené na Bukkit/Spigot/Paper.
• Restartujte server a zkontrolujte server console, abyste ověřili, že se plugin načetl.
• Nakonfigurujte oprávnění (udělte node axvaults.vault.<number> podle potřeby) pomocí vašeho permissions pluginu.

📦 Závislosti

• Ve výchozím stavu nejsou vyžadovány žádné runtime závislosti (žádné potvrzené povinné pluginy). Plugin používá vlastní storage backendy.

🧾 Konfigurace

• Plugin používá konfigurovatelné storage backendy (H2, SQLite byly zdokumentovány jako podporované).
• Blacklist, nastavení ikon a řádky ukládání vaultů jsou konfigurovatelné (podrobnosti viz oficiální dokumentace).

🧠 Technické poznámky

• Úložiště projektu a oficiální zdroje spravuje Artillex-Studios.
• Plugin uvádí podporu úložišť H2 a SQLite.
• Admini mohou přistupovat k vaultům offline hráčů (offline admin přístup je zdokumentován).
• Plugin uvádí, že je dupe-proof podle návrhu a ukládá předměty v binární podobě, aby zachoval NBT.
• Před nasazením si ověřte požadavek na Java a podporované verze serveru v oficiálních release notes.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete NBT-safe, oprávněními řízené virtuální úložiště pro hráče s nástroji pro kontrolu staffu a jednoduchým databázovým ukládáním (H2/SQLite), AxVaults poskytuje cílené řešení bez nutnosti dalších závislostí.