Ga naar hoofdinhoud

server.cfg

Beschrijving

  • server.cfg is een serverconfiguratiebestand waarmee je allerlei instellingen van je SA-MP-server kunt wijzigen.
  • Dit bestand is noodzakelijk voor elke server en moet zich in de servermap bevinden naast de serverapplicatie (samp-server.exe).

Console

KeyTypeDefault valueRead-onlyRuleEffect
echostringExecuting Server Config...JaNeeWat samp-server.exe in de serverconsole print bij het uitvoeren van server.cfg. Er is geen reden dit te wijzigen, omdat alleen jij de console ziet.
rcon_passwordstringchangemeNeeNeeHet wachtwoord voor serverbeheer en gebruik van de remote console (rcon). Verander dit naar iets sterks, zodat anderen geen controle kunnen nemen. Je server start NIET als changeme het RCON-wachtwoord is!
rconbool1NeeNeeSchakelt de functie Remote Console in. Zet op 1 om in te schakelen of 0 om uit te schakelen.

Scripts

KeyTypeDefault valueRead-onlyRuleEffect
gamemode(n) (N) (t)stringgamemode0 grandlarc 1NeeNeeHet .amx-bestand in de map gamemodes dat de server als gamemode moet gebruiken. (n) is het gamemodenummer, (N) is de gamemodenaam zonder de .amx-extensie, en (t) is hoe vaak de gamemode moet draaien voordat naar de volgende wordt gewisseld.
filterscripts (N)stringJaNeeHet .amx-bestand in de map filterscripts dat de server als filterscript moet gebruiken. (N) is de filterscriptnaam zonder de .amx-extensie. Filterscripts draaien op de achtergrond van je gamemode en voegen extra’s toe zonder de gamemode te wijzigen. Meerdere filterscripts laad je door ze op één regel te zetten, gescheiden door spaties, bijv. filterscripts script1 script2.
plugins (N)stringJaNeeHet .dll- of .so-bestand in de map plugins dat de server als plugin moet gebruiken. Op Windows is (N) de pluginnaam zonder .dll-extensie; op Linux is de .so-extensie vereist! Plugins breiden gamemodes en filterscripts uit. Meerdere plugins laad je op één regel, gescheiden door spaties, bijv. plugins plugin1 plugin2.

Serverbrowser

KeyTypeDefault valueRead-onlyRuleEffect
announcebool1NeeNeeSchakelt aanmelding bij de SA-MP-masterlist in. Zet op 1 om in te schakelen of 0 om uit te schakelen.
querybool1NeeNeeSchakelt weergave van serverinformatie in de serverbrowser in. 1 om in te schakelen, 0 om uit te schakelen. Spelers kunnen nog steeds joinen, maar de serverbrowser toont geen informatie.
hostnamestringSA-MP ServerNeeNeeDe naam die in de serverbrowser en bij verbinding wordt getoond.
languagestringNeeNeeDe taal die in de serverbrowser verschijnt. Spelers kunnen hiermee servers filteren op taal.

LET OP: Deze servervar is toegevoegd in 0.3.7 en heeft geen effect in eerdere versies.
mapnamestringSan AndreasNeeJaDe mapnaam die in de serverbrowser verschijnt. Dit kan van alles zijn, bijv. "My Stunt Map".
gamemodetextstringUnknownNeeNeeDe modus die in de serverbrowser wordt getoond. SetGameModeText heeft hetzelfde effect en overschrijft de waarde in server.cfg. Voor verschillende gamemodes gebruik je die functie per gamemode.
weatherstring*10NeeJaHet globale weer dat de server gebruikt en dat in de serverbrowser wordt getoond. Deze instelling in server.cfg gebruiken crasht de server bij opstarten. Gebruik SetWeather om dit te wijzigen.
worldtimestring*12:00NeeJaDe globale tijd die de server gebruikt en die in de serverbrowser wordt getoond. Deze instelling in server.cfg heeft geen effect. Gebruik SetWorldTime om dit te wijzigen.
gravitystring*0.008NeeNeeDe globale zwaartekracht van de server. Deze instelling in server.cfg gebruiken crasht de server bij opstarten. Gebruik SetGravity om dit te wijzigen.
weburlstringwww.open.mpNeeJaDe website waar spelers meer informatie over de server kunnen vinden.
versionstringJaJaDe SA-MP-versie die de server gebruikt en toont in de serverbrowser. Deze instelling in server.cfg heeft geen effect.
maxplayersint50JaNeeHet maximum aantal spelers dat je server kan bevatten. Maximaal 1000, minimaal 1.
passwordstringNeeNeeHet wachtwoord om de server te vergrendelen. Alleen spelers die dit wachtwoord kennen, kunnen joinen.

