Torna al blog

EssentialsX : Guida completa all'installazione e configurazione

Impara a installare e configurare EssentialsX sul tuo server Minecraft. Guida completa: comandi, economia, kit, permessi e configurazione avanzata.

EssentialsX : Guida completa all'installazione e configurazione

Introduzione

EssentialsX è il plugin più popolare e completo per i server Minecraft. Fork moderno del leggendario Essentials, offre oltre 130 comandi e funzionalità essenziali per ogni amministratore di server.

Perché scegliere EssentialsX?

  • +130 comandi — Teleportazione, economia, kit, warp, case...
  • Gratuito e open-source — Mantenuto attivamente dalla comunità
  • Modulare — Installa solo ciò di cui hai bisogno
  • Compatibile — Funziona con Spigot, Paper, Purpur (1.8 a 1.21+)
  • Personalizzabile — Configurazione dettagliata di ogni funzionalità
  • Tradotto — Supporto multilingue incluso il francese

Installazione

Prerequisiti

Elemento Versione Minima
Minecraft 1.8.8+ (raccomandato 1.20+)
Server Spigot, Paper, Purpur
Java 17+ (per MC 1.20+)
Vault Raccomandato per l'economia

Passo 1 : Download

Scarica EssentialsX solo dalle fonti ufficiali:

⚠️ Attenzione : Non scaricare mai da siti non ufficiali. Rischio di malware!

Passo 2 : Installazione

1. Ferma il tuo server
2. Posiziona EssentialsX-X.X.X.jar nella cartella /plugins/
3. (Facoltativo) Aggiungi i moduli desiderati
4. Avvia il server
5. EssentialsX genera automaticamente i suoi file di configurazione

Passo 3 : Verifica

/plugins

EssentialsX deve apparire in verde. Puoi anche testare:

/essentials

Moduli EssentialsX

EssentialsX è modulare. Installa solo ciò di cui hai bisogno:

Moduli Disponibili

Modulo Descrizione Indispensabile?
EssentialsX Plugin principale (comandi di base) ✅ Sì
EssentialsX Chat Formattazione della chat, prefissi, colori ✅ Raccomandato
EssentialsX Spawn Gestione dello spawn, respawn, newbie spawn ✅ Raccomandato
EssentialsX AntiBuild Restrizioni di costruzione per permesso Facoltativo
EssentialsX Discord Collegamento Discord ↔ Minecraft Facoltativo
EssentialsX GeoIP Localizzazione geografica dei giocatori Facoltativo
EssentialsX Protect Protezione di base del mondo Facoltativo
EssentialsX XMPP Supporto Jabber/XMPP Raro

Installazione Raccomandata (Server Sopravvivenza)

plugins/
├── EssentialsX-2.XX.X.jar          # Principale
├── EssentialsXChat-2.XX.X.jar      # Chat
├── EssentialsXSpawn-2.XX.X.jar     # Spawn
└── Vault-X.X.X.jar                  # Economia (dipendenza)

Dipendenze Facoltative

Plugin Utilità con EssentialsX
Vault Connessione con l'economia e i permessi
LuckPerms Gestione avanzata dei permessi
PlaceholderAPI Variabili nella chat e nei messaggi

Configurazione di Base

Dopo il primo avvio, EssentialsX genera i suoi file in /plugins/Essentials/.

Struttura dei File

plugins/Essentials/
├── config.yml           # Configurazione principale
├── messages.properties  # Messaggi personalizzabili
├── items.json          # Alias degli oggetti
├── kits.yml            # Configurazione dei kit
├── spawn.yml           # Coordinate dello spawn
├── warps/              # File dei warps
└── userdata/           # Dati dei giocatori

Configurazione Essenziale (config.yml)

Apri config.yml e modifica questi parametri chiave:

Lingua del Plugin

# Cambia la lingua (fr per francese)
locale: fr

Pseudonimo e Soprannome

# Consentire i soprannomi colorati
change-displayname: true


Formato dello pseudonimo (con soprannome)


nickname-prefix: '~'


Lunghezza massima del soprannome


max-nick-length: 15


Consentire i colori nei soprannomi


nick-color: true

Messaggi di Connessione/Disconnessione

# Disattivare i messaggi predefiniti (se utilizzi un altro plugin)
custom-join-message: "none"
custom-quit-message: "none"


O personalizzare


custom-join-message: "&8[&a+&8] &7{DISPLAYNAME}"
custom-quit-message: "&8[&c-&8] &7{DISPLAYNAME}"

