Installare e configurare DarkRP su Garry's Mod
Installa DarkRP sul tuo server Garry's Mod Linux: gamemode, addon darkrpmodification, impostazioni, lavori personalizzati, aggiornamenti, ripristino e risoluzione dei problemi.
In questa pagina
Questa guida spiega come trasformare il tuo server Garry's Mod in un server di roleplay con DarkRP: installazione del gamemode, personalizzazione senza toccarne il codice, aggiunta di un lavoro, aggiornamenti e ripristino.
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, dallo scriptstart.she dal serviziogmod.service - Lo script
/home/gmod/backup.sh, descritto nella sezione Backup automatico della stessa guida - Un accesso SSH con
sudo - Garry's Mod sul tuo PC, per verificare il risultato in gioco
Organizzazione dei file
DarkRP separa il suo codice dalle tue impostazioni. Tutti i percorsi qui sotto partono da /home/gmod/gmod-server/garrysmod.
| Elemento | Posizione | Ruolo |
|---|---|---|
| Gamemode | gamemodes/darkrp |
Codice di DarkRP, da non modificare mai |
| Addon di personalizzazione | addons/darkrpmodification |
Le tue impostazioni, lavori ed entità |
| Database | sv.db |
Database SQLite del server, compresi i dati dei giocatori |
| Log di DarkRP | data/darkrp_logs |
Cronologia delle azioni sul server |
Passo 1: salvare il server
Arresta il server, avvia il backup e conserva una copia dello script di avvio:
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -u gmod cp -p /home/gmod/gmod-server/start.sh /home/gmod/start.sh.prima-darkrpVerifica che l'archivio e la copia esistano:
sudo -u gmod ls -lh /home/gmod/backups /home/gmod/start.sh.prima-darkrpPasso 2: installare DarkRP e il suo addon
Apri una sessione con l'utente gmod, poi scarica i due repository ufficiali. Se hai già clonato DarkRP con la guida all'installazione, non viene scaricato una seconda volta.
sudo -iu gmod
cd ~/gmod-server/garrysmod
[ -d gamemodes/darkrp ] || git clone https://github.com/FPtje/DarkRP.git gamemodes/darkrp
git clone https://github.com/FPtje/darkrpmodification.git addons/darkrpmodificationControlla la presenza dei file attesi:
ls gamemodes/darkrp/darkrp.txt addons/darkrpmodification/lua/darkrp_config/settings.luaEntrambi i percorsi devono essere mostrati senza errori. Mantieni questi nomi di cartelle in minuscolo: Linux distingue le maiuscole dalle minuscole.
Passo 3: attivare il gamemode
Sempre con l'utente gmod, sostituisci il gamemode nello script di avvio e controlla il risultato:
sed -i 's/+gamemode sandbox/+gamemode darkrp/' ~/gmod-server/start.sh
grep -n '+gamemode' ~/gmod-server/start.shLa riga mostrata deve contenere +gamemode darkrp. Se compare un altro gamemode, correggila con nano ~/gmod-server/start.sh.
Esci dalla sessione e avvia il server:
exit
sudo systemctl start gmod.servicePer questa prima prova, tieni la mappa gm_construct. Potrai installare una mappa di roleplay quando il gamemode sarà validato.
Passo 4: verificare il funzionamento
Controlla il servizio, poi cerca eventuali errori nei suoi log:
sudo systemctl is-active gmod.service
sudo journalctl -u gmod.service -n 300 --no-pager | grep -iE 'corrupt team|does not exist|lua error|\[error\]'Il primo comando deve rispondere active. Il secondo non deve mostrare nulla.
Connettiti poi al server dal gioco:
- Premi F4: si apre il menu di DarkRP con l'elenco dei lavori
- Nella chat, digita
/rpname Mario Rossi: il nome del tuo personaggio cambia - Scegli un lavoro nel menu F4: il tuo personaggio ne assume l'aspetto
I contenuti di DarkRP sono pubblicati sul Workshop e il gamemode vi è collegato tramite il suo identificativo: il gioco li propone ai giocatori al momento della connessione.
Passo 5: modificare le impostazioni
Apri il file di configurazione:
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_config/settings.luaEcco alcune impostazioni comuni, con il loro valore originale:
| Impostazione | Valore originale | Effetto |
|---|---|---|
GM.Config.startingmoney |
500 |
Denaro ricevuto alla prima connessione |
GM.Config.normalsalary |
45 |
Stipendio iniziale dei nuovi giocatori |
GM.Config.paydelay |
160 |
Intervallo tra due stipendi, in secondi |
GM.Config.currency |
"$" |
Simbolo della valuta |
GM.Config.currencyLeft |
true |
Simbolo a sinistra (true) o a destra (false) dell'importo |
GM.Config.allowrpnames |
true |
Consente il comando /rpname |
GM.Config.respawntime |
1 |
Attesa minima prima di rinascere, in secondi |
GM.Config.maxdoors |
20 |
Numero massimo di porte per giocatore |
GM.Config.logging |
true |
Attiva i log di DarkRP |
Ad esempio, per mostrare gli importi in euro:
GM.Config.currency = "€"
GM.Config.currencyLeft = falseModifica le righe esistenti invece di duplicarle, poi riavvia il server:
sudo systemctl restart gmod.serviceVerifica la modifica in gioco: l'importo mostrato a schermo deve usare il nuovo simbolo. startingmoney si applica solo ai giocatori che si connettono per la prima volta.
Passo 6: aggiungere un lavoro
Apri il file dei lavori:
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_customthings/jobs.luaAggiungi questo blocco subito dopo il commento di intestazione, prima della riga GAMEMODE.DefaultTeam:
TEAM_GUARDIA = DarkRP.createJob("Guardia", {
color = Color(45, 110, 170, 255),
model = {"models/player/police.mdl", "models/player/police_fem.mdl"},
description = [[Proteggi i negozi della città.]],
weapons = {"stunstick"},
command = "guardia",
max = 3,
salary = 60,
admin = 0,
vote = false,
hasLicense = false,
category = "Citizens",
})| Campo | Descrizione |
|---|---|
color |
Colore del lavoro nella classifica e nei menu |
model |
Modello del personaggio, o elenco di modelli |
description |
Testo mostrato nel menu F4 |
weapons |
Armi ricevute oltre all'equipaggiamento predefinito |
command |
Comando di chat del lavoro, senza /, univoco sul server |
max |
Numero massimo di giocatori, oppure quota dei giocatori se il valore è compreso tra 0 e 1 |
salary |
Stipendio versato al giocatore |
admin |
0 per tutti, 1 per gli admin, 2 per i superadmin |
vote |
Richiede un voto per ottenere il lavoro |
hasLicense |
Concede una licenza di porto d'armi |
category |
Categoria del menu F4, che deve già esistere. Citizens è fornita da DarkRP |
Riavvia il server, poi verifica in gioco che Guardia compaia nel menu F4 e che il comando /guardia funzioni:
sudo systemctl restart gmod.serviceIl repository Git dell'addon tiene traccia delle tue modifiche. Per rileggerle, o per annullare quelle di un file:
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons/darkrpmodification
git diff
git checkout -- lua/darkrp_customthings/jobs.lua
exitIl comando git checkout cancella le tue modifiche a quel file: lancialo solo per tornare alla sua versione originale.
Disattivare o modificare un lavoro originale
I lavori forniti si disattivano in addons/darkrpmodification/lua/darkrp_config/disabled_defaults.lua. Ad esempio, ["gangster"] = true, nell'elenco DarkRP.disabledDefaults["jobs"] rimuove il lavoro Gangster.
Per modificare un lavoro originale, disattivalo, poi copia la sua definizione da gamemodes/darkrp/gamemode/config/jobrelated.lua in jobs.lua. Non disattivare citizen senza adattare GAMEMODE.DefaultTeam, perché è il lavoro assegnato ai giocatori quando arrivano.
Comandi utili in gioco
| Comando | Effetto | Accesso |
|---|---|---|
/rpname <nome> |
Cambia il nome del personaggio | Tutti |
/job <titolo> |
Cambia il titolo del lavoro mostrato | Tutti |
/setspawn <comando del lavoro> |
Sostituisce il punto di comparsa del lavoro con la tua posizione | Amministratori |
/addspawn <comando del lavoro> |
Aggiunge un punto di comparsa al lavoro | Amministratori |
/setmoney <giocatore> <importo> |
Imposta il denaro di un giocatore | In base al permesso DarkRP_SetMoney |
DarkRP include lo strumento di amministrazione FAdmin e la protezione degli oggetti FPP. Per gestire il tuo team con gruppi dettagliati, consulta Installare ULX e ULib.
Passare a una mappa di roleplay
Aggiungi la mappa alla tua collezione Workshop, come indicato nella guida all'installazione del server, poi cambia la mappa di avvio in start.sh:
sudo -u gmod nano /home/gmod/gmod-server/start.sh +map rp_nome_mappa \Il nome è quello del file .bsp, senza l'estensione. Riavvia poi il servizio. Se il server non si avvia più con questa mappa, rimetti gm_construct.
Per i contenuti assenti dal Workshop, consulta Distribuire i contenuti con FastDL e Nginx.
Database
DarkRP usa per impostazione predefinita il database SQLite sv.db, già coperto da backup.sh, e non serve alcuna configurazione. Un database MySQL esterno si configura in addons/darkrpmodification/lua/darkrp_config/mysql.lua e richiede il modulo MySQLOO. Salva i tuoi dati prima di qualsiasi modifica.
Aggiornare DarkRP
Arresta il server, fai il backup, annota la versione attuale, poi aggiorna:
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -iu gmod
git -C ~/gmod-server/garrysmod/gamemodes/darkrp rev-parse HEAD > ~/darkrp-prima-aggiornamento.txt
git -C ~/gmod-server/garrysmod/gamemodes/darkrp pull --ff-only
exit
sudo systemctl start gmod.serviceRipeti poi le verifiche del passo 4. Non serve aggiornare darkrpmodification ogni volta: se un'impostazione manca in settings.lua, DarkRP usa il suo valore predefinito.
Tornare indietro
Tornare alla versione precedente di DarkRP
sudo systemctl stop gmod.service
sudo -iu gmod
git -C ~/gmod-server/garrysmod/gamemodes/darkrp reset --hard "$(cat ~/darkrp-prima-aggiornamento.txt)"
exit
sudo systemctl start gmod.serviceTornare alla modalità Sandbox
sudo systemctl stop gmod.service
sudo -u gmod cp -p /home/gmod/start.sh.prima-darkrp /home/gmod/gmod-server/start.sh
sudo systemctl start gmod.serviceLe cartelle di DarkRP restano al loro posto e non vengono più usate.
Ripristinare i dati
Elenca i backup, poi ripristina quello che preferisci. Tutto ciò che è cambiato dopo quel backup, come il denaro dei giocatori, va perso.
sudo systemctl stop gmod.service
sudo -iu gmod
ls -1t ~/backups | head -n 5
tar -xzf ~/backups/gmod_AAAA-MM-GG_HH-MM-SS.tar.gz -C ~/gmod-server/garrysmod
exit
sudo systemctl start gmod.serviceIn caso di problemi
Il menu F4 non si apre e il server resta in Sandbox
- Verifica la riga
+gamemode darkrpinstart.sh - Verifica che il file
gamemodes/darkrp/darkrp.txtesista, con questo nome esatto in minuscolo - Consulta i log:
sudo journalctl -u gmod.service -n 300 --no-pager
fatal: destination path ... already exists and is not an empty directory
La cartella esiste già. Per darkrpmodification, controlla il contenuto: se contiene le tue impostazioni, non eliminarla.
fatal: detected dubious ownership in repository
Il comando Git è stato lanciato con un utente diverso da gmod. Apri una sessione con sudo -iu gmod e rilancialo.
Corrupt team: Guardia!
Un campo del lavoro non è valido. Il messaggio successivo indica quale, ad esempio The salary must be a number and it must be greater than zero.. Se leggi This job does not have a unique command., scegli un altro valore per command.
The category of "Guardia" ("...") does not exist!
La categoria indicata non esiste. Il suo nome rispetta maiuscole e minuscole. Usa una categoria esistente oppure creala in addons/darkrpmodification/lua/darkrp_customthings/categories.lua.
Errore Lua che cita darkrp_customthings/jobs.lua
Manca una parentesi graffa, una virgola o delle virgolette vicino alla riga indicata. Correggi il file, oppure torna alla sua versione originale con git checkout, poi riavvia il server.
Addon detected in the darkrp_modules folder.
Un addon completo è stato messo in lua/darkrp_modules. Spostalo in garrysmod/addons/.
There is a player with an invalid team!
Questo errore deriva in genere da un errore precedente. Cerca il primo errore nei log del server, spesso in jobs.lua.
error: Your local changes to the following files would be overwritten by merge
Questo messaggio compare se lanci git pull in darkrpmodification dopo averne modificato i file. Questo aggiornamento non è necessario: lascia l'addon così com'è. Se il messaggio riguarda gamemodes/darkrp, è stato modificato un file del gamemode: git -C ~/gmod-server/garrysmod/gamemodes/darkrp status ti indica quale.
Texture viola o modelli ERROR
Il giocatore non ha ricevuto il contenuto. Verifica che l'opzione di download dei contenuti nel gioco non sia disattivata, poi controlla gli addon della tua collezione Workshop.
FAQ
Posso installare DarkRP dal Workshop?
Sì, il progetto lo pubblica con l'identificativo 248302805. Usa un solo metodo: questa guida impiega Git, che permette di tornare facilmente a una versione precisa.
DarkRP è disponibile in italiano?
Il gamemode è fornito in inglese. Si possono aggiungere traduzioni in lua/darkrp_language, all'interno di darkrpmodification.
Dove trovo altri esempi?
Consulta il wiki di DarkRP, in particolare la pagina Custom job fields.