Instalación

Antes de empezar#

Antes de instalar Crafting Creator, asegúrate de que tu servidor cumple los requisitos. Unos pocos recursos son obligatorios; el resto se detectan solos y simplemente activan una función.

Todo lo específico del framework o del inventario está detrás de un pequeño archivo puente abierto, y el recurso elige el correcto viendo lo que ya está en ejecución:

Usa solo un inventario. Integraciones tiene los detalles de cada capa y cómo adaptar un recurso renombrado.

Descargar Crafting Creator#

Después de comprar Crafting Creator, 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 Crafting Creator.

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

[sql]/
├── esx.sql             -- the database for ESX
└── qb.sql              -- the database for QBCore and Qbox
qs-crafting/
├── config/main.lua     -- what you may edit
├── custom/             -- framework bridges, notifications, HUD, progress (editable)
├── client/custom/      -- inventory and target bridges (editable)
├── server/custom/      -- inventory bridges and crafting hooks (editable)
├── server/webhooks.lua -- Discord logging
├── locales/            -- 41 languages
└── web/                -- the interface, ready to use

Mantén el nombre de la carpeta qs-crafting. El comprobador de actualizaciones y los mensajes de la consola identifican el recurso por ese nombre.

Instalar el recurso#

Mueve la carpeta qs-crafting al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:

resources/
└── [qs]/
    └── qs-crafting/

Después abre tu server.cfg y asegúrate de que todas las dependencias, y todo lo que debe detectar, se inician antes de Crafting Creator:

ensure oxmysql
ensure ox_lib
ensure MugShotBase64

# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core

# Inventory (one), target and optional extras
ensure qs-inventory
ensure ox_target
ensure qs-interface
ensure qs-textui
ensure qs-gangs

ensure qs-crafting

El orden de carga importa. La detección solo ve los recursos que ya están iniciados, así que un inventario o target que se inicia después de Crafting Creator no se encuentra.

La base de datos#

Importa el archivo SQL de tu framework con HeidiSQL, phpMyAdmin o cualquier cliente MySQL/MariaDB, en la misma base de datos que usa tu framework. Hazlo una vez, antes del primer inicio.

-- ESX
ALTER TABLE `users` ADD IF NOT EXISTS `crafting_skill` LONGTEXT NULL DEFAULT NULL;
ALTER TABLE `crafting_tables` ADD IF NOT EXISTS `jobs` LONGTEXT NULL DEFAULT NULL;
ALTER TABLE `crafting_tables` ADD IF NOT EXISTS `gangs` LONGTEXT NULL DEFAULT NULL;
ALTER TABLE `crafting_tables` ADD IF NOT EXISTS `showWeaponsTab` TINYINT(1) NOT NULL DEFAULT '1';

-- QBCore / Qbox: the same, with `players` instead of `users` on the first line
ALTER TABLE `players` ADD IF NOT EXISTS `crafting_skill` LONGTEXT NULL DEFAULT NULL;

Quién puede abrir el creador#

El creador es donde se crean, mueven y eliminan las mesas, así que está protegido por una comprobación de permisos. Pulsa F10 o escribe /crafting_creator en el juego; un jugador sin acceso recibe “You don’t have permission to do that.” Cualquiera de estas vías da acceso:

setgroup <server id> admin

add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.admin
add_ace group.admin command allow

Config.CreatorJobs = {
    'realestate',
    'police',
}

Configurar el recurso#

Las mesas y recetas se crean mejor en el creador, en directo. Los archivos son para las reglas que las rodean:

Los valores que conviene revisar primero:

Config.Locale         = 'en'      -- 41 languages, see locales/
Config.UseTarget      = false     -- true = ox_target / qb-target, false = 3D prompt + E
Config.MoneyType      = 'money'   -- what recipe prices are paid with: 'money' | 'bank' | 'black_money'
Config.OpenCreatorKey = 'F10'     -- opens the creator
Config.CreatorJobs    = {}        -- jobs that may open the creator without being admin
Config.CraftingProgression.Mode = 'queue'  -- 'queue' | 'proximity'
Config.Debug          = false     -- extra console output and test commands

Config.Debug viene como true para que el primer inicio se explique en la consola. Cámbialo a false antes de abrir a los jugadores: el modo debug imprime cada acción y registra comandos de prueba para desarrolladores.

Verificar la instalación#

Reinicia tu servidor y lee la consola. Deberías ver el framework que se cargó y el resultado de la comprobación de actualizaciones:

[INFO] Successfully loaded the framework.  esx
You are using the latest version of qs-crafting!

Una línea que dice CRAFTING ERROR indica qué está mal, normalmente un ítem de una receta que tu inventario no tiene. Errores comunes los enumera. Después entra en tu servidor y recorre el primer ciclo:

1. Visita una mesa inicial

   Se incluyen dos mesas en config/main.lua, en el centro de la ciudad, justo al norte de Legion Square. Acércate a la Attachment Crafting Bench y pulsa E: la cámara se mueve sobre la mesa y se abre la ventana de crafteo.

2. Craftea algo

   Date los ingredientes de una receta, elígela, define la cantidad y pulsa craftear. En el modo cola el ítem aparece en la cola; pulsa Pick Up cuando termine el temporizador y ganarás su XP.

3. Abre el creador

   Pulsa F10 para abrir la lista de mesas creadas en el juego. Desde ahí, Uso explica cómo construir tu propia mesa.

Las mesas creadas en el creador no necesitan reinicio: aparecen, cambian y desaparecen para todos los jugadores en el momento en que guardas.