IT

Server di gioco

Installare ULX e ULib su Garry's Mod

Installa ULX e ULib sul tuo server Garry's Mod Linux: primo superadmin, gruppi, permessi, sanzioni, backup degli amministratori, aggiornamenti e risoluzione dei problemi.

8 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Questa guida spiega come installare ULX, il mod di amministrazione di Garry's Mod, con la sua libreria ULib, poi come nominare i tuoi amministratori, creare gruppi e assegnare loro permessi precisi.

HostMyServers non offre hosting di giochi gestito: amministri tu stesso questo server sul tuo VPS o server dedicato.

Prerequisiti

  • Un server installato con la guida Creare un server Garry's Mod. Questa guida riparte dal suo utente gmod, dalla cartella /home/gmod/gmod-server e dal servizio gmod.service
  • Lo script /home/gmod/backup.sh, descritto nella sezione Backup automatico della stessa guida
  • Un accesso SSH con sudo
  • L'RCON configurato e la porta TCP 27015 autorizzata dal tuo indirizzo IP, oppure un account già dichiarato superadmin in settings/users.txt
  • Il tuo SteamID nel formato STEAM_0:X:XXXXXXXX, visibile con il comando status una volta connesso

Organizzazione dei file

Tutti i percorsi qui sotto partono da /home/gmod/gmod-server/garrysmod.

Elemento Posizione Ruolo
ULib addons/ulib Libreria richiesta da ULX
ULX addons/ulx Comandi e menu di amministrazione
Utenti e ban sv.db Tabelle SQLite ulib_users e ulib_bans
Gruppi data/ulib/groups.txt Gruppi e permessi associati
Copie degli utenti data/ulib_backups Copie create da ULib all'avvio
Configurazione di ULX data/ulx/config.txt Messaggio di benvenuto, log, votazioni
Log di ULX data/ulx_logs Cronologia delle azioni

I file di data/ulx e data/ulib vengono creati al primo avvio con gli addon.

Passo 1: salvare il server

Terminale
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -u gmod ls -lh /home/gmod/backups

L'archivio più recente deve avere la data odierna. Contiene in particolare sv.db, data, settings e addons.

Passo 2: installare ULib e ULX

Apri una sessione con l'utente gmod, poi scarica i repository ufficiali nella cartella degli addon:

Terminale
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons
git clone https://github.com/TeamUlysses/ulib.git ulib
git clone https://github.com/TeamUlysses/ulx.git ulx

Controlla la struttura ottenuta:

Terminale
ls ulib/lua/autorun/ulib_init.lua ulib/lua/ulib/init.lua ulx/lua/ulib/modules/ulx_init.lua ulx/lua/ulx/init.lua
exit

I quattro file devono essere mostrati senza errori. Le cartelle ulib e ulx devono restare in minuscolo.

Passo 3: avviare il server e verificare il caricamento

Serve un riavvio completo: un semplice cambio di mappa non basta.

Terminale
sudo systemctl start gmod.service

Attendi il tempo del caricamento, poi cerca i messaggi dei due addon:

Terminale
sudo journalctl -u gmod.service -n 500 --no-pager | grep -E 'Ulysses Library|ULX Admin Mod'

Le righe Ulysses Library e ULX Admin Mod confermano il loro caricamento. Verifica poi che i file di dati siano stati creati:

Terminale
sudo -u gmod ls /home/gmod/gmod-server/garrysmod/data/ulib /home/gmod/gmod-server/garrysmod/data/ulx

Passo 4: nominare il primo superadmin

Il gruppo superadmin ha accesso a tutti i comandi. Scegli il metodo adatto alla tua situazione.

Tramite l'RCON

Dalla console del gioco, sostituendo i valori di esempio:

Testo
rcon_address IP_DEL_SERVER:27015
rcon_password TuaPassword
rcon ulx adduserid "STEAM_0:X:XXXXXXXX" superadmin

Se sei già superadmin in users.txt

Se il tuo account compare in settings/users.txt, connettiti e registralo in ULX dalla console del gioco:

Testo
ulx adduser "TuoNickname" superadmin

Verificare il risultato

Riconnettiti al server, poi digita nella console del gioco:

Testo
ulx who

Il tuo account deve comparire nel gruppo superadmin. Scrivi poi !menu nella chat: si apre il menu di amministrazione XGUI. Il comando ulx menu fa la stessa cosa dalla console.

