Plugin Minecraft QuickShop-Hikari

🔌 Despre QuickShop-Hikari

QuickShop-Hikari este un plugin Minecraft care implementează magazine de cumpărare/vânzare bazate pe cufere (ChestShops). Jucătorii creează și folosesc magazinele interacționând cu cuferele; cea mai mare parte a gameplay-ului nu necesită comenzi. Proiectul este întreținut de QuickShop-Community și se concentrează pe compatibilitate modernă, siguranța datelor și integrări extensibile.

🎯 Scop

Oferirea unei economii în joc bazate pe obiecte, în care jucătorii pot lista obiecte spre vânzare sau pot crea magazine de cumpărare folosind cufere. Pluginul este destinat administratorilor de servere care doresc o economie fizică, bazată pe cufere, și control per magazin, fără a-i obliga pe jucători să învețe comenzi.

⚙️ Funcționalități

• Crearea de magazine de cumpărare și vânzare folosind cufere și semne (magazine bazate pe cufere).
• Suport pentru date NBT, enchantments, durabilitatea obiectelor, date de poțiuni și ouă de mob.
• Obiect de afișare virtuală comutabil deasupra magazinelor (suportat de ProtocolLib sau PacketEvents).
• Suport pentru cufere nelimitate și comportament mixt de cumpărare/vânzare pentru cufărul dublu.
• Suport pentru blacklist cu opțiuni de permisiune de ocolire.
• Gestionare a permisiunilor per magazin și beneficii ale magazinului între proprietari și alți jucători.
• Suport i18n pentru numele obiectelor și enchantmentelor și sintaxa MiniMessage pentru mesaje.
• Suport pentru datasource H2 (local) și MySQL (la distanță).
• Hook-uri de integrare pentru pluginuri obișnuite de protecție și utilitare (module de compatibilitate disponibile).
• API pentru dezvoltatori (sunt furnizate coordonatele Maven/Gradle) pentru interogarea magazinelor și integrarea funcțiilor.
• Telemetrie bStats cu posibilitate de opt-out prin configurare.

🧩 Pentru cine este

Pentru proprietari și administratori de servere care rulează Survival/SMP sau servere axate pe economie și vor o piață fizică, bazată pe cufere. Se potrivește pentru servere mici și mari care folosesc pluginuri de economie compatibile cu Vault și doresc control per magazin și stocare în bază de date.

🏗️ Exemple de utilizare

• Jucătorii pun obiecte într-un cufăr și îl etichetează pentru a vinde automat stive altor jucători.
• Un admin activează permisiuni per magazin, astfel încât moderatorii să poată administra magazinele în anumite lumi sau regiuni.
• O rețea folosește stocare MySQL pentru a păstra magazinele persistente între instanțele serverului.

⌨️ Comenzi

Notă: documentația proiectului precizează că gameplay-ul normal al jucătorilor nu necesită comenzi; comenzile sunt în principal administrative.

🔐 Permisiuni

⚙️ Instalare

📥 Configurare

• Descărcați jar-ul oficial QuickShop-Hikari din distribuția proiectului (versiunile Modrinth/Spigot/GitHub).
• Puneți fișierul jar în folderul plugins/ al serverului.
• Porniți serverul și verificați că pluginul a fost încărcat (documentația arată rularea comenzii qs în consolă pentru a afișa ajutorul/outputul de test).

📦 Dependențe

Integrări confirmate, obligatorii/opționale, listate de proiect:

• Vault (obligatoriu pentru conectarea economiei)
• Un plugin de economie compatibil cu Vault (exemple oferite de proiect)
• ProtocolLib sau PacketEvents (obligatorii pentru obiectele virtuale de afișare / localizare per jucător)
• LuckPerms (recomandat pentru gestionarea permisiunilor)

🧾 Configurare

• Pluginul creează și folosește config.yml (documentația face referire la cheile config.yml pentru protocolul de afișare și setările de confidențialitate).
• Stocarea datelor suportă H2 local sau MySQL la distanță; opțiunile de configurare sunt disponibile în fișierele de configurare ale pluginului.

🧠 Note tehnice

• Documentația oficială recomandă rularea pe un server bazat pe Paper și menționează o cerință de Java 21.
• Proiectul oferă un API pentru dezvoltatori și coordonate Maven/Gradle pentru utilizare la compilare.
• QuickShop-Hikari include module de compatibilitate pentru pluginuri terțe (de ex. WorldGuard, WorldEdit, OpenInv) ca descărcări opționale.
• Telemetrie: folosește bStats; opt-out prin setările din config.

🤝 Când este util acest plugin

Dacă vrei o piață bazată pe cufere, vizibilă pentru jucători, cu stocare persistentă și control per magazin (nu doar magazine bazate pe GUI sau comenzi), QuickShop-Hikari oferă o implementare modernă, bazată pe bază de date, cu hook-uri pentru pluginuri obișnuite de economie și protecție.