Guia de configuració del servidor de Vintage Story
Aquesta guia cobreix com configurar el vostre servidor dedicat de Vintage Story allotjat amb Legion Hosting, incloent-hi el primer inici, les variables de GPanel, la gestió de versions, la configuració del servidor, els paràmetres del món, la connexió de jugadors i la gestió de partides desades. Per a la instal·lació de mods, consulteu Instal·lació de mods de Vintage Story. Per a la configuració d'administrador i les comandes, consulteu Comandes d'administrador de Vintage Story.
Primer inici
Quan inicieu el vostre servidor de Vintage Story per primera vegada des de GPanel, el servidor descarregarà automàticament els fitxers del joc des de l'API oficial de Vintage Story i generarà un món per defecte. Aquest primer inici pot trigar diversos minuts mentre es descarreguen i s'extreuen els fitxers.
- Inicieu sessió a GPanel i seleccioneu el vostre servidor de Vintage Story.
- Abans d'iniciar, reviseu la pestanya Startup per confirmar la branca de versió preferida (stable, unstable o pre-release).
- Feu clic a Start a la pestanya Console. Observeu la sortida de la consola per veure els missatges de progrés mentre el servidor descarrega i instal·la els fitxers del joc.
- Un cop veieu un missatge indicant que el servidor està escoltant connexions, el servidor està llest. Es generarà automàticament un fitxer
serverconfig.jsonper defecte.
Variables d'inici de GPanel
Els paràmetres principals del servidor es controlen a través de la pestanya Startup a GPanel. Reviseu-los i ajusteu-los abans d'iniciar el vostre servidor.
| Variable | Per defecte | Descripció |
|---|---|---|
SERVER_PORT |
(assignat) | El port del joc que utilitzen els jugadors per connectar-se. S'assigna automàticament per GPanel -- consulteu la pestanya Network per veure el vostre port assignat. |
MAX_CLIENTS |
16 |
Nombre màxim de jugadors simultanis. Es pot establir fins a 256. Ha de coincidir amb els recursos del vostre pla d'allotjament. |
FILES_BRANCH |
stable |
Quina branca de llançament utilitzar. Opcions: stable, unstable o pre. Consulteu la secció de Gestió de versions a continuació per a més detalls. |
RELEASE_VERSION |
latest |
La versió específica a instal·lar. Establiu-la a latest per utilitzar sempre la versió més nova de la branca escollida, o introduïu un número de versió específic (p. ex. 1.19.8) per fixar-la a aquesta versió. |
OPTIONS |
(buit) | Arguments addicionals de línia de comandes passats al procés del servidor en iniciar-se. Deixeu-ho buit tret que necessiteu paràmetres d'inici específics. |
SQLITE_TMPDIR |
(auto) | Directori temporal utilitzat per SQLite per a operacions de base de dades. Normalment no cal canviar-lo. |
Després d'actualitzar les variables d'inici, reinicieu el servidor des de GPanel perquè els canvis tinguin efecte.
Gestió de versions
Vintage Story ofereix tres branques de llançament. La vostra elecció de branca s'estableix mitjançant la variable d'inici FILES_BRANCH a GPanel.
| Branca | Valor | Descripció |
|---|---|---|
| Stable | stable |
La branca recomanada per a la majoria de servidors. Aquestes versions han estat provades exhaustivament i són les més fiables per a mons a llarg termini. |
| Unstable | unstable |
Versions beta amb noves funcionalitats i canvis que encara s'estan provant. Poden contenir errors. Utilitzeu-la si voleu accés anticipat a contingut nou i accepteu certa inestabilitat. |
| Pre-release | pre |
Versions de desenvolupament primerenc. Són les menys provades i poden tenir problemes significatius. Només recomanades per a proves -- no per a servidors de producció. |
Fixar una versió específica
Per defecte, RELEASE_VERSION està establert a latest, cosa que significa que el servidor descarregarà i instal·larà la versió més nova disponible a la branca escollida cada vegada que s'iniciï (si hi ha una versió més nova disponible). Per evitar actualitzacions automàtiques i bloquejar el servidor a una versió específica:
- Aneu a la pestanya Startup a GPanel.
- Canvieu
RELEASE_VERSIONdelatestal número de versió exacte que voleu (p. ex.1.19.8). - Reinicieu el servidor. Utilitzarà només la versió fixada independentment de les noves versions.
serverconfig.json
El fitxer de configuració principal del servidor és serverconfig.json, ubicat al directori arrel del servidor. Aquest fitxer es genera automàticament al primer inici. Atureu el servidor abans d'editar-lo i reinicieu-lo perquè els canvis tinguin efecte.
- Atureu el servidor des de la pestanya Console de GPanel.
- Obriu la pestanya Files i feu clic a
serverconfig.jsonper editar-lo. - Modifiqueu els paràmetres que necessiteu (consulteu la taula a continuació).
- Deseu el fitxer i inicieu el servidor.
Paràmetres clau
| Paràmetre | Valor d'exemple | Descripció |
|---|---|---|
ServerName |
"My Legion VS Server" |
El nom que es mostra al navegador de servidors del joc. Feu-lo descriptiu perquè els jugadors puguin trobar el vostre servidor. |
WelcomeMessage |
"Welcome to the server!" |
Missatge mostrat als jugadors quan s'uneixen. Admet format bàsic. |
MaxClients |
16 |
Nombre màxim de jugadors simultanis. Ha de coincidir amb la variable d'inici MAX_CLIENTS. |
Password |
"mysecretpass" |
Contrasenya requerida per unir-se al servidor. Deixeu-la com a cadena buida ("") per a un servidor públic. |
AllowPvP |
true |
Establiu-lo a true per habilitar el combat entre jugadors, o false per a un servidor només PvE. |
SpawnRadius |
50 |
Radi (en blocs) al voltant del punt d'aparició del món on els nous jugadors poden aparèixer. Un valor més gran distribueix més els jugadors en unir-se. |
MapSizeX |
1024000 |
Amplada del món en blocs. El valor per defecte crea un món molt gran. Reduir-lo limita fins on els jugadors poden viatjar d'est a oest. |
MapSizeZ |
1024000 |
Profunditat del món en blocs. El valor per defecte crea un món molt gran. Reduir-lo limita fins on els jugadors poden viatjar de nord a sud. |
WorldSeed |
"myseed123" |
Llavor utilitzada per a la generació del món. La mateixa llavor produeix el mateix món. Deixeu-la com a cadena buida per a una llavor aleatòria. |
Un exemple mínim dels paràmetres clau a serverconfig.json:
{
"ServerName": "My Legion VS Server",
"WelcomeMessage": "Welcome! Enjoy your stay.",
"MaxClients": 16,
"Password": "",
"AllowPvP": true,
"SpawnRadius": 50,
"MapSizeX": 1024000,
"MapSizeZ": 1024000,
"WorldSeed": ""
}
true/false) i que no hi hagi comes finals després de l'últim element d'un objecte o array. Si el servidor no s'inicia després d'editar, comproveu si hi ha errors de sintaxi JSON.
Configuració del món
Vintage Story genera el seu món basant-se en els paràmetres de serverconfig.json. La generació del món només es produeix al primer inici amb un món determinat -- canviar els paràmetres de generació després que el món s'hagi creat no alterarà retroactivament el terreny existent.
Paràmetres de generació del món
- WorldSeed: Determina la distribució del terreny, la ubicació dels biomes i la distribució de recursos. Establiu una llavor específica per compartir el mateix disseny del món amb altres, o deixeu-la buida per a un món generat aleatòriament.
- MapSizeX / MapSizeZ: Controlen l'àrea jugable màxima. Valors més petits creen un món més contingut i poden reduir l'ús de recursos. Els jugadors que arribin a la vora del mapa no podran viatjar més enllà en aquella direcció.
- WorldConfig: L'objecte
WorldConfigdins deserverconfig.jsonus permet ajustar amb precisió els paràmetres de generació del món com l'escala de les formes del terreny, els patrons climàtics i les característiques geològiques. Aquests són paràmetres avançats -- els valors per defecte funcionen bé per a la majoria de servidors.
WorldSeed, MapSizeX i MapSizeZ només tenen efecte quan el món es genera per primera vegada. Per aplicar nous paràmetres de generació, heu de crear un món nou (consulteu Gestió de partides desades a continuació).
Escollir una llavor
La llavor pot ser qualsevol cadena de text o número. Els jugadors de la comunitat de Vintage Story comparteixen llavors per a dissenys de mons interessants. Si voleu un tipus específic de terreny o ubicació d'aparició, cerqueu als fòrums de Vintage Story o als llocs de la comunitat per trobar llavors recomanades.
Com connectar-se
Els jugadors es connecten al vostre servidor de Vintage Story a través del menú multijugador del joc.
Connexió directa
- Inicieu Vintage Story i feu clic a Multiplayer des del menú principal.
- Feu clic a Direct Connect.
- Introduïu l'adreça IP i el port del joc del vostre servidor en el format:
Consulteu la pestanya Network a GPanel per veure la vostra IP i port assignats.your.server.ip:port - Feu clic a Connect. Si el servidor té contrasenya, introduïu-la quan se us demani.
Navegador de servidors
- Inicieu Vintage Story i feu clic a Multiplayer des del menú principal.
- El navegador de servidors carregarà una llista de servidors públics. Utilitzeu la barra de cerca per trobar el vostre servidor pel nom (el valor de
ServerNamedeserverconfig.json). - Feu clic al vostre servidor a la llista i feu clic a Join.
Gestió de partides desades
Les dades del món de Vintage Story s'emmagatzemen al vostre servidor i es desen automàticament durant el joc.
Ubicació de les dades del món
Els fitxers de partides desades es troben al directori data/ del vostre servidor. La ruta exacta depèn del nom del vostre món. Podeu accedir a aquests fitxers a través de la pestanya Files de GPanel o via SFTP.
Fer una còpia de seguretat del vostre món
- Atureu el servidor per garantir una còpia de seguretat neta (sense fitxers que s'estiguin escrivint durant el desament).
- Connecteu-vos al vostre servidor via SFTP. Consulteu Com pujar fitxers via SFTP per a instruccions de connexió.
- Descarregueu el directori
data/complet al vostre ordinador local. - Emmagatzemeu la còpia de seguretat en un lloc segur. Considereu mantenir múltiples còpies de seguretat amb data per si necessiteu tornar a un punt específic.
Reiniciar el món
Per començar un món completament nou:
- Atureu el servidor des de la pestanya Console de GPanel.
- Feu una còpia de seguretat de les dades del món existent si voleu conservar-les (vegeu més amunt).
- Navegueu al directori
data/al gestor de fitxers de GPanel i elimineu els fitxers de la partida desada. - Opcionalment, actualitzeu el
WorldSeedaserverconfig.jsonper generar un disseny de món diferent. - Inicieu el servidor. Es generarà un món nou des de zero utilitzant els vostres paràmetres de configuració actuals.
Articles relacionats
- Instal·lació de mods de Vintage Story
- Comandes d'administrador de Vintage Story
- Com trobar la IP i el port del vostre servidor
- Com pujar fitxers via SFTP
- Guia d'inici del servidor
Necessiteu ajuda?
Si trobeu un problema no cobert en aquesta guia, obriu un tiquet de suport i incloeu l'adreça IP del vostre servidor, una descripció del problema i qualsevol sortida de consola rellevant de GPanel.