Teleportazione

# Ritardo prima della teleportazione (in secondi)
teleport-delay: 3


Annulla se il giocatore si muove


teleport-cancel-on-move: true


Cooldown tra le teleportazioni


teleport-cooldown: 30


Teleportazione gratuita per l'OP


teleport-cost: 0

Comandi Essenziali

Comandi Giocatori

Comando Descrizione Permesso
/spawn Tornare allo spawn essentials.spawn
/home Andare a casa essentials.home
/sethome [nome] Impostare una casa essentials.sethome
/delhome [nome] Eliminare una casa essentials.delhome
/tpa <giocatore> Richiedere una teleportazione essentials.tpa
/tpaccept Accettare una richiesta essentials.tpaccept
/tpdeny Rifiutare una richiesta essentials.tpdeny
/back Tornare alla posizione precedente essentials.back
/warp <nome> Andare a un warp essentials.warp
/warps Lista dei warps essentials.warp.list
/bal Vedi il proprio saldo essentials.balance
/pay <giocatore> <importo> Inviare denaro essentials.pay
/kit <nome> Ricevere un kit essentials.kit
/kits Lista dei kit essentials.kit.list
/msg <giocatore> <messaggio> Messaggio privato essentials.msg
/r <messaggio> Rispondere all'ultimo MP essentials.msg
/afk Mettersi AFK essentials.afk
/nick <pseudonimo> Cambiare il proprio soprannome essentials.nick
/seen <giocatore> Ultimo accesso di un giocatore essentials.seen
/mail send <giocatore> <msg> Inviare una mail essentials.mail.send
/mail read Leggere le proprie mail essentials.mail
/helpop <messaggio> Richiedere aiuto allo staff essentials.helpop

Comandi Moderazione

Comando Descrizione Permesso
/tp <giocatore> Teletrasportarsi a un giocatore essentials.tp
/tphere <giocatore> Teletrasportare un giocatore a sé essentials.tphere
/tppos <x> <y> <z> Teleportazione alle coordinate essentials.tppos
/tpall Teletrasportare tutti a sé essentials.tpall
/kick <giocatore> [ragione] Espellere un giocatore essentials.kick
/ban <giocatore> [ragione] Bannire un giocatore essentials.ban
/tempban <giocatore> <durata> Bannire temporaneamente essentials.tempban
/unban <giocatore> Riammmettere un giocatore essentials.unban
/mute <giocatore> [durata] Rendere muto essentials.mute
/unmute <giocatore> Rendere la parola essentials.unmute
/jail <giocatore> <prigione> Imprigionare essentials.jail
/unjail <giocatore> Liberare essentials.unjail
/vanish Diventare invisibile essentials.vanish
/invsee <giocatore> Vedere l'inventario essentials.invsee
/socialspy Spiare i MP essentials.socialspy
/broadcast <messaggio> Messaggio globale essentials.broadcast

Comandi Amministrazione

Comando Descrizione Permesso
/setspawn Impostare lo spawn essentials.setspawn
/setwarp <nome> Creare un warp essentials.setwarp
/delwarp <nome> Eliminare un warp essentials.delwarp
/createkit <nome> <ritardo> Creare un kit dall'inventario essentials.createkit
/eco give <giocatore> <importo> Dare denaro essentials.eco.give
/eco take <giocatore> <importo> Ritirare denaro essentials.eco.take
/eco set <giocatore> <importo> Impostare il saldo essentials.eco.set
/god [giocatore] Modalità invincibile essentials.god
/fly [giocatore] Modalità volo essentials.fly
/speed <1-10> Velocità di movimento essentials.speed
/heal [giocatore] Curare essentials.heal
/feed [giocatore] Nutrire essentials.feed
/gamemode <modalità> Cambiare modalità di gioco essentials.gamemode
/time <giorno/notte> Cambiare l'ora essentials.time
/weather <sole/pioggia> Cambiare il tempo essentials.weather
/essentials reload Ricaricare la config essentials.reload

Sistema Economico

EssentialsX include un sistema economico completo.

Configurazione dell'Economia

In config.yml:

# Simbolo della valuta
currency-symbol: '€'


Nome della valuta (singolare/plurale)


currency-singular: 'euro'
currency-plural: 'euros'


Denaro di partenza


starting-balance: 1000


Saldo massimo (0 = illimitato)


max-money: 10000000000000


