Plugin Minecraft QuickShop-Hikari

🔌 Informazioni su QuickShop-Hikari

QuickShop-Hikari è un plugin per Minecraft che implementa negozi di acquisto/vendita basati su casse (ChestShops). I giocatori creano e usano i negozi interagendo con le casse; per la maggior parte del gameplay non servono comandi. Il progetto è mantenuto dalla QuickShop-Community e si concentra su compatibilità moderna, sicurezza dei dati e integrazioni estendibili.

🎯 Scopo

Offrire un’economia in gioco basata sugli oggetti, in cui i giocatori possono mettere in vendita gli item o creare negozi di acquisto usando le casse. Il plugin è pensato per gli amministratori di server che desiderano un’economia fisica, guidata dalle casse, e un controllo per singolo negozio senza costringere i giocatori a imparare comandi.

⚙️ Funzionalità

• Creare negozi di acquisto e vendita usando casse e cartelli (negozi basati su casse).
• Supporto per dati NBT, incantesimi, durabilità degli oggetti, dati delle pozioni e uova di mob.
• Oggetto di visualizzazione virtuale sopra i negozi, attivabile/disattivabile (supporto per ProtocolLib o PacketEvents).
• Supporto per casse illimitate e comportamento misto acquisto/vendita nelle doppie casse.
• Supporto blacklist con opzioni di permesso per il bypass.
• Gestione dei permessi per negozio e vantaggi del negozio tra proprietari e altri giocatori.
• Supporto i18n per nomi di oggetti e incantesimi e sintassi MiniMessage per i messaggi.
• Supporto a H2 (locale) e MySQL (remoto) come datasource.
• Hook di integrazione per plugin comuni di protezione e utilità (moduli di compatibilità disponibili).
• API per sviluppatori (coordinate Maven/Gradle fornite) per interrogare i negozi e integrare funzionalità.
• Telemetria bStats con opzione di disattivazione tramite configurazione.

🧩 A chi è destinato

Proprietari e amministratori di server che gestiscono Survival/SMP o server incentrati sull’economia e desiderano un marketplace fisico basato su casse. Si adatta a server piccoli e grandi che usano plugin economy compatibili con Vault e vogliono controllo per negozio e archiviazione supportata da database.

🏗️ Esempi d’uso

• I giocatori mettono oggetti in una cassa e la etichettano per vendere automaticamente stack ad altri giocatori.
• Un amministratore abilita i permessi per negozio in modo che i moderatori possano gestire i negozi in mondi o regioni specifiche.
• Una rete usa l’archiviazione MySQL per mantenere i negozi persistenti tra le istanze del server.

⌨️ Comandi

Nota: la documentazione del progetto indica che il normale gameplay dei giocatori non richiede comandi; i comandi sono principalmente amministrativi.

🔐 Permessi

⚙️ Installazione

📥 Configurazione

• Scarica il jar ufficiale di QuickShop-Hikari dalla distribuzione del progetto (release Modrinth/Spigot/GitHub).
• Metti il file jar nella cartella plugins/ del tuo server.
• Avvia il server e verifica che il plugin sia stato caricato (la documentazione mostra l’esecuzione del comando qs nella console per visualizzare l’aiuto/l’output di test).

📦 Dipendenze

Integrazioni richieste/opzionali confermate e elencate dal progetto:

• Vault (richiesto per il collegamento con l’economia)
• Un plugin economy compatibile con Vault (esempi forniti dal progetto)
• ProtocolLib o PacketEvents (richiesti per gli oggetti di visualizzazione virtuali / localizzazione per giocatore)
• LuckPerms (consigliato per la gestione dei permessi)

🧾 Configurazione

• Il plugin crea e usa un config.yml (la documentazione fa riferimento a chiavi di config.yml per il protocollo di visualizzazione e le impostazioni sulla privacy).
• L’archiviazione dei dati supporta H2 locale o MySQL remoto; le opzioni di configurazione sono disponibili nei file di configurazione del plugin.

🧠 Note tecniche

• La documentazione ufficiale consiglia l’esecuzione su un server basato su Paper e indica un requisito di Java 21.
• Il progetto fornisce un’API per sviluppatori e coordinate Maven/Gradle per l’uso in fase di compilazione.
• QuickShop-Hikari include moduli di compatibilità per plugin di terze parti (ad es. WorldGuard, WorldEdit, OpenInv) come download opzionali.
• Telemetria: usa bStats; disattivabile tramite le impostazioni di configurazione.

🤝 Quando questo plugin è utile

Se vuoi un marketplace rivolto ai giocatori, guidato dalle casse, con archiviazione persistente e controlli per singolo negozio (anziché negozi solo GUI o guidati da comandi), QuickShop-Hikari offre un’implementazione moderna, supportata da database, con hook per i plugin economy e di protezione più comuni.