Uso

Las dos ventanas#

City Builder tiene dos interfaces, ambas para el staff. Conviene saber cuál es cuál desde el principio:

Ambas comprueban el mismo permiso: un administrador del framework o un trabajo en Config.CreatorJobs (consulta Instalación → Quién puede construir). Cualquier otro recibe "You don't have permission to do this".

Todo lo que se coloca con City Builder es global: pertenece al servidor, no al miembro del staff que lo colocó, y todos los jugadores lo ven. Cualquier constructor puede mover, guardar o vender cualquier objeto.

Modo decoración#

Escribe /citybuilder. Tu personaje se queda donde está, la cámara se eleva como una cámara libre, el HUD y el minimapa se ocultan, empieza la música de fondo y el panel de decoración se abre en la parte inferior de la pantalla.

El panel tiene dos pestañas en su borde izquierdo:

La cámara puede volar hasta Config.MaximumDistanceForDecorate metros (350 por defecto) desde donde está tu personaje. Si te alejas más, el constructor se cierra con "You are too far from the decoration area" — acerca tu personaje y vuelve a abrirlo. Pon el valor en false para quitar el límite.

Pulsa Esc o el botón de cerrar para salir. Un prop que estabas colocando pero no habías comprado se elimina; todo lo ya colocado se queda.

Colocar un prop#

1. Elígelo

   En la pestaña Objects elige una estancia, luego una categoría y luego un prop, o escribe en el buscador. Si el prop tiene variantes de color, elige una en la cabecera: cada variante es su propio modelo y puede tener su propio precio.

2. Colócalo

   El prop aparece cinco metros delante de la cámara, con un contorno azul. Muévelo con cualquiera de los dos editores (más abajo), pulsa G para apoyarlo en el suelo y vuela a su alrededor con la cámara libre para revisarlo desde todos los lados.

3. Cómpralo

   Pulsa Enter y confirma. Con el dinero activado, el precio se cobra del efectivo o del banco del constructor; con el dinero desactivado, el botón dice Place item y es gratis. El objeto se guarda y aparece para todos los jugadores al instante.

Los objetos colocados se cargan por streaming: cada jugador solo genera los que están a menos de Config.SpawnDistance (30 m por defecto). Una ciudad entera decorada no le cuesta nada a un jugador hasta que entra en ella.

Los dos editores#

Pulsa M para cambiar entre ellos en cualquier momento. El actual se anuncia en pantalla.

Controles#

Las teclas que se muestran en la barra de instrucciones abajo a la derecha siempre coinciden con el modo actual. Las velocidades de la cámara libre están en CameraOptions en config/config.lua.

Gestionar los objetos colocados#

Abre la pestaña Stash. Enumera todos los objetos del servidor; haz clic en uno (o, en modo gizmo, haz clic en el objeto en el mundo) y la cabecera se convierte en su panel de gestión:

Props interactivos#

Algunos props hacen algo cuando un jugador se pone al lado de uno (a menos de 1.5 m) y pulsa E. El comportamiento viene de la entrada del catálogo, así que todas las copias de ese prop se comportan igual.

Almacenes#

Los props con type = 'stash' (lavadoras, refrigeradores, armarios, cocinas compactas y más, de serie) muestran [E] - Open stash y abren un almacén en tu inventario. Cada copia colocada tiene su propio almacén, llamado citybuilder_<id>, con las ranuras y el peso definidos en el prop, o Config.DefaultStashData cuando el prop no define ninguno. Cualquiera puede abrirlo.

Guardarropas#

Los props con type = 'gardrobe' muestran [E] - Open gardrobe y abren el menú de conjuntos de tu script de ropa.

Luces#

Los props de la categoría Light proyectan un foco real en la dirección hacia la que miran: gira el prop para orientarlo. El haz ya se ve mientras lo colocas. El brillo viene de Config.DefaultLightIntensity.

Puertas dinámicas#

Los props marcados con isDoor = true se dejan sin congelar para que se abran y se cierren, cuando las puertas dinámicas están activadas (consulta Instalación → Puertas dinámicas).

Tus propias interacciones#

Cualquier prop puede mostrar [E] - Interact y disparar uno de tus eventos: una máquina recreativa que inicia un minijuego, una rocola que abre un menú de música. Consulta Comandos y exports → Eventos personalizados de props.

Dinero#

City Builder viene con el dinero desactivado: los precios se ocultan, colocar es gratis y vender no paga nada. Actívalo para que construir cueste algo; útil cuando construye un trabajo, no solo los administradores:

-- config/config.lua
Config.EnableMoney         = true
Config.MoneyType           = 'bank' -- 'money' (cash) or 'bank'
Config.SellObjectCommision = 0.3    -- selling pays back 30 % of the price

-- How prices are written in the interface (display only)
Config.Intl = {
    locales = 'en-US',
    options = { style = 'currency', currency = 'USD', minimumFractionDigits = 0 }
}

Si el constructor no puede pagar un prop, la compra se rechaza con "You don't have enough money!" y el prop se elimina.

El Furniture Creator#

Escribe /citybuilderfurniture (renómbralo con Config.FurniCreatorCommand). A la izquierda están las categorías del catálogo y los props añadidos en el juego hasta ahora; a la derecha, el formulario.

1. Elige una categoría

   El prop nuevo aparecerá en esa categoría en el modo decoración.

2. Completa lo básico

   Object name es el nombre de spawn del modelo, por ejemplo prop_couch_01 — se comprueba contra el juego, así que un error tipográfico o un prop que tu servidor no carga por streaming se rechaza. Añade etiqueta, descripción, precio y etiqueta de color.

3. Añade una imagen

   Pega una URL directa de imagen (un PNG cuadrado de 512 × 512 px o más es lo que mejor se ve), o toma una con el estudio fotográfico de abajo.

4. Define su comportamiento

   En Advanced, conviértelo en un Stash (con ranuras y peso máximo) o en un Wardrobe. El desplazamiento de posición mueve el aviso [E] respecto al prop; sube z para un armario alto.

5. Añade variantes de color (opcional)

   Cada variante es otro modelo que se muestra como una opción de color del mismo artículo, con su propia etiqueta, precio y comportamiento.

6. Crea

   El prop se guarda en la base de datos y se envía a todos los jugadores conectados al instante, sin reiniciar.

Los props añadidos en el juego se pueden editar o borrar desde la misma ventana. Los props escritos en config/furniture.lua no se pueden borrar aquí: quítalos del archivo. Un prop creado en el juego con el mismo nombre de objeto que un prop del catálogo en la misma categoría reemplaza esa entrada del catálogo tras el siguiente reinicio.

El estudio fotográfico#

Necesita screenshot-basic y un token de FiveManage (consulta Instalación → Configuración del sistema de fotos). Escribe primero el nombre del objeto y luego pulsa el botón de la cámara junto al campo de imagen.

Tu personaje se oculta y el prop aparece solo sobre un fondo degradado, mirando a la cámara:

Después de la subida vuelves al formulario con la URL de la imagen ya completada. En PC lentas, sube Config.FurniCreator.interval (milisegundos de espera antes de la captura) si las imágenes salen a medio cargar.

El catálogo de muebles#

El catálogo incluido está en config/furniture.lua: 38 categorías y más de 440 props, además de variantes de color. Edítalo para los cambios que el Furniture Creator no cubre: una categoría nueva, precios en bloque, puertas o eventos personalizados.

Estancias#

Config.FurnitureNavigation es la fila de estancias en la parte superior de la pestaña Objects. Una categoría apunta a una estancia por su número.

Una categoría y sus props#

Config.Furniture = {
    ['washingmachine'] = {                -- the category key
        label = 'Washing machine',
        img = Config.ImagePath .. 'decorate/categories/rooms/bathroom/bathroom-washingmachine-blue.svg',
        navigation = 2,                   -- room: 2 = Bathroom
        dynamic = true,
        css = { width = 4.5, top = 5.5, left = 2.5 }, -- position on the room illustration
        items = {
            [1] = {
                img = Config.ImagePath .. 'decorate/categories/rooms/bathroom/items/washing/prop_washer_02.png',
                object = 'prop_washer_02',  -- the model
                price = 400,
                label = 'Clear washing',
                description = 'A beautiful washing machine, at a good price and completely new.',
                colorlabel = 'White',
                colors = {                  -- optional variants
                    { label = 'Old', object = 'v_ret_fh_washmach', price = 310 },
                },
                type = 'stash',             -- 'stash' | 'gardrobe' | nil
                offset = { x = 0.0, y = 0.0, z = 0.0 }, -- where the [E] prompt sits
                stash = { maxweight = 50000, slots = 3 },
            },
        }
    },
}

Una categoría nueva también necesita su estancia navigation, un icono img y una posición css en la ilustración de esa estancia; copia una categoría existente de la misma estancia y ajústala. Reinicia el recurso después de editar el archivo.

Referencia de ajustes#