IT

Server di gioco

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.

9 min di lettura, aggiornato il 18 novembre 2026

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 script start.sh e dal servizio gmod.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:

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

Verifica che l'archivio e la copia esistano:

Terminale
sudo -u gmod ls -lh /home/gmod/backups /home/gmod/start.sh.prima-darkrp

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

Terminale
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/darkrpmodification

Controlla la presenza dei file attesi:

Terminale
ls gamemodes/darkrp/darkrp.txt addons/darkrpmodification/lua/darkrp_config/settings.lua

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

Terminale
sed -i 's/+gamemode sandbox/+gamemode darkrp/' ~/gmod-server/start.sh
grep -n '+gamemode' ~/gmod-server/start.sh

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

Terminale
exit
sudo systemctl start gmod.service

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

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

  1. Premi F4: si apre il menu di DarkRP con l'elenco dei lavori
  2. Nella chat, digita /rpname Mario Rossi: il nome del tuo personaggio cambia
  3. 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:

Terminale
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_config/settings.lua

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

lua
GM.Config.currency                      = "€"
GM.Config.currencyLeft                  = false

Modifica le righe esistenti invece di duplicarle, poi riavvia il server:

Terminale
sudo systemctl restart gmod.service

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

Terminale
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_customthings/jobs.lua

Aggiungi questo blocco subito dopo il commento di intestazione, prima della riga GAMEMODE.DefaultTeam:

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

Terminale
sudo systemctl restart gmod.service

Il repository Git dell'addon tiene traccia delle tue modifiche. Per rileggerle, o per annullare quelle di un file:

Terminale
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons/darkrpmodification
git diff
git checkout -- lua/darkrp_customthings/jobs.lua
exit

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

Terminale
sudo -u gmod nano /home/gmod/gmod-server/start.sh
Testo
    +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:

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

Ripeti 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

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

Tornare alla modalità Sandbox

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

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

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

In caso di problemi

Il menu F4 non si apre e il server resta in Sandbox

  • Verifica la riga +gamemode darkrp in start.sh
  • Verifica che il file gamemodes/darkrp/darkrp.txt esista, 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.