Passo 5: creare un gruppo

ULX fornisce questi gruppi:

Gruppo Eredita da Può colpire
user Nessuno Tutti
operator user I giocatori sotto il livello admin
admin operator I giocatori sotto il livello superadmin
superadmin admin Tutti

Per creare un gruppo di moderatori che può solo espellere giocatori, digita questi comandi nella console del gioco con il tuo account superadmin:

Testo
ulx addgroup moderatore operator
ulx groupallow moderatore "ulx kick"
ulx setgroupcantarget moderatore "!%admin"
ulx adduser "NicknameModeratore" moderatore

Il bersaglio !%admin impedisce al gruppo di colpire gli amministratori e i gruppi superiori.

Per verificare, connettiti con l'account del moderatore e lancia ulx help nella console: l'elenco mostra solo i comandi a cui questo account ha accesso. Il tentativo di usare un comando non autorizzato restituisce You don't have access to this command.

Gestire permessi e membri

Comando Effetto
ulx adduser "Nickname" gruppo Aggiunge un giocatore connesso a un gruppo
ulx adduserid "STEAM_0:X:XXXXXXXX" gruppo Aggiunge un giocatore tramite il suo SteamID, anche se assente
ulx removeuser "Nickname" Toglie tutti i permessi a un giocatore connesso
ulx removeuserid "STEAM_0:X:XXXXXXXX" Toglie tutti i permessi tramite SteamID
ulx groupallow gruppo "ulx comando" Concede un permesso a un gruppo
ulx groupdeny gruppo "ulx comando" Toglie un permesso a un gruppo
ulx userallow "Nickname" "ulx comando" Concede un permesso a un giocatore
ulx userdeny "Nickname" "ulx comando" Toglie un permesso a un giocatore
ulx removegroup gruppo Elimina un gruppo
ulx usermanagementhelp Mostra la guida dettagliata sui permessi

Usare ULX ogni giorno

I comandi si usano nella console (ulx kick) o nella chat (!kick).

Console Chat Effetto Accesso predefinito
ulx kick "Nickname" motivo !kick Espelle un giocatore admin
ulx ban "Nickname" 60 motivo !ban Banna per 60 minuti, 0 per un ban definitivo admin
ulx banid "STEAM_0:X:XXXXXXXX" 60 motivo !banid Banna tramite SteamID superadmin
ulx unban "STEAM_0:X:XXXXXXXX" !unban Revoca un ban admin
ulx map nome_mappa !map Cambia mappa admin
ulx noclip !noclip Attiva o disattiva il volo libero admin
ulx spectate "Nickname" !spectate Osserva un giocatore admin

Puoi prendere di mira più giocatori con queste parole chiave: ^ per te stesso, @ per il giocatore che stai guardando, * per tutti, #gruppo per i membri di un gruppo e %gruppo per quel gruppo e quelli che ne ereditano. Un ! posto davanti inverte la selezione.

Configurare ULX

Apri il file di configurazione:

Terminale
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/data/ulx/config.txt

Ecco alcune impostazioni utili. Le righe che iniziano con ; sono commenti.

Testo
ulx showMotd 0
ulx welcomemessage "Benvenuto su %host%, mappa %curmap%."
ulx logFile 1
ulx logDir "ulx_logs"
Impostazione Effetto
ulx showMotd Messaggio alla connessione: 0 disattivato, 1 file, 2 generatore integrato, 3 indirizzo web
ulx welcomemessage Messaggio di benvenuto, vuoto per disattivarlo
ulx logFile Salva i log in un file
ulx logDir Cartella dei log, sotto garrysmod/data

Riavvia il server per applicare le modifiche:

Terminale
sudo systemctl restart gmod.service

Per un'impostazione specifica di un gamemode, crea data/ulx/gamemodes/darkrp/config.txt, adattando il nome del gamemode. Se usi DarkRP, consulta anche Installare e configurare DarkRP.

Salvare gli amministratori

ULib copia l'elenco degli utenti in data/ulib_backups a ogni avvio. Puoi anche lanciare questi comandi tramite l'RCON:

Testo
rcon ucl_backup_users force
rcon ucl_restore_users latest