[*] Sommige instellingen hebben een ander type dan je misschien verwacht.

Netwerk

KeyTypeDefault valueRead-onlyRuleEffect
sleepint5NeeNeeHet aantal milliseconden dat de hoofdthread (sa-mp en raknet) idle "slaapt" per sync-cyclus. Hoger verlaagt serverbelasting maar vermindert sync-kwaliteit; lager verhoogt belasting maar verbetert sync. Wijzig alleen bij hoge spelersaantallen en FPS-stabiliteitsproblemen.
lanmodebool0NeeNeeVerouderde variabele, heeft geen effect.
bindstringJaNeeHet IP-adres dat de server moet gebruiken. De server gebruikt dit adres in plaats van automatisch een vrij adres te kiezen. Het adres moet overeenkomen met een netwerkkaart op de server. Handig voor meerdere servers op dezelfde poort op dezelfde machine.
portint8192 (7777 wordt ook vaak gebruikt)JaNeeDe poort die de server moet gebruiken. Je moet Port Forward instellen zodat spelers buiten je LAN kunnen verbinden.
conncookiesint*1NeeNeeSchakelt het 0.3.7-connection-cookie-systeem in. 1 inschakelen, 0 uitschakelen.

LET OP: Toegevoegd in 0.3.7 R2; heeft geen effect in eerdere versies.
cookieloggingint*0NeeNeeLogt connection-cookies van nieuw verbindende spelers. 1 inschakelen, 0 uitschakelen.

LET OP: Toegevoegd in 0.3.7 R2; heeft geen effect in eerdere versies.
connseedtimeint300000NeeNeeTijd in milliseconden tussen updates van de cookie-seedwaarde.

LET OP: Toegevoegd in 0.3.7; heeft geen effect in eerdere versies.
minconnectiontimeint0NeeNeeTijd in milliseconden die de server wacht voordat een volgende inkomende verbinding wordt geaccepteerd. Gebruik alleen bij connection-flood-aanvallen.
messageslimitint500NeeNeeMaximaal aantal berichten dat een gebruiker per seconde kan verzenden.
messageholelimitint3000NeeNeeNetwerkniveau-instelling tegen DoS-aanvallen.
ackslimitint3000NeeNee
playertimeoutint10000NeeNeeTijd in milliseconden waarna een speler time-out krijgt bij het niet verzenden van data.
mtuint576JaNeeZie hier.

LET OP: Toegevoegd in 0.3.8; heeft geen effect in eerdere versies.

[*] Sommige instellingen hebben een ander type dan je misschien verwacht.

Logging

KeyTypeDefault valueRead-onlyRuleEffect
outputbool0NeeNeeDubbelt logberichten (bijv. print/printf of logprintf van plugins) naar de serverconsole. 1 = aan, 0 = uit. Alleen effect op Linux-servers.
timestampbool1NeeNeePrint een tijdstempel bij elk consolebericht. 1 = aan, 0 = uit.
logtimeformatstring[%H:%M:%S]JaNeeHet tijdstempelformaat, gebaseerd op strftime (C/C++). Voorbeelden:

[%H:%M:%S] Alleen tijd, standaard in eerdere SA-MP-servers.

