Instalación

Antes de empezar#

Antes de instalar Claw Machine, asegúrate de que tu servidor cumple los requisitos mínimos. Solo se necesitan tres recursos; todo lo demás se detecta solo y simplemente se usa cuando está disponible.

El framework se detecta en este orden: es_extended, qb-core, qbx_core — y si no hay ninguno en marcha, el script se inicia en modo standalone. El inventario se detecta por separado: ox_inventory, qs-inventory, codem-inventory, core_inventory y qb-inventory, y si no, usa las funciones de ítems propias del framework.

Descargar Claw Machine#

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

Inicia sesión en CFX Portal 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:

clawmachine-assets/         -- streamed models: 4 cabinets, claws, gacha balls, plush toys
qs-clawmachine/
├── config/main.lua         -- everything a server is meant to change
├── custom/                 -- framework bridges and the reward hand-out (open)
├── client/custom/          -- notifications, text prompts, HUD, target (open)
├── server/custom/          -- server-side hooks (open)
├── items/                  -- ready-to-paste plush toy items per inventory
├── locales/                -- 41 translations
└── database/sql.sql        -- optional, the tables create themselves

Mantén los nombres de las carpetas tal cual. Los exports se llaman como exports['qs-clawmachine'], y qs-clawmachine declara clawmachine-assets como dependencia con ese nombre exacto.

Instalar el recurso#

Mueve ambas carpetas al directorio resources de tu servidor. Pueden estar en cualquier sitio, pero lo más fácil es tenerlas juntas:

resources/
└── [arcades]/
    ├── clawmachine-assets/
    └── qs-clawmachine/

Después abre tu server.cfg e inicia las dependencias antes del script, y los assets antes de qs-clawmachine:

ensure oxmysql
ensure ox_lib

# Framework
ensure es_extended    # or qb-core / qbx_core

# Inventory (only needed for item prizes)
ensure ox_inventory   # or qs-inventory, qb-inventory...

# Claw Machine — assets first
ensure clawmachine-assets
ensure qs-clawmachine

Si ambas carpetas están en la misma carpeta entre corchetes, ensure [arcades] ya las cubre. El orden de carga importa: el framework se detecta buscando recursos que ya estén iniciados, así que un framework iniciado después de Claw Machine no se ve, y el script pasa a modo standalone.

La base de datos#

No hay ningún archivo SQL que importar. Claw Machine crea sus tres tablas en el primer inicio y añade cualquier columna que falte en los siguientes, así que actualizar nunca requiere una migración manual.

database/sql.sql se incluye para servidores que prefieren importar a mano, pero nunca es necesario.

Añadir los ítems de premio#

Las cuatro bolas gacha dan dinero en efectivo y no necesitan nada instalado. Los ocho peluches dan un ítem, y ese ítem tiene que existir en tu inventario; si no, el jugador gana el peluche y no recibe nada.

Las definiciones listas para pegar están en la carpeta items/:

El nombre del ítem es el nombre de la imagen: copia peluche_01.png … peluche_08.png en la carpeta de imágenes de tu inventario. Reinicia el inventario (y es_extended / qb-core) después de añadirlas.

Dar acceso al creador#

Colocar, editar y borrar máquinas se hace en /clawcreator, que está protegido por un permiso ace. Añade esta línea a server.cfg:

add_ace group.admin command.clawcreator allow

El mismo permiso permite a un jugador liberar una máquina de su dueño (/clawclearowner), gestionar cualquier máquina con dueño desde su panel G y elegir ítems de recompensa de la lista del inventario en el creador. Tanto el nombre del comando como el permiso se pueden renombrar en Config.Creator.

Configurar el recurso#

Todo lo que un servidor debe cambiar está en un solo archivo, config/main.lua: el idioma, las máquinas, los premios, las recompensas, la propiedad y las probabilidades de ganar. Los valores que conviene revisar primero:

Config.Locale = 'en'              -- 41 languages, see Integrations
Config.UseTarget = false          -- true = ox_target instead of the [E] prompt

Config.Gameplay.maxCredits = 10   -- most drops bought at once
Config.Gameplay.carryChance = 0.60 -- the global difficulty dial

Config.Ownership.enabled = true   -- players may buy machines
Config.Ownership.commission = 0.20 -- cut of every play kept by the city

Config.Debug.enabled = false      -- turn the calibration commands off on a live server

La presentación y la física del conjunto (el audio de arcade, el trabajo de cámara, las animaciones, las velocidades de la garra y la geometría del agarre) están calibradas para las máquinas y props incluidos y no se exponen en la configuración. No falta nada: esos valores son fijos por diseño. La referencia completa está en Uso.

Verificar la instalación#

Reinicia tu servidor y lee la consola. Un inicio correcto se ve así:

[qs-clawmachine:INFO] Server framework loaded: esx
[qs-clawmachine:INFO] Started - framework: esx
[qs-clawmachine:INFO] Loaded 0 claw machine(s) from SQL.

Si el framework indica standalone en un servidor que tiene uno, se inició después de Claw Machine: corrige el orden en server.cfg. Después entra y completa el primer ciclo:

1. Coloca una máquina

   Ejecuta /clawcreator, pulsa +, ponle un nombre, elige una máquina, fija un precio y pulsa Select en Placement. Apunta la máquina fantasma donde la quieras, gírala con Z / X, ajusta la altura con la rueda del ratón y haz clic izquierdo para confirmar. Guarda la máquina.

2. Juega una partida

   Acércate a la máquina y pulsa E. Elige cuántos intentos quieres y pulsa Play. Mantén una tecla de flecha para fijar la profundidad, después el lateral, y pulsa SPACE para soltar la garra.

3. Gana un peluche

   Lleva un peluche hasta la rampa y busca en tu inventario peluche_0X. Si el peluche cae en la bandeja pero no llega nada, los ítems no están instalados: consulta Errores comunes.

Las máquinas colocadas con el creador se guardan en la base de datos y se cargan en cada inicio. Los cambios en config/main.lua requieren reiniciar el recurso.