Come installare e configurare EssentialsX
Installa EssentialsX sul tuo server Minecraft Paper: home, warp, teletrasporto, kit, economia e chat, con i permessi LuckPerms adeguati.
In questa pagina
EssentialsX aggiunge al tuo server i comandi che i giocatori si aspettano: /home, /spawn, /tpa, /warp, /msg, oltre a kit e a un'economia. Questa guida spiega come installarlo su Paper, assegnare i permessi giusti e regolare le opzioni più utili.
Prerequisiti
- Un server con Paper, con il comando
mc-consoleconfigurato nella guida Installare e aggiornare i plugin su Paper - LuckPerms installato, con i gruppi della guida Gestire gradi e permessi con LuckPerms
In questa guida, Steve è un esempio: sostituiscilo con un nome utente reale.
Scegliere la versione giusta
La versione da installare dipende dalla tua versione di Minecraft. Controllala con sudo mc-console version.
| Minecraft | EssentialsX da installare |
|---|---|
| 26.2 o 26.3 | Build di sviluppo 2.22.1 |
| 26.1.2 o 1.21.11 | Versione stabile 2.22.0 |
Scegliere i moduli
EssentialsX è suddiviso in più file, e solo il primo è obbligatorio.
| Modulo | Ruolo | In questa guida |
|---|---|---|
| EssentialsX | Comandi principali, kit, economia | Obbligatorio |
| EssentialsX Spawn | Punto di spawn, /spawn, /setspawn |
Installato |
| EssentialsX Chat | Formato della chat, prefissi e suffissi | Installato |
| EssentialsX AntiBuild | Consentire o meno la costruzione tramite permessi | Facoltativo |
| EssentialsX Protect | Impostazioni del mondo: danni dei creeper, propagazione del fuoco | Facoltativo |
| EssentialsX GeoIP | Localizzazione approssimativa dei giocatori | Facoltativo |
| EssentialsX Discord e Discord Link | Bridge e collegamento con Discord | Facoltativo |
| EssentialsX XMPP | Bridge XMPP, modulo storico | Facoltativo |
Installare Vault ed EssentialsX
Vault permette a EssentialsX di leggere i gruppi e i prefissi di LuckPerms. Senza di esso, i prefissi e le funzioni legate ai gruppi non funzionano.
Scarica Vault, poi i tre moduli della build di sviluppo, adatta a Minecraft 26.3:
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
curl -fL -o Vault.jar https://github.com/MilkBowl/Vault/releases/latest/download/Vault.jar
BASE="https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild"
for MODULE in EssentialsX EssentialsXSpawn EssentialsXChat; do
FICHIER=$(curl -fsSL "$BASE/api/json?tree=artifacts%5BfileName%5D" | jq -r --arg m "$MODULE" '.artifacts[].fileName | select(startswith($m + "-"))')
curl -fL -o "$FICHIER" "$BASE/artifact/jars/$FICHIER"
done
ls -l Vault.jar EssentialsX*.jar
exitPer Minecraft 26.1.2 o 1.21.11, usa invece la versione stabile, al posto del ciclo qui sopra:
BASE="https://github.com/EssentialsX/Essentials/releases/download/2.22.0"
for MODULE in EssentialsX EssentialsXSpawn EssentialsXChat; do
curl -fLO "$BASE/$MODULE-2.22.0.jar"
doneRiavvia il server e attendi la riga Done:
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fVerificare l'installazione
Esci dalla visualizzazione dei log con Ctrl+C, poi esegui:
sudo mc-console plugins
sudo mc-console vault-info
sudo mc-console 'essentials version'Dovresti ritrovare:
Essentials,EssentialsChat,EssentialsSpawn,LuckPermseVaultnell'elenco dei pluginPermission: LuckPermseChat: LuckPermsnella risposta divault-infoEconomy: Essentials Economynella stessa risposta- la stessa versione per tutti i moduli in
essentials version
I file di configurazione si trovano in /opt/minecraft/server/plugins/Essentials.
Assegnare i permessi ai giocatori
Gli operatori hanno accesso a tutto. Gli altri giocatori non hanno accesso ad alcun comando di EssentialsX finché non assegni loro il permesso corrispondente.
Assegna i comandi di uso comune a tutti i giocatori:
for PERM in spawn home sethome delhome tpa tpaccept tpdeny back warp warp.list msg afk list motd rules help balance pay kit kits.tools; do
sudo mc-console "lp group default permission set essentials.$PERM true"
doneCompleta poi i gradi superiori:
for PERM in sethome.multiple sethome.multiple.vip fly; do
sudo mc-console "lp group vip permission set essentials.$PERM true"
done
for PERM in tp tphere kick mute tempban; do
sudo mc-console "lp group moderator permission set essentials.$PERM true"
done
for PERM in setspawn setwarp delwarp eco createkit; do
sudo mc-console "lp group admin permission set essentials.$PERM true"
done| Comando | Effetto | Permesso |
|---|---|---|
/spawn |
Tornare al punto di spawn | essentials.spawn |
/sethome [nome] e /home [nome] |
Creare una home e raggiungerla | essentials.sethome, essentials.home |
/delhome <nome> |
Eliminare una home | essentials.delhome |
/tpa <giocatore> |
Chiedere di teletrasportarsi da un giocatore | essentials.tpa |
/tpaccept e /tpdeny |
Accettare o rifiutare una richiesta | essentials.tpaccept, essentials.tpdeny |
/back |
Tornare alla posizione precedente | essentials.back |
/warp [nome] |
Elencare i warp o raggiungerne uno | essentials.warp, essentials.warp.list |
/msg <giocatore> <messaggio> e /r <messaggio> |
Messaggio privato e risposta | essentials.msg |
/balance e /pay <giocatore> <importo> |
Saldo e pagamento | essentials.balance, essentials.pay |
/kit [nome] |
Elencare i kit o riceverne uno | essentials.kit, essentials.kits.<nome> |
L'elenco completo dei permessi si trova sul sito del progetto.
Regolare la configurazione
Apri il file con l'utente minecraft:
sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/config.ymlIn nano, Ctrl+W permette di cercare un'opzione. Modifica le righe esistenti invece di aggiungerne di nuove e usa solo spazi per l'indentazione.
# Lingua dei messaggi (questa riga è commentata per impostazione predefinita)
locale: it
# Attesa tra due teletrasporti, in secondi
teleport-cooldown: 30
# Ritardo prima del teletrasporto, annullato se il giocatore si muove o viene attaccato
teleport-delay: 3
# Saldo iniziale e valuta
starting-balance: 100
currency-symbol: '€'
currency-symbol-suffix: trueIl numero di home si imposta per grado. Un giocatore senza essentials.sethome.multiple può averne una sola. Con questo permesso riceve il valore default, e essentials.sethome.multiple.vip gli assegna il valore vip:
sethome-multiple:
default: 3
vip: 5
staff: 10Applica le modifiche senza riavviare:
sudo mc-console 'essentials reload'Definire il punto di spawn e i warp
Questi comandi si digitano in gioco, nel punto desiderato, con un account operatore o membro del gruppo admin:
/setspawn
/setspawn newbies
/setwarp boutique/setspawn definisce il punto di spawn generale. /setspawn newbies definisce quello dei nuovi giocatori, utilizzato grazie all'opzione newbies di config.yml:
newbies:
announce-format: '&dDiamo il benvenuto a {DISPLAYNAME}&d sul server!'
spawnpoint: newbies
kit: toolsIl kit indicato viene consegnato alla prima connessione, senza verificare i permessi. Imposta kit: '' per disattivarlo.
Creare un kit
I kit si trovano in plugins/Essentials/kits.yml:
sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/kits.ymlAggiungi il tuo kit nella sezione kits:. delay è il tempo di attesa in secondi tra due utilizzi, e -1 lo rende utilizzabile una sola volta:
kits:
depart:
delay: 86400
items:
- stonesword 1
- stonepickaxe 1
- bread 16Ricarica la configurazione e autorizza il kit:
sudo mc-console 'essentials reload'
sudo mc-console 'lp group default permission set essentials.kits.depart true'Mostrare i gradi nella chat
Con EssentialsX Chat, Vault e LuckPerms, il formato della chat si imposta nella sezione chat di config.yml:
chat:
radius: 0
format: '{DISPLAYNAME}&7:&r {MESSAGE}'{DISPLAYNAME} contiene già il prefisso e il suffisso di LuckPerms. Non aggiungere quindi {PREFIX} accanto, altrimenti il prefisso apparirà due volte. radius: 0 invia i messaggi a tutto il server.
Applica con sudo mc-console 'essentials reload', poi scrivi un messaggio in gioco: deve comparire il prefisso definito in LuckPerms.
Gestire l'economia
Dalla console puoi modificare il saldo di un giocatore che si è già connesso:
sudo mc-console 'eco give Steve 100'
sudo mc-console 'eco take Steve 25'
sudo mc-console 'balance Steve'Grazie a Vault, gli altri plugin compatibili possono usare questa economia.
Verificare il risultato
Connettiti con un account non operatore membro del gruppo default, poi prova:
/sethome maison
/home maison
/spawn
/kit tools
/balanceOgni comando deve funzionare senza il messaggio You do not have access to that command. Se hai attivato locale: it, le risposte vengono mostrate in italiano.
Backup e aggiornamento
La cartella plugins/Essentials contiene la configurazione, i dati dei giocatori e i warp:
sudo tar -czf /opt/minecraft/backups/essentials-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server/plugins EssentialsAggiorna sempre tutti i moduli contemporaneamente, perché devono avere la stessa versione. Per una build di sviluppo:
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
BASE="https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild"
for MODULE in EssentialsX EssentialsXSpawn EssentialsXChat; do
FICHIER=$(curl -fsSL "$BASE/api/json?tree=artifacts%5BfileName%5D" | jq -r --arg m "$MODULE" '.artifacts[].fileName | select(startswith($m + "-"))')
curl -fL -o "$FICHIER" "$BASE/artifact/jars/$FICHIER"
done
exit
sudo systemctl restart minecraft.serviceIn caso di problemi
« You are running an unsupported server version! »
Questa versione di EssentialsX non supporta la tua versione di Minecraft. Installa la build indicata nella tabella all'inizio di questa guida.
« Version mismatch! Please update all Essentials jars to the same version »
I moduli non hanno tutti la stessa versione. Sostituiscili insieme, poi riavvia il server. Verifica con ls /opt/minecraft/server/plugins che non restino due file per lo stesso modulo.
« You do not have access to that command »
Il giocatore non ha il permesso. Verificalo, ad esempio per /home:
sudo mc-console 'lp user Steve permission check essentials.home'/r usa il permesso essentials.msg, e /spawn richiede il modulo EssentialsX Spawn.
« You cannot set more than 1 homes »
Il giocatore ha raggiunto il suo limite. Assegnagli essentials.sethome.multiple e, se necessario, un grado come essentials.sethome.multiple.vip.
« Detected supported permissions plugin LuckPerms without Vault installed »
Vault è assente o non si è caricato. Verifica che compaia in sudo mc-console plugins, poi controlla il risultato di sudo mc-console vault-info.
« The file is broken and Essentials can't open it »
Un file YAML contiene un errore, spesso una tabulazione o un'indentazione errata. I log indicano il file interessato. Correggilo o ripristina il backup, poi riavvia il server.
Un comando di un altro plugin viene sostituito
Se due plugin offrono lo stesso comando, usa la forma completa, ad esempio /essentials:home. Per lasciare definitivamente la priorità all'altro plugin, aggiungi il comando a disabled-commands in config.yml.
Per approfondire, consulta la wiki ufficiale di EssentialsX.