Antes de empezar#
Antes de instalar Yacht Creator, asegúrate de que tu servidor cumpla los requisitos mínimos. Unos pocos recursos son obligatorios; todo lo demás es opcional y se detecta por sí solo.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos para yates, llaves, muebles, códigos de la caja fuerte y transacciones de Tebex. |
| Obligatorio | Callbacks, zonas, menús contextuales, text UI y barras de progreso. |
| Obligatorio | Declarado como dependencia en el manifest: el recurso no se inicia sin él. |
Framework | Obligatorio | ESX, QBCore o Qbox — se detecta automáticamente. La propiedad, el dinero y los nombres de los personajes vienen de él. |
Sonido 3D | Recomendado |
|
Target | Opcional |
|
Inventario | Opcional | Necesario para el alijo del yate y los muebles de almacenamiento. |
Guardarropa | Opcional | Tu script de ropa se abre cuando un jugador usa el guardarropa del yate. |
| Opcional | Agrega la app Yacht: gestiona llaves, radio, mejoras, el timbre y un punto de ruta desde el teléfono. |
Todo lo específico de un framework o de terceros está detrás de un pequeño archivo puente sin cifrar, y el recurso elige el correcto según lo que ya está en ejecución:
Capa | Recursos detectados |
|---|---|
Framework | es_extended · qb-core · qbx_core |
Target | ox_target → qb-target |
Inventario | qs-inventory · ox_inventory · qb-inventory · ps-inventory · core_inventory · codem-inventory · origen_inventory · tgiann-inventory · inventory (Chezza) |
Guardarropa | qs-appearance · qb-clothing · illenium-appearance · fivem-appearance · codem-appearance · ak47_clothing · raid_clothes · rcore_clothes · rcore_clothing · origen_clothing · sleek-clothestore · tgiann-clothing · p_appearance |
Sonido | mx-surround → qs-3dsound → xsound |
Sincronización del clima | Renewed-Weathersync · qb-weathersync · cd_easytime · vSync · av_weather |
Cada integración opcional se desactiva sin hacer ruido: si falta un recurso, esa función simplemente se apaga. Integraciones tiene los detalles y cómo fijar una a mano.
github.comReleases · overextended/oxmysqlMySQL resource for FXServer.github.comReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.github.comcitizenfx/screenshot-basicFiveM/RedM screenshot resource.github.comReleases · Xogy/xsoundImproved audio library for FiveM.www.quasar-store.com3D Sound – Advanced 3D Audio System for FiveM | Quasar StoreAdvanced 3D audio system for FiveM with positional sound, car radio, CarPlay, boomboxes, and dynamic audio sources for immersive roleplay.
Descargar Yacht Creator#
Después de comprar Yacht Creator, el recurso se vincula automáticamente a tu cuenta del CFX Portal.
Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Yacht Creator.
Después de extraer la descarga, deberías tener la siguiente carpeta:
qs-yacht/
├── config/
│ ├── main.lua -- prices, shop, upgrades, vehicles, Tebex
│ └── furniture.lua -- the decoration catalogue
├── client/custom/ -- inventory, wardrobe, target, weather bridges (editable)
├── server/custom/ -- inventory and society bridges (editable)
├── custom/ -- framework bridges: esx/ and qb/ (editable)
├── database/ -- main.sql, esx.sql, qb.sql
├── locales/ -- 41 languages
└── web/ -- the interface and furniture imagesLa carpeta debe llamarse
qs-yacht. La ruta de la interfaz (nui://qs-yacht/web/), cada export (exports['qs-yacht']) y la app del teléfono buscan ese nombre exacto.
Instalar el recurso#
Mueve la carpeta qs-yacht al directorio resources de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
└── qs-yacht/Una vez copiada, abre tu server.cfg y asegúrate de que cada dependencia —y todo lo que deba detectar— se inicie antes que Yacht Creator:
ensure oxmysql
ensure ox_lib
ensure screenshot-basic
# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core
# Target, inventory, wardrobe, sound, phone
ensure ox_target
ensure qs-inventory
ensure qs-appearance
ensure xsound
ensure qs-smartphone-pro
ensure qs-yachtEl orden de carga importa. La detección solo ve los recursos que ya están iniciados, así que un inventario o guardarropa que se inicia después de Yacht Creator no se encuentra y esa función queda desactivada.
La base de datos#
La carpeta database/ contiene tres archivos. Ejecuta main.sql primero y luego el de tu framework, con HeidiSQL o cualquier cliente de MariaDB/MySQL:
Archivo | Qué hace |
|---|---|
| Todas las tablas de Yacht Creator. Igual en todos los frameworks. |
| Agrega |
| Agrega |
Qué contienen las tablas:
Tabla | Contiene |
|---|---|
| Cada yate con dueño: su espacio, dueño, nombre, modificaciones (modelo, pintura, luces, bandera, radio), mejoras y las posiciones del guardarropa y del alijo. |
| Quién tiene llave de qué yate. |
| Cada mueble: modelo, posición, rotación, si está guardado y la configuración de luces. |
| Los códigos que protegen el alijo del yate y los muebles de almacenamiento. |
| Compras de Tebex: qué transacción compró qué yate, qué IDs de transacción ya se usaron para siempre y el ID que un jugador canjeó en el juego. |
-- 1. database/main.sql (all tables)
-- 2. database/esx.sql
ALTER TABLE `users` ADD COLUMN IF NOT EXISTS `yacht_inside` VARCHAR(40) NULL DEFAULT NULL;
INSERT INTO `datastore` (name, label, shared) VALUES ('yacht', 'Yacht', 0);-- 1. database/main.sql (all tables)
-- 2. database/qb.sql
ALTER TABLE `players` ADD COLUMN IF NOT EXISTS `yacht_inside` VARCHAR(40) NULL DEFAULT NULL;
yacht_insiderecuerda si un jugador cerró sesión dentro del camarote o en el puente, así que despierta en el mismo lugar la próxima vez que entra. Sin la columna, los jugadores se reconectan en la cubierta abierta.
Configurar el recurso#
Todo se configura en dos archivos. Los cambios requieren reiniciar el recurso.
Archivo | Contenido |
|---|---|
| Idioma, detección, la tienda y su cámara, el precio base y el precio de cada modificación, el porcentaje de reventa, el límite de yates, las mejoras, los vehículos del yate, la radio, los límites de decoración, Tebex, las teclas y la depuración. |
| El catálogo de decoración: 37 categorías y más de 400 props con sus precios y variantes de color; más de cien de ellos también sirven como alijo o guardarropa. |
Los valores que conviene revisar primero:
Config.Locale = 'en' -- any file in locales/
Config.MoneyType = 'bank' -- account charged for yachts, upgrades and furniture
Config.MaxYachtsPerPlayer = 1
Config.ShopDefaultPrice = 5000000 -- base price; modifications are added on top
Config.YachtSellPercentage = 0.7 -- 70% of the total value back when selling to the bank
Config.UseTarget = true -- false = key prompts instead of ox_target / qb-target
Config.EnableKeyGiveFromUI = true -- let owners hand out keys from the menu
Config.DefaultYachtName = 'Quasar' -- shown when a yacht has no custom name
Config.Debug = true -- set to false on a live serverVerificar la instalación#
Después de completar la instalación, reinicia tu servidor y lee la consola. Deberías ver el framework elegido y la comprobación de versión:
[INFO] Successfully loaded the framework. esx
You are using the latest version of qs-yacht!Luego entra a tu servidor y recorre el primer ciclo:
Visita la Yacht Shop
El blip Yacht Shop está en la costa oeste. Acércate al vendedor y usa Open Shop (o pulsa
Esin target). La cámara vuela mar adentro sobre el primer espacio de yate libre.Configura y compra
Elige un modelo, pintura, iluminación, barandilla y bandera, ponle nombre al yate y pulsa Purchase Yacht. El yate aparece en el mapa con un blip para ti y para cualquiera a quien le des una llave.
Sube a bordo y abre el menú
Llega al yate y escribe
/yachtMenupara abrir Yacht Management. Desde ahí, Uso cubre las llaves, las mejoras, la decoración y la vida a bordo.