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.
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-servere dal serviziogmod.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
superadmininsettings/users.txt - Il tuo SteamID nel formato
STEAM_0:X:XXXXXXXX, visibile con il comandostatusuna 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
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -u gmod ls -lh /home/gmod/backupsL'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:
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 ulxControlla la struttura ottenuta:
ls ulib/lua/autorun/ulib_init.lua ulib/lua/ulib/init.lua ulx/lua/ulib/modules/ulx_init.lua ulx/lua/ulx/init.lua
exitI 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.
sudo systemctl start gmod.serviceAttendi il tempo del caricamento, poi cerca i messaggi dei due addon:
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:
sudo -u gmod ls /home/gmod/gmod-server/garrysmod/data/ulib /home/gmod/gmod-server/garrysmod/data/ulxPasso 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:
rcon_address IP_DEL_SERVER:27015
rcon_password TuaPassword
rcon ulx adduserid "STEAM_0:X:XXXXXXXX" superadminSe sei già superadmin in users.txt
Se il tuo account compare in settings/users.txt, connettiti e registralo in ULX dalla console del gioco:
ulx adduser "TuoNickname" superadminVerificare il risultato
Riconnettiti al server, poi digita nella console del gioco:
ulx whoIl 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:
ulx addgroup moderatore operator
ulx groupallow moderatore "ulx kick"
ulx setgroupcantarget moderatore "!%admin"
ulx adduser "NicknameModeratore" moderatoreIl 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:
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/data/ulx/config.txtEcco alcune impostazioni utili. Le righe che iniziano con ; sono commenti.
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:
sudo systemctl restart gmod.servicePer 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:
rcon ucl_backup_users force
rcon ucl_restore_users latestIl 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:
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.serviceRipeti 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:
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.serviceLe modifiche fatte dopo questo archivio, come i nuovi ban, vanno perse.
Disattivare ULX
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.serviceIl 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.