Instalación

Antes de empezar#

Antes de instalar Apartments, asegúrate de que tu servidor cumple los requisitos mínimos. Cuatro cosas son obligatorias; todo lo demás es opcional y se detecta solo.

Cada recurso de terceros se conecta mediante un pequeño archivo puente sin cifrar, y Apartments elige el correcto mirando lo que ya está en ejecución:

Usa un recurso por capa. Si se inician dos inventarios o dos scripts de ropa, no está garantizado cuál elegirá Apartments. Integraciones explica qué hace cada capa y qué ocurre sin ella.

Descargar Apartments#

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

Tras extraer la descarga, deberías tener las siguientes carpetas:

[apartments]/
├── qs-apartments/
│   ├── config/               -- what you may edit
│   ├── client/custom/        -- bridges to other resources (editable)
│   ├── server/custom/        -- bridges to other resources (editable)
│   ├── locales/              -- 41 languages
│   ├── stream/               -- the photo booth used by the Furniture Creator
│   ├── web/                  -- the interface, already built
│   └── shell_offsets.json    -- the exit door of each interior
├── [maps]/
│   └── K4MB1-StarterShells/  -- the apartment interiors
└── [sql]/
    └── database.sql          -- the tables, imported once

Mantén el nombre de la carpeta qs-apartments. La interfaz carga sus imágenes desde nui://qs-apartments/web/, y Multicharacter y otros recursos llaman a sus exports por ese nombre.

Instalar el recurso#

Mueve las carpetas qs-apartments y K4MB1-StarterShells al directorio de recursos de tu servidor. Pueden estar en cualquier lugar dentro de él, incluida una carpeta de categoría:

resources/
└── [qs]/
    └── [apartments]/
        ├── qs-apartments/
        └── K4MB1-StarterShells/

Una vez copiadas, abre tu server.cfg y asegúrate de que cada dependencia — y todo lo que deba detectar — se inicie antes que Apartments:

# Lets placed doors swing open (Config.DynamicDoors)
setr game_enableDynamicDoorCreation "true"

ensure oxmysql
ensure ox_lib
ensure screenshot-basic

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

# Inventory, clothing, target, text UI
ensure ox_inventory
ensure illenium-appearance
ensure ox_target
ensure qs-textui

# The interiors, then Apartments
ensure K4MB1-StarterShells
ensure qs-apartments

# Spawn selectors look for Apartments, so they go after it
ensure qs-multicharacter

El orden de carga importa. La detección solo ve los recursos ya iniciados, así que un inventario o script de ropa que se inicia después de Apartments no se encuentra. A la inversa, Multicharacter solo ofrece apartamentos iniciales cuando Apartments ya está en ejecución.

La base de datos#

Apartments incluye su esquema como [sql]/database.sql. En un servidor nuevo, impórtalo una vez en la base de datos de tu servidor con HeidiSQL o cualquier cliente MySQL/MariaDB, antes del primer inicio.

player_apartments conserva las columnas que usaba qb-apartments — name, type, label, citizenid — y eso es lo que permite que los scripts escritos para qb-apartments sigan leyéndola. En ESX, citizenid contiene el identificador ESX del jugador.

Acceso de administrador#

Solo una parte de Apartments está protegida por una comprobación de administrador: el Furniture Creator (/apartmentfurniture) y el token de FiveManage con el que sube archivos. Todo lo demás es para los jugadores. Quién cuenta como administrador depende de tu framework:

setgroup <server id> admin

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

Configurar el recurso#

Todo se configura en archivos y se aplica cuando el recurso se reinicia. Cada valor de la config está marcado como [EDIT] (seguro de cambiar), [ADV], [CORE] o [AUTO] (no tocar).

Los valores que conviene revisar primero, en config/main.lua:

Config.Locale              = 'en'     -- any file in locales/
Config.UseTarget           = false    -- true with ox_target, qb-target or qtarget
Config.MoneyType           = 'money'  -- 'money' or 'bank': what furniture is paid from
Config.InitialSpawnEnabled = true     -- offer a starter apartment to new characters (qb-spawn)
Config.Cleaning            = true     -- junk appears while somebody is home
Config.FiveGuard           = false    -- your FiveGuard resource name, or false
Config.Debug               = false    -- ships as true: turn it off on a live server

Y tu token de FiveManage, en config/fivemanage.lua. El servidor solo se lo entrega a los administradores, pero mantén el archivo fuera de todo lo que compartas:

Config.FiveManageToken = 'your-fivemanage-token'

Config.Debug viene configurado en true. Déjalo así mientras configuras todo y luego cámbialo a false: debug imprime una línea para casi cada acción y registra el comando de prueba gizmo:apt.

Verificar la instalación#

Tras completar la instalación, reinicia tu servidor y lee la consola. Un inicio correcto muestra:

APARTMENTS INFO: Furniture Creator initialized: 0 custom items loaded

Un [ERROR] Framework not found! repetido significa que tu framework se inicia después de Apartments — mueve su línea ensure más arriba. Luego entra en tu servidor y recorre el primer ciclo:

1. Reclama un apartamento

   Escribe /Apartment y elige uno de los cinco edificios. Se te indica You have received an apartment, y todos los edificios aparecen en el mapa — el tuyo con su propio icono.

2. Entra

   Ve a la puerta de tu edificio, pulsa E y elige Enter Apartment. La pantalla se funde y apareces en la puerta de tu interior.

3. Hazlo tuyo

   Escribe /ApartmentLocation, elige Stash, colócate donde lo quieras y pulsa G. Luego pulsa F9 para abrir el menú de decoración. Uso cubre el resto.

Nada de lo que hacen los jugadores necesita un reinicio: los apartamentos, los puntos, los códigos de la caja fuerte y los muebles se guardan en el momento. Un cambio en un archivo de config/ necesita restart qs-apartments — hazlo sin nadie dentro de un apartamento.