server.cfg instellen

Het bestand server.cfg is het belangrijkste configuratiebestand van je FiveM-server. Hierin stel je alles in: van de servernaam tot het maximale aantal spelers, en van je licentie tot de permissies voor admins. In dit artikel lopen we alle belangrijke instellingen door.

server.cfg openen en bewerken

Je vindt het bestand server.cfg in de hoofdmap van je server. Om het te bewerken:

Ga naar mijn.hytalenode.nl en open je FiveM-server.
Klik op de Bestanden tab in het linker menu.
Zoek het bestand server.cfg in de bestandslijst en klik erop om het te openen in de ingebouwde editor.
Pas de gewenste instellingen aan en klik op Opslaan.
Herstart je server om de wijzigingen door te voeren.

Belangrijkste instellingen

Hieronder vind je de instellingen die je sowieso moet configureren:

sv_hostname

Dit is de naam van je server zoals spelers die zien in de serverlijst. Maak het herkenbaar en aantrekkelijk.

sv_hostname "Mijn Awesome FiveM Server | NL/BE | Roleplay"

sv_maxclients

Het maximale aantal spelers dat tegelijk op je server kan spelen. Dit is afhankelijk van je serverplan bij HytaleNode. Stel dit niet hoger in dan wat je plan aankan, anders kunnen er prestatieproblemen ontstaan.

sv_maxclients 48

sv_licenseKey

Je FiveM-serverlicentie. Deze heb je nodig om je server te laten draaien. Je kunt een gratis licentie aanmaken op keymaster.fivem.net. Zonder geldige licentie start je server niet op.

sv_licenseKey "jouw_licentie_key_hier"

Let op: houd je licentiesleutel geheim. Deel deze nooit met anderen.

locale en gametype

Met locale geef je de taal van je server aan. Voor een Nederlandse server gebruik je nl-NL. Met gametype en mapname geef je extra informatie over je server in de serverlijst.

sets locale "nl-NL"
sets sv_projectName "Mijn RP Server"
sets sv_projectDesc "De beste Nederlandse roleplay server"
gametype "Roleplay"
mapname "Los Santos"

OneSync instellen

OneSync is een technologie van FiveM die het mogelijk maakt om meer dan 32 spelers op je server te hebben en zorgt voor betere synchronisatie tussen spelers. Het is essentieel voor elke serieuze server. Je schakelt het in met de volgende regel in je server.cfg:

set onesync on

OneSync is tegenwoordig standaard beschikbaar voor alle FiveM-servers. Er zijn verschillende modi:

on – OneSync ingeschakeld (aanbevolen). Staat ook bekend als "OneSync Infinity" en ondersteunt tot 2048 spelers theoretisch.
off – OneSync uitgeschakeld. Maximaal 32 spelers. Dit wil je eigenlijk nooit.
legacy – Oude versie van OneSync. Alleen gebruiken als specifieke resources niet compatibel zijn met de nieuwste versie.

Tip: gebruik altijd set onesync on tenzij je een specifieke reden hebt om dat niet te doen. Vrijwel alle moderne resources zijn compatibel met OneSync.

ACE Permissions basics

ACE (Access Control Entry) permissies bepalen wie wat mag doen op je server. Dit is het systeem waarmee je admins, moderators en andere rollen instelt. De basis werkt als volgt:

# Een admin groep aanmaken en rechten geven
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Een principal (speler) toevoegen aan de admin groep
add_principal identifier.steam:xxxxxxxxxxxxxxx group.admin
add_principal identifier.discord:123456789012345 group.admin

# Moderator groep met beperkte rechten
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow
add_principal identifier.steam:yyyyyyyyyyyyyyy group.moderator

Uitleg van de onderdelen:

add_ace – Voegt een permissie toe aan een groep of persoon.
add_principal – Voegt een speler toe aan een groep op basis van hun identifier (Steam ID, Discord ID, of FiveM license).
group.admin – De naam van de groep. Je kunt zelf groepsnamen bedenken.
command allow – Geeft toegang tot alle commando's. Je kunt dit ook specifieker maken, zoals command.kick voor alleen het kick-commando.

Tip: voeg je eigen Steam- of Discord-identifier toe aan de admin-groep zodat je volledige controle hebt over je server. Je vindt je identifier door in de FXServer-console te kijken wanneer je verbinding maakt.

Voorbeeld van een complete server.cfg

Hieronder een voorbeeld van hoe een basis server.cfg eruit kan zien:

sv_hostname "Mijn RP Server | NL/BE | HytaleNode"
sv_maxclients 64
sv_licenseKey "jouw_key_hier"
set onesync on

sets locale "nl-NL"
sets sv_projectName "Mijn RP Server"
sets sv_projectDesc "Nederlandse Roleplay Community"
gametype "Roleplay"
mapname "Los Santos"
tags "roleplay, dutch, economy, cars, custom"

# Admin permissies
add_ace group.admin command allow
add_principal identifier.discord:123456789012345 group.admin

# Resources starten
ensure mapmanager
ensure chat
ensure hardcap
ensure baseevents

Na het aanpassen van je server.cfg, herstart je de server via txAdmin of het paneel om de wijzigingen te laden.