IT

Server di gioco

Come installare e configurare EssentialsX

Installa EssentialsX sul tuo server Minecraft Paper: home, warp, teletrasporto, kit, economia e chat, con i permessi LuckPerms adeguati.

7 min di lettura, aggiornato il 18 novembre 2026

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

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:

Terminale
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
exit

Per Minecraft 26.1.2 o 1.21.11, usa invece la versione stabile, al posto del ciclo qui sopra:

Terminale
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"
done

Riavvia il server e attendi la riga Done:

Terminale
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Verificare l'installazione

Esci dalla visualizzazione dei log con Ctrl+C, poi esegui:

Terminale
sudo mc-console plugins
sudo mc-console vault-info
sudo mc-console 'essentials version'

Dovresti ritrovare:

  • Essentials, EssentialsChat, EssentialsSpawn, LuckPerms e Vault nell'elenco dei plugin
  • Permission: LuckPerms e Chat: LuckPerms nella risposta di vault-info
  • Economy: Essentials Economy nella 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:

Terminale
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"
done

Completa poi i gradi superiori:

Terminale
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:

Terminale
sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/config.yml

In nano, Ctrl+W permette di cercare un'opzione. Modifica le righe esistenti invece di aggiungerne di nuove e usa solo spazi per l'indentazione.

YAML
# 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: true

Il 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:

YAML
sethome-multiple:
  default: 3
  vip: 5
  staff: 10

Applica le modifiche senza riavviare:

Terminale
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:

Testo
/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:

YAML
newbies:
  announce-format: '&dDiamo il benvenuto a {DISPLAYNAME}&d sul server!'
  spawnpoint: newbies
  kit: tools

Il 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:

Terminale
sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/kits.yml

Aggiungi il tuo kit nella sezione kits:. delay è il tempo di attesa in secondi tra due utilizzi, e -1 lo rende utilizzabile una sola volta:

YAML
kits:
  depart:
    delay: 86400
    items:
      - stonesword 1
      - stonepickaxe 1
      - bread 16

Ricarica la configurazione e autorizza il kit:

Terminale
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:

YAML
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:

Terminale
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:

Testo
/sethome maison
/home maison
/spawn
/kit tools
/balance

Ogni 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:

Terminale
sudo tar -czf /opt/minecraft/backups/essentials-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server/plugins Essentials

Aggiorna sempre tutti i moduli contemporaneamente, perché devono avere la stessa versione. Per una build di sviluppo:

Terminale
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.service

In 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:

Terminale
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.