Saldo minimo (può essere negativo per consentire debiti)


min-money: -10000


Formato di visualizzazione


economy-log-enabled: false

Comandi Economia

# Giocatori
/bal                    # Vedi il proprio saldo
/baltop                 # Classifica dei più ricchi
/pay <giocatore> <importo> # Inviare denaro


Amministrazione


/eco give <giocatore> 1000  # Dare 1000€
/eco take <giocatore> 500   # Ritirare 500€
/eco set <giocatore> 5000   # Impostare il saldo a 5000€
/eco reset <giocatore>      # Ripristinare al saldo di partenza

Integrazione con Vault

Per collegare l'economia ad altri plugin (negozi, lavori...):

  1. Installa Vault : Scarica Vault
  2. Posizionalo in /plugins/
  3. Riavvia il server
  4. L'economia di EssentialsX viene automaticamente rilevata

Kit e Warp

Creare un Kit

Metodo 1 : Via il gioco (Raccomandato)

# Metti gli oggetti desiderati nel tuo inventario
# Poi crea il kit con il ritardo in secondi
/createkit starter 86400

Metodo 2 : File kits.yml

kits:
  starter:
    delay: 86400  # 24 ore in secondi
    items:
      - stone_sword 1
      - leather_helmet 1
      - leather_chestplate 1
      - leather_leggings 1
      - leather_boots 1
      - cooked_beef 16
      - torch 32
      

  vip:
    delay: 43200  # 12 ore
    items:
      - diamond_sword 1 sharpness:2
      - diamond_pickaxe 1 efficiency:3
      - golden_apple 5
      - ender_pearl 8


  weekly:
    delay: 604800  # 7 giorni
    items:
      - diamond 16
      - emerald 32
      - netherite_ingot 2

Incantesimi nei Kit

Formato : oggetto quantità incantesimo:nivel

items:
  - diamond_sword 1 sharpness:5 unbreaking:3 fire_aspect:2
  - diamond_pickaxe 1 efficiency:5 fortune:3 unbreaking:3
  - elytra 1 unbreaking:3 mending:1

Permessi dei Kit

# Permesso per utilizzare il kit "starter"
essentials.kit.starter


Permesso per utilizzare tutti i kit


essentials.kit.*

Creare dei Warps

# Posizionati nel luogo desiderato
/setwarp shop        # Crea il warp "shop"
/setwarp arena       # Crea il warp "arena"
/setwarp spawn       # Crea il warp "spawn"


Eliminare un warp


/delwarp shop


Elencare i warps


/warps

Permessi dei Warps

# Accesso a un warp specifico
essentials.warps.shop


Accesso a tutti i warps


essentials.warps.*

Case e Teleportazione

Configurazione delle Case

In config.yml:

# Numero di case per default
default-home-limit: 1


Case per gruppo (con LuckPerms)


Imposta tramite i permessi : essentials.sethome.multiple.<numero>

Permessi Multi-Casa

Permesso Effetto
essentials.sethome.multiple.2 2 case
essentials.sethome.multiple.5 5 case
essentials.sethome.multiple.unlimited Case illimitate

Esempio con LuckPerms

# Giocatori normali : 2 case
/lp group default permission set essentials.sethome.multiple.2


VIP : 5 case


/lp group vip permission set essentials.sethome.multiple.5


Staff : illimitato


/lp group staff permission set essentials.sethome.multiple.unlimited

Configurazione Teleportazione

# Ritardo prima della teleportazione (in secondi)
teleport-delay: 3


Disattivare il ritardo per alcuni gruppi tramite permesso


essentials.teleport.timer.bypass


Cooldown tra le /tpa


teleport-cooldown: 60


Durata di validità di una richiesta TPA


tpa-accept-cancellation: 120


Teleportazione verso i giocatori AFK


teleport-to-afk: true

Permessi

Struttura dei Permessi EssentialsX

essentials.<comando>              # Permesso di base
essentials.<comando>.others       # Utilizzare su altri giocatori
essentials.<comando>.<argomento>   # Argomenti specifici

Permessi Raccomandati per Gruppo

Gruppo : default (Giocatori)

permissions:
  - essentials.spawn
  - essentials.home
  - essentials.sethome
  - essentials.delhome
  - essentials.tpa
  - essentials.tpaccept
  - essentials.tpdeny
  - essentials.back
  - essentials.back.ondeath
  - essentials.warp
  - essentials.warp.list
  - essentials.balance
  - essentials.balance.others
  - essentials.pay
  - essentials.kit
  - essentials.kit.starter
  - essentials.msg
  - essentials.mail
  - essentials.mail.send
  - essentials.afk
  - essentials.seen
  - essentials.list
  - essentials.motd
  - essentials.rules
  - essentials.helpop
  - essentials.sethome.multiple.2