Il primo crea una copia immediata. Il secondo sostituisce l'elenco attuale con la copia più recente: usalo solo in caso di problemi. Queste copie integrano backup.sh, che resta il tuo vero backup.

Aggiornare ULib e ULX

Aggiorna sempre i due addon insieme, annotando prima la loro versione:

Terminale
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons
git -C ulib rev-parse HEAD > ~/ulib-prima-aggiornamento.txt
git -C ulx rev-parse HEAD > ~/ulx-prima-aggiornamento.txt
git -C ulib pull --ff-only
git -C ulx pull --ff-only
exit
sudo systemctl start gmod.service

Ripeti poi le verifiche del passo 3 e lancia ulx who in gioco.

Tornare indietro

Tornare alla versione precedente

Un aggiornamento può cambiare il formato dei dati. Ripristina quindi anche l'archivio creato subito prima, sostituendo il suo nome:

Terminale
sudo systemctl stop gmod.service
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons
git -C ulib reset --hard "$(cat ~/ulib-prima-aggiornamento.txt)"
git -C ulx reset --hard "$(cat ~/ulx-prima-aggiornamento.txt)"
tar -xzf ~/backups/gmod_AAAA-MM-GG_HH-MM-SS.tar.gz -C ~/gmod-server/garrysmod sv.db data
exit
sudo systemctl start gmod.service

Le modifiche fatte dopo questo archivio, come i nuovi ban, vanno perse.

Disattivare ULX

Terminale
sudo systemctl stop gmod.service
sudo -iu gmod
mkdir -p ~/addon-disattivati
mv ~/gmod-server/garrysmod/addons/ulx ~/gmod-server/garrysmod/addons/ulib ~/addon-disattivati/
exit
sudo systemctl start gmod.service

Il server torna così all'elenco settings/users.txt di Garry's Mod.

In caso di problemi

Il comando ulx è sconosciuto

  • Verifica che il server sia stato riavviato dopo l'installazione
  • Controlla i file del passo 2: una cartella con il nome sbagliato o annidata, come addons/ulx/ulx, impedisce il caricamento
  • Verifica che ULib sia presente: ULX non funziona senza
  • Cerca gli errori: sudo journalctl -u gmod.service -n 500 --no-pager | grep -iE 'ulib|ulx|\[error\]'

Bad RCON password

La password inserita non corrisponde a rcon_password in server.cfg. Se la connessione non riesce affatto, verifica che il tuo indirizzo IP sia autorizzato sulla porta TCP 27015.

Invalid steamid.

Lo SteamID è malformato. Copialo dal comando status e mantieni le virgolette.

invalid group "..." specified

Il gruppo non esiste. Controlla la sua ortografia, oppure crealo con ulx addgroup.

You don't have access to this command

Il tuo account non ha questo permesso. Controlla il tuo gruppo con ulx who e riconnettiti se l'hai appena cambiato.

No player with id "..." exists in the ULib user list

Questo SteamID non ha alcun permesso registrato. Non c'è quindi nulla da togliere.

Un amministratore ritrova il suo gruppo dopo averlo perso

È ancora presente in settings/users.txt, oppure in GM.Config.DefaultPlayerGroups se usi DarkRP. Toglilo da questi elenchi, poi riavvia il server.

The users database failed to load.

ULib non riesce a leggere la sua tabella in sv.db. Il messaggio successivo, Error while querying database was:, indica la causa. Controlla lo spazio su disco con df -h, poi ripristina sv.db dal tuo ultimo archivio, a server arrestato.

Il file users.txt di ULib non cambia più

È normale: le versioni recenti di ULib memorizzano gli utenti in sv.db. Alcune documentazioni citano ancora il vecchio file. Usa i comandi ulx adduser e ulx adduserid.

FAQ

Posso installare ULX dal Workshop?

Sì, con gli identificativi 557962238 per ULib e 557962280 per ULX, da aggiungere alla tua collezione. Rimuovi allora le cartelle addons/ulib e addons/ulx per evitare di avere due copie.

ULX sostituisce FAdmin su DarkRP?

I due strumenti sono indipendenti. FAdmin è fornito con DarkRP. Se preferisci usare solo ULX, puoi disattivarlo con ["fadmin"] = true, in disabled_defaults.lua.

Dove trovo l'elenco completo dei comandi?

Lancia ulx help nella console, oppure consulta il sito del progetto Ulysses.