[%d/%m/%Y %H:%M:%S] Datum als dd/mm/jjjj gevolgd door tijd uur:minuut:seconde.
logqueriesbool0NeeNeeLogt alle queries die door spelers naar de server worden gestuurd. Handig tijdens DDoS-aanvallen.
chatloggingint*1NeeNeeToont spelerchat in de serverconsole. Nuttig om loggroei te beperken of als je een andere chatlogoplossing gebruikt. 1 = aan, 0 = uit.
db_loggingint*0NeeNeeLogt sqlite db_*-fouten in de serverconsole.

LET OP: Toegevoegd in 0.3.7 R2; heeft geen effect in eerdere versies.
db_log_queriesint*0NeeNeeLogt alle sqlite db_query-aanroepen, inclusief de querystring.

LET OP: Toegevoegd in 0.3.7 R2; heeft geen effect in eerdere versies.

[*] Sommige instellingen hebben een ander type dan je misschien verwacht.

Client

KeyTypeDefault valueRead-onlyRuleEffect
onfoot_rate*int30JaNeeHet aantal milliseconden waarmee een client de server bijwerkt met nieuwe data wanneer de speler te voet is.
incar_rateint30JaNeeHet aantal milliseconden waarmee een client de server bijwerkt met nieuwe data wanneer de speler in een voertuig zit.
weapon_rateint30JaNeeHet aantal milliseconden waarmee een client de server bijwerkt met nieuwe data tijdens vuren van een wapen.
stream_distance*float200.0NeeNeeDe afstand op het X,Y-vlak waarop spelers server-entiteiten binnen streamen. Maximaal 400.0, minimaal 50.0. Hoger = grotere zichtafstand maar meer clientverwerking en mogelijk meer bandbreedte.
stream_rate*int1000NeeNeeTijd in milliseconden voordat het instreamen van server-entiteiten per speler opnieuw wordt getest. Maximaal 5000, minimaal 500. Lager = meer serververwerking omdat streamcondities vaker per speler moeten worden herberekend.

[*] Lagere waarden voor onfoot_rate, incar_rate en weapon_rate verbeteren de synchronisatie maar gebruiken meer bandbreedte.

NPC's

KeyTypeDefault valueRead-onlyRuleEffect
maxnpcint0NeeNeeHet maximale aantal NPC's dat je server kan bevatten. Dit verbruikt spelerslots.

Lagcompensatie

KeyTypeDefault valueRead-onlyRuleEffect
lagcompmodeint1JaNee0: Volledig uitschakelen.

1: Volledig inschakelen.

2: Alleen positiecompensatie (rotatie van spelers wordt niet gecompenseerd).
lagcompstringOnJaJaWaarschijnlijk automatisch ingesteld op On of Off afhankelijk van lagcompmode.

Zelfgemaakte modellen

InstellingTypeStandaardwaardeAlleen-lezenRegelEffect
useartworkbool0JaNeeSchakelt het gebruik van aangepaste modellen uit de map models in. 1 = aan, 0 = uit.

LET OP: Toegevoegd in 0.3.8; heeft geen effect in eerdere versies.
artworkstringNoJaJaWaarschijnlijk automatisch ingesteld op No of Yes afhankelijk van useartwork.

LET OP: Toegevoegd in 0.3.8; heeft geen effect in eerdere versies.
artpathstringmodelsJaNeeHet pad waar de aangepaste modellen staan.

LET OP: Toegevoegd in 0.3.8; heeft geen effect in eerdere versies.

Overig

InstellingTypeStandaardwaardeAlleen-lezenRegelEffect
myriadbool0NeeNeeOngebruikt. Waarschijnlijk ooit compatibiliteit met de oude GTA San Andreas-mod "Myriad Islands" (pre-2008).
nosignstringJaNeeOngebruikt.

Opmerkingen

  • Waarden gemarkeerd als "Read-only" (zoals getoond door /rcon varlist) kunnen niet tijdens runtime worden gewijzigd. Alle andere waarden kunnen (tijdelijk) worden gewijzigd via SendRconCommand.
  • Waarden gemarkeerd als "Rule" (zoals getoond door /rcon varlist) worden in de serverbrowser in de sectie Rules weergegeven.
  • Scripts hoeven niet in de mappen gamemodes of filterscripts te staan. De informatie in server.cfg is een pad en kan dus .. gebruiken.