Gruppo : VIP

permissions:
  - essentials.nick
  - essentials.nick.color
  - essentials.back.ondeath
  - essentials.kit.vip
  - essentials.sethome.multiple.5
  - essentials.tpa.cooldown.bypass
  - essentials.teleport.timer.bypass

Gruppo : Moderatore

permissions:
  - essentials.tp
  - essentials.tphere
  - essentials.tppos
  - essentials.kick
  - essentials.kick.notify
  - essentials.mute
  - essentials.mute.notify
  - essentials.tempban
  - essentials.tempban.notify
  - essentials.jail
  - essentials.vanish
  - essentials.vanish.see
  - essentials.invsee
  - essentials.socialspy
  - essentials.helpop.receive
  - essentials.fly
  - essentials.god

Gruppo : Admin

permissions:
  - essentials.*
  # O selettivamente :
  - essentials.ban
  - essentials.unban
  - essentials.setspawn
  - essentials.setwarp
  - essentials.delwarp
  - essentials.createkit
  - essentials.eco
  - essentials.eco.give
  - essentials.eco.take
  - essentials.eco.set
  - essentials.gamemode
  - essentials.time
  - essentials.weather
  - essentials.broadcast
  - essentials.essentials

Configurazione con LuckPerms (Esempio Completo)

# Creare i gruppi
/lp creategroup vip
/lp creategroup mod
/lp creategroup admin


Gerarchia


/lp group vip parent add default
/lp group mod parent add vip
/lp group admin parent add mod


Permessi Giocatore


/lp group default permission set essentials.spawn
/lp group default permission set essentials.home
/lp group default permission set essentials.sethome
/lp group default permission set essentials.tpa
/lp group default permission set essentials.warp
/lp group default permission set essentials.balance
/lp group default permission set essentials.kit.starter


Permessi VIP


/lp group vip permission set essentials.fly
/lp group vip permission set essentials.nick
/lp group vip permission set essentials.kit.vip


Permessi Mod


/lp group mod permission set essentials.kick
/lp group mod permission set essentials.mute
/lp group mod permission set essentials.vanish
/lp group mod permission set essentials.tp


Permessi Admin


/lp group admin permission set essentials.*

Configurazione Avanzata

EssentialsX Chat

Installa EssentialsXChat per personalizzare la chat.

Configurazione in config.yml:

# Attivare il formattazione della chat
chat:
  # Formato globale della chat
  format: '{DISPLAYNAME}&7: &f{MESSAGE}'
  

Formato per gruppo (richiede Vault + LuckPerms)


group-formats:
    default: '&7[Giochi] {DISPLAYNAME}&7: &f{MESSAGE}'
    vip: '&6[VIP] {DISPLAYNAME}&7: &f{MESSAGE}'
    mod: '&9[Mod] {DISPLAYNAME}&7: &f{MESSAGE}'
    admin: '&c[Admin] {DISPLAYNAME}&7: &f{MESSAGE}'

Variabili Chat Disponibili

Variabile Descrizione
{DISPLAYNAME} Pseudonimo o soprannome del giocatore
{USERNAME} Pseudonimo reale
{MESSAGE} Messaggio inviato
{GROUP} Gruppo del giocatore
{PREFIX} Prefisso LuckPerms
{SUFFIX} Suffix LuckPerms
{WORLD} Mondo attuale
{WORLDNAME} Nome del mondo

EssentialsX Spawn

Configurazione dello spawn in config.yml:

# Teletrasportare allo spawn al login
spawn-on-join: true


Solo per i nuovi giocatori


spawn-on-join: newbies


Spawn per gruppo


spawn-on-join-groups:


    

  • default
    • 



Respawn allo spawn (invece del letto)


respawn-at-spawn: true


Spawn per mondo


respawn-at-spawn-by-world: false

Configurazione in spawn.yml:

spawns:
  default:
    world: world
    x: 0.5
    y: 100.0
    z: 0.5
    yaw: 0.0
    pitch: 0.0

Messaggi Personalizzati (MOTD, Regole)

Messaggio del Giorno (MOTD)

Crea/modifica motd.txt:

&6╔════════════════════════════════════╗
&6║  &eBenvenuto su &bIlMioServer&e !        &6║
&6║                                    &6║
&6║  &7• Sito: &fwww.ilmioserver.it        &6║
&6║  &7• Discord: &fdiscord.gg/ilmioserver &6║
&6║  &7• Negozio: &f/shop                &6║
&6║                                    &6║
&6║  &aBuon divertimento!                  &6║
&6╚════════════════════════════════════╝

Regole

Crea/modifica rules.txt:

&6&l▬▬▬ REGOLAMENTO DEL SERVER ▬▬▬


&e1. &fRispettare tutti i giocatori
&e2. &fNiente cheat o hack
&e3. &fNiente grief o furto
&e4. &fNiente pubblicità o spam
&e5. &fUsare il buonsenso


&7Violazione di queste regole = Ban permanente

Codici Colore

Codice Colore Codice Colore
&0 Nero &8 Grigio scuro
&1 Blu scuro &9 Blu
&2 Verde scuro &a Verde chiaro
&3 Ciano scuro &b Ciano
&4 Rosso scuro &c Rosso
&5 Viola &d Rosa
&6 Oro &e Giallo
&7 Grigio &f Bianco
Codice Formato
&l Grassetto
&o Corso
&n Sottolineato
&m ~~Barrato~~
&r Resetta

Risoluzione dei Problemi

Problemi Frequenti

"Comando sconosciuto" dopo l'installazione

Cause possibili:

  1. Il plugin non è stato caricato correttamente
  2. Conflitto con un altro plugin

Soluzioni:

# Verificare che il plugin sia caricato
/plugins


Se rosso, controllare i log


/logs/latest.log


Riavviare correttamente


/stop

L'economia non funziona con altri plugin

Soluzione:

  1. Installa Vault
  2. Controlla che Vault rilevi EssentialsX:
/vault-info economy

I permessi non funzionano

Verifiche:

# Testare un permesso
/essentials:perm <giocatore> essentials.fly


Con LuckPerms, controllare


/lp user <giocatore> permission check essentials.fly

Le case/warps non si salvano

Cause:

  • Problema di permessi file
  • Arresto brusco del server

Soluzioni:

# Salvare manualmente
/essentials save


Controllare i permessi della cartella


chmod -R 755 plugins/Essentials/

Messaggi di errore nella console

Errore: "Dati del giocatore non trovati"

  • Normale per i nuovi giocatori
  • I dati vengono creati al primo accesso

Errore: "Impossibile caricare la configurazione"

  • Errore di sintassi YAML
  • Usa un validatore YAML online
  • Controlla gli spazi (niente tabulazioni!)

Comandi di Diagnostica

# Versione di EssentialsX
/essentials version


Ricaricare la configurazione


/essentials reload


Debug di un giocatore


/essentials debug


Informazioni economia


/essentials eco

Reset Completo

Se tutto è rotto:

1. Ferma il server
2. Salva la cartella plugins/Essentials/
3. Elimina plugins/Essentials/
4. Riavvia il server (rigenera le configurazioni predefinite)
5. Riconfigura progressivamente

Comandi Rapidi - Aiuto-Memoria

Configurazione Iniziale

# 1. Imposta lo spawn
/setspawn


2. Crea i warp importanti


/setwarp shop
/setwarp arena
/setwarp mine


3. Crea il kit di partenza


(con oggetti nell'inventario)


/createkit starter 86400


4. Testa


/kit starter
/warp shop
/spawn

Gestione Giocatore Rapida

# Teleportazione
/tp <giocatore>           # Andare verso
/tphere <giocatore>       # Portare a sé


Moderazione


/kick <giocatore> ragione
/tempban <giocatore> 1h ragione
/mute <giocatore> 10m


Economia


/eco give <giocatore> 1000

Risorse Utili

Conclusione

EssentialsX è la base di ogni buon server Minecraft. Con questa guida, hai tutte le chiavi per:

  • Installare e configurare correttamente il plugin
  • Gestire l'economia, i kit e i warps
  • Configurare i permessi per gruppo
  • Personalizzare la chat e i messaggi
  • Risolvere i problemi comuni

Prossimi passi raccomandati:

  1. Installare LuckPerms per permessi avanzati
  2. Configurare EssentialsX Chat per una chat professionale
  3. Creare kit adatti al tuo gameplay
  4. Personalizzare i messaggi (MOTD, regole)
Torna al blog