Instalación

Antes de empezar#

Antes de instalar Downtown Mechanic, asegúrate de que tu servidor cumple los requisitos. No hay nada que instalar junto a él: el mapa trae sus propios modelos, sus propias colisiones y un pequeño script que cambia sus capas.

Para ejecutar el build que muestra todos los props, establécelo en server.cfg. Todos los jugadores descargan los archivos del juego de ese build la próxima vez que se conecten, así que planifícalo fuera de las horas punta:

sv_enforceGameBuild 3570

Descargar Downtown Mechanic#

Después de comprar Downtown Mechanic, el recurso se vincula automáticamente a tu cuenta de CFX Portal.

Inicia sesión en CFX Portal con la misma cuenta usada al finalizar la compra, abre Granted Assets y descarga Downtown Mechanic.

Después de extraer la descarga, deberías tener la siguiente carpeta:

qs_downtown_mechanic/
├── fxmanifest.lua
├── client.lua        -- loads and unloads the event layers on each player
├── server.lua        -- the /mechanicmap command and the saved layer
├── map_state.json    -- the layer that is active right now
└── stream/           -- the MLO, its props, collisions and distant models

Deja todo lo que hay en stream/ exactamente como viene. Los archivos del mapa se referencian entre sí por nombre, así que un archivo renombrado o eliminado aparece en el juego como un prop invisible, una pared que falta o un agujero en el suelo.

Instalar el recurso#

Mueve la carpeta qs_downtown_mechanic a la carpeta de recursos de tu servidor. Puede estar en cualquier lugar dentro de ella, incluida una carpeta de categoría:

resources/
└── [maps]/
    └── qs_downtown_mechanic/

Después abre tu server.cfg e inícialo:

ensure qs_downtown_mechanic

La posición en el archivo no importa — el mapa no depende de nada y nada depende de él. La única excepción es otro recurso que haga stream de los mismos archivos del edificio: el que se inicie el último gana, por eso debe eliminarse en lugar de reordenarse.

En la primera instalación, reinicia todo el servidor en lugar de iniciar el recurso en uno en funcionamiento. Los nuevos modelos en stream y las colisiones sustituidas se cargan limpiamente en una conexión nueva; los jugadores que estén cerca del edificio mientras cambia pueden ver geometría a medio cargar hasta que se reconecten.

Elegir la capa inicial#

No hay archivo de configuración. El único ajuste que tiene el mapa es qué capa se muestra, y está en map_state.json:

{
    "activeMap": 0
}

Comprueba el valor antes del primer inicio y establece el que quieres que encuentren tus jugadores. A partir de entonces lo cambias en el juego con /mechanicmap y el archivo se reescribe por ti — consulta Uso. Si falta el archivo, el primer inicio lo crea con 0.

Editar el archivo con el servidor en funcionamiento no hace nada. El valor se lee una vez, al iniciarse el recurso; después el servidor lo mantiene en memoria y sobrescribe el archivo la próxima vez que se usa el comando.

Conceder el comando#

/mechanicmap es un comando restringido: un jugador necesita el permiso ACE command.mechanicmap para usarlo desde el chat. La consola del servidor y la consola en vivo de txAdmin siempre pueden ejecutarlo.

add_ace group.admin command.mechanicmap allow

add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx command.mechanicmap allow

add_ace resource.my_events command.mechanicmap allow

Las líneas añadidas a server.cfg se aplican en el próximo reinicio; escritas en la consola del servidor, se aplican al instante.

Verificar la instalación#

Después de completar la instalación, reinicia tu servidor y lee la consola. El mapa anuncia la capa que restauró:

[MECHANIC MAP] State loaded: 0

Si faltaba map_state.json, lo indica y lo crea:

[MECHANIC MAP] File not found, creating default state.

Después entra en tu servidor y sigue este primer recorrido:

1. Visita el taller

   Ve a vector3(-74.6, -1332.2, 29.8), dentro del taller. Los tres elevadores, las puertas enrollables, la esquina de neumáticos y la oficina deberían estar ahí, con suelos y paredes sólidos.

2. Comprueba tu cliente

   Abre la consola F8. Medio segundo después de que el mapa se iniciara en tu lado, pidió la capa al servidor y mostró [MECHANIC MAP] Active map set to: 0 — o la capa que haya restaurado el servidor.

3. Cambia una capa

   Escribe /mechanicmap 2 en el chat. La carpa, la barbacoa, las mesas y la comida aparecen para todos a la vez. /mechanicmap 0 las vuelve a quitar.

No hace falta reiniciar nada a partir de aquí. La capa cambia en vivo, llega a todos los jugadores y sobrevive a los reinicios por sí sola.