Antes de empezar#
Antes de instalar Arcade Creator, asegúrate de que tu servidor cumple los requisitos mínimos. Solo los dos primeros son obligatorios; todo lo demás activa una función.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos. Los salones, las máquinas, las puntuaciones y los ajustes están en MySQL. |
| Obligatorio | Callbacks y funciones auxiliares compartidas. Debe iniciarse antes que el arcade. |
| Obligatorio | Viene en la misma descarga. Carga el interior de salón recreativo propio del juego; sin él nadie puede entrar. |
Framework | Opcional |
|
Inventario | Opcional | Solo para que un peluche de la máquina de garra también sea un ítem que el jugador conserva. |
Llaves de vehículos | Opcional | Entrega las llaves de un vehículo sacado del garaje del sótano. |
| Opcional | Solo para la cámara del creador, que fotografía un local para su panel de compra. |
Todo lo específico del framework o de terceros está detrás de un pequeño archivo puente, y el recurso elige cada uno mirando lo que ya está en marcha:
Capa | Lo que busca |
|---|---|
Framework |
|
Inventario |
|
Llaves de vehículos | Trece sistemas, incluidos |
Notificaciones |
|
Cada integración opcional se degrada en silencio. Si falta un recurso, esa función simplemente no aparece — nada da error y nada impide que el arcade funcione.
github.comReleases · overextended/oxmysqlMySQL resource for FXServer.github.comReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.Descargar Arcade Creator#
Después de comprar Arcade Creator, el recurso se vincula automáticamente a tu cuenta de CFX Portal. Inicia sesión con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga la última versión.
Después de extraer la descarga deberías tener dos carpetas:
[arcade]/
├── qs-arcades/ -- the script
│ ├── config/ -- what you may edit
│ ├── locales/ -- 41 translations
│ ├── custom/ -- bridges to your framework
│ └── sql/database.sql -- import this once
└── arcade_interior/ -- loads the game's arcade interiorLa carpeta debe llamarse
qs-arcades. Las tablas de la base de datos, los permisos ace y todos los comandos se construyen a partir de ese nombre; cambiarlo rompe los tres.
Instalar el recurso#
Mueve ambas carpetas al directorio de recursos de tu servidor. Pueden estar en cualquier lugar, juntas o separadas, siempre que ambas se inicien.
resources/
└── [arcade]/
├── qs-arcades/
└── arcade_interior/Abre tu server.cfg y asegúrate de que todas las dependencias se inicien antes que el arcade:
ensure oxmysql
ensure ox_lib
# Framework (only the one you run)
ensure qb-core
# ensure qbx_core
# ensure es_extended
# Optional
ensure ox_inventory
ensure screenshot-basic
# The arcade, last
ensure arcade_interior
ensure qs-arcadesEl orden de carga importa. La detección solo ve los recursos que ya están iniciados, así que un framework o un inventario que aparezca después de qs-arcades le resulta invisible y el servidor pasa a modo standalone.
La base de datos#
Importa sql/database.sql una vez, antes del primer inicio. Crea las tablas principales y carga los seis salones recreativos que el juego base ya tiene en el mapa.
mysql -u root -p your_database < sql/database.sqlSOURCE sql/database.sql;Tablas | Contienen |
|---|---|
| Los locales en sí — dónde están, cuánto cuestan — y quién es dueño de cada uno, con sus máquinas, mejoras y caja fuerte. |
| El personal y sus permisos, y quién estaba dentro cuando se detuvo el servidor. |
| Cada entrada de la clasificación, y los trofeos que ha ganado cada local. |
| El registro financiero detrás del panel del negocio. |
| El panel de ajustes del juego, la decoración, la emisora de la rocola y los estados de las puertas. Se crean solas en el primer inicio si faltan. |
La carga inicial usa
INSERT IGNORE, así que volver a importar el archivo nunca sobrescribe un local que editaste — pero sí restaura cualquiera de los seis salones integrados que hayas eliminado. Las columnas nuevas que añade una actualización se crean automáticamente al iniciar; no hace falta volver a importar para eso.
Obtener acceso de administrador#
El creador coloca locales y el panel de ajustes configura todo el servidor, así que ambos están protegidos por un permiso ace. Añade esto a server.cfg y reinicia:
# The in-game settings panel (/arcadeconfig)
add_ace group.admin command.arcadeconfig allow
# The venue creator (/arcadecreator)
add_ace group.admin command.arcadecreator allow
# Console-only tools
add_ace group.admin command.qsarcades allow
add_ace group.admin command.arcadepoints allowSi se le rechaza el acceso a alguien, la consola del servidor lo indica por su nombre e imprime la línea exacta que hay que añadir. Cualquiera puede abrir también ambos paneles cuando el interruptor correspondiente de Settings → Creator & camera está activado — útil en un servidor de pruebas, nunca en uno en producción.
Configurar el recurso#
Casi nada se configura en archivos. Los precios, los permisos, los ingresos, el garaje, las puertas, el idioma y los nombres de los comandos se editan en el juego con /arcadeconfig y se guardan en la base de datos, así que una actualización nunca los borra.
El único archivo que vale la pena abrir es config/config.lua, que contiene solo lo que hay que saber antes de que se inicie el servidor:
-- Extra console output. Leave it false on a live server.
Config.Debug = false
-- Each of these is detected automatically. Add your own resource
-- name on the left only if you renamed one of them.
Config.Framework = DependencyCheck(frameworks) or 'standalone'
Config.Vehiclekeys = DependencyCheck(vehicleKeys) or 'none'
Config.Inventory = DependencyCheck(inventories) or 'none'Todo lo demás dentro de
config/ylocales/es tuyo para editar y sobrevive a una actualización. Los archivos fuera de esas carpetas se sobrescriben, así que haz tus cambios en el panel de ajustes.
Verificar la instalación#
Reinicia tu servidor y lee las líneas de arranque en la consola. El recurso imprime lo que detectó y cuántos locales cargó:
[qs-arcades] client adapter loaded: qb
[qs-arcades] loaded 6 arcade points
[qs-arcades] achievements loaded: 0 rows
[qs-arcades] jukebox loaded: 6 arcadesLuego entra y recorre el primer ciclo:
Acércate a un salón recreativo
Los seis están en el mapa con un blip. Pulsa
Een la puerta: se abre un panel con fotos, el precio y un botón Buy. Si la puerta no hace nada,arcade_interiorno está iniciado.Cómpralo y entra
El local pasa a ser tuyo y la puerta se convierte en un aviso Enter. Dentro deberías ver la barra, la puerta de la oficina y los huecos de máquinas vacíos.
Compra y coloca una máquina
Siéntate en la laptop de la oficina, compra una máquina y luego abre el colocador con
/arcadeplace. Elige un hueco, confirma y juega.Abre los paneles
F7abre el panel del negocio,/arcadeconfiglos ajustes y/arcadecreatorel creador de locales. Si un panel se niega a abrirse, falta el ace.
A partir de aquí nada necesita un reinicio. Cada precio, permiso, opción de decoración y local nuevo se guarda en vivo y llega a todos los jugadores ya conectados.