Uso

Las dos ventanas#

Dealership Creator tiene dos interfaces, y conviene saber desde el principio cuál es cuál. Un administrador tiene ambas, con un chip en la cabecera de cada una que salta a la otra.

La ventana del creador se abre en su Overview: lo que tiene el servidor (explanadas, tiendas con dueño, el catálogo, coches sin precio, la recaudación de la semana, quién está conectado), lo que va mal (en filas que abren cada una la pantalla que lo arregla) y lo que está pasando ahora mismo: quién está en cada sala de exposición, quién está en una prueba de conducción, qué viajes de reposición están en camino.

Casi nada se configura en archivos. Cada precio, impuesto, permiso y función se edita en una de estas dos ventanas, en vivo, y cada guardado de ajustes se conserva como una versión a la que puedes volver.

Con qué empieza un servidor nuevo#

Ocho concesionarios, cada uno en su propia explanada con su propio vendedor y su propio blip. Cada vehículo lo vende exactamente uno de ellos, así que se ven como ocho tiendas y no como una lista partida en ocho.

Los ocho están gestionados por el servidor: las ventas van a la economía y los coches de diario nunca se agotan, mientras que los hiperdeportivos, las aeronaves y los yates grandes están contados, de uno a tres de cada uno. Cualquiera de ellos se puede mover, renombrar, reponer, entregar a un jugador o borrar como un concesionario que hayas creado tú.

El catálogo#

El catálogo es la lista de todos los vehículos que conoce el servidor: su nombre, fabricante, clase, datos de manejo y el precio al que se vende. Empieza con 528 vehículos vanilla, ya con precio: los precios suben según lo que rinde un coche dentro de su clase, así que un coche más rápido siempre cuesta más que uno más lento del mismo tipo. Los vehículos de emergencia, militares y de servicio, las variantes armadas, los remolques y los props se dejan fuera a propósito.

Un coche sin precio no se puede vender en ningún sitio; el chip No price muestra solo esos. Desactiva un vehículo para dejarlo fuera de todos los concesionarios.

Colocar un concesionario#

Creador → Dealerships → New dealership. La ventana se cierra y obtienes una cámara libre sobre el lugar donde estás, con un panel al lado. Nada de un concesionario se escribe nunca como coordenada.

La barra superior lleva la cámara a tu waypoint del mapa, de vuelta a ti o al mostrador. Cada punto ya colocado aparece en el mundo como un fantasma: haz clic en uno para editarlo.

Las cinco pestañas#

Los puntos#

Para cada punto pulsa Place, mueve la cámara para que el fantasma quede donde quieres, arrastra los controles y pulsa ENTER. Cada fila tiene además tres atajos que evitan mover la cámara: Click on map (el siguiente clic en el mundo lo fija), Current location (el suelo bajo la cámara) y My character (el suelo bajo ti).

Elige un chip de tipo de vehículo arriba en la pestaña y las mismas preguntas se abren por tipo, así que un concesionario puede mostrar barcos en el agua, aviones en una pista y coches en la sala de exposición, y entregar cada uno donde corresponde.

Qué hay en el mostrador#

Los peds, props, sprites de blip y marcadores se eligen de listas con búsqueda e imágenes, y aun así se puede escribir cualquier nombre para modelos addon.

El terreno#

El terreno es el contorno de la propiedad. Decide dónde puede poner el personal de la tienda muebles y coches de exposición, y el servidor rechaza todo lo que se coloque fuera. Un concesionario sin terreno no se puede amueblar, así que dibújalo ahora: Draw the grounds, haz clic en cada esquina y cierra la forma. Se dibuja como una valla ámbar mientras trabajas.

Ponle nombre y guarda. La cámara te devuelve a donde empezaste. Un concesionario también se puede copiar como JSON desde su tarjeta y pegar en otro servidor, lo que abre el creador con él, cerrado y listo para colocar.

Dar stock a un concesionario#

Un concesionario sin stock se niega a abrir, a propósito: no habría ningún coche al que apuntar la cámara. El stock se gestiona desde la ventana del jugador, porque llevar una tienda es trabajo de su dueño: F6 → My dealerships → el concesionario → Stock → Add a vehicle. Elige un coche, pon el precio (0 usa el del catálogo) y cuántos (∞ para ilimitados). Como administrador ves ahí todos los concesionarios.

La sala de exposición#

Lo que ve un jugador después de pulsar el mostrador. La pantalla pasa a un telón, se le coloca junto al coche de exposición en una copia privada del mundo (nunca aparece en ella el coche de nadie más) y la cámara entra con un plano que ya está en movimiento.

Arrastra la escena para orbitar la cámara y usa la rueda para hacer zoom. En aeronaves y barcos el cliente se sienta a los mandos en vez de quedarse de pie bajo un ala.

La finalización de compra#

Una tarjeta junto al coche: un botón por cada moneda en la que se vende el coche, Split donde se permite pagar con varias a la vez, el precio, lo descontado (descuento de trabajo, promoción), impuestos, lo que se cobrará de cada moneda y cuánto le falta a un saldo, al contado o a plazos cuando la financiación está activada, una casilla de matrícula cuando los compradores pueden elegir una, y un botón que indica el importe exacto que cobra. El cliente nunca envía un importe: el servidor pone precio a cada compra.

Al pulsarlo se registra el coche a nombre del comprador, se mueve el dinero y se reproduce la entrega: el coche se enciende en el punto de entrega, el comprador recoge las llaves en la puerta y se sube. Se puede saltar con BACKSPACE, ENTER o SPACE. Adónde va el coche es un ajuste: al punto de entrega con el comprador al volante, o directamente a su garaje.

Monedas y precios#

Tres preguntas, respondidas en tres lugares:

Cada moneda es de uno de tres tipos:

Una moneda custom se conecta en un archivo, server/custom/currency/custom.lua: tres funciones pequeñas (leer un saldo, quitar una cantidad, devolver una cantidad) y dos ejemplos completos comentados. Hasta que se rellene, esa moneda no aparece en ningún sitio: nadie puede comprar un coche con una moneda que el servidor no puede leer.

Cada fila de vehículo (en el catálogo y en el stock de una tienda) tiene una tira de iconos de monedas junto a su precio. Ábrela para decidir en qué monedas se vende el coche y cuánto cuesta en cada una. Una moneda de dinero cobra el precio de lista salvo que escribas uno propio; una moneda de otro tipo necesita su propia cifra. No hay tipo de cambio en ningún sitio: 3,000,000 dólares y 300 monedas VIP son dos decisiones distintas. La fila de stock de una tienda tiene prioridad sobre el catálogo en esa tienda.

Settings → Payments decide qué monedas están activadas, cuál está preseleccionada, los pagos divididos (cuántas monedas, la parte mínima), qué puede hacer cada moneda (dividirse, llevar impuestos, financiarse), un descuento por pagar todo en una sola moneda, una reserva por debajo de la cual no puede bajar un pago y descuentos por trabajo.

El dinero se cobra moneda a moneda, y si alguna falla, todo lo ya cobrado se devuelve antes de rechazar la compra. Primero se reserva el stock, después se registra el coche y por último se paga la caja de la tienda.

Concesionarios con dueño#

Un concesionario puede pertenecer a un jugador o a un trabajo. Creador → Dealerships → la tarjeta → Assign. Una tienda de un trabajo la gestionan todos los que tienen ese trabajo, con rangos asignados según sus grados; una de un jugador empieza solo con el dueño, que contrata a partir de ahí.

La caja es el dinero propio de la tienda. Cada venta ingresa una parte en ella (el Revenue cut, 85% por defecto) y el resto sale de la economía, que es lo que impide que una tienda sea una máquina de imprimir dinero. En frameworks con cuentas de empresa, la caja es esa cuenta.

Permisos y rangos#

Un rango en una tienda no dice nada de otra: un dependiente de una sala de exposición es un desconocido en la siguiente.

Las secciones de la tienda#

Suministro y viajes de reposición#

Una tienda pide del catálogo del servidor (cualquier modelo que venda el servidor) y paga por adelantado desde la caja un porcentaje del precio del coche. Settings → Restock runs → Enabled decide qué pasa después:

• Desactivado — los coches aparecen en el stock al instante.

• Activado — se crea un viaje de reposición, y alguien tiene que ir a buscarlos.

Un viaje es un trabajo para el equipo de la tienda. Cuando se une la primera persona, el envío aparece en el punto de recogida: un coche real por unidad, aparcados en fila en el puerto. Cada conductor se acerca, coge las llaves de un coche y lo lleva hasta la descarga de la tienda. Cada unidad es un trayecto, varias personas pueden trabajar en el mismo viaje y a cada una se le paga por las unidades que trajo. Un coche destrozado no cuenta como entrega, y los daños ajustan la recompensa.

Una desconexión termina un trayecto, no el viaje, y un reinicio del servidor conserva el pedido. El tiempo solo corre mientras alguien del equipo está conectado. Los puntos de recogida son una lista común del servidor con los tipos de vehículo que acepta cada uno y un peso, así que los barcos pueden llegar a un puerto deportivo.

El mostrador de ventas#

Un miembro del personal con Sell mira a un cliente y usa Attend this customer, que solo ven los empleados que están en el terreno de su tienda. El mostrador crea una oferta: el coche, un descuento limitado por rango, la pintura, una matrícula, si se ofrece crédito y una nota. El cliente ve una tarjeta con la cifra exacta en cada moneda y acepta en su propia pantalla. El vendedor ve cómo llega y puede retirarla, gana una comisión, y puede dar antes al cliente las llaves para una prueba de conducción.

Amueblar#

Sofás, bolardos, plantas, carteles, luces (y los coches de fuera), colocados por el propio personal de la tienda (con el permiso Settings) o por un administrador, siempre dentro del terreno del concesionario. Ábrelo desde la ventana del jugador → el concesionario → Overview → Furnish, o desde la tarjeta de un concesionario en el creador. Solo una persona puede amueblar una explanada a la vez.

La pantalla se organiza en tres zonas, con el centro libre para la explanada: la barra de abajo (páginas y una cuadrícula de piezas), que se recoge sola mientras trabajas; las teclas que funcionan en ese momento arriba; y las herramientas de colocación arriba a la derecha cada vez que tienes algo en las manos.

Las piezas se pagan desde la caja de la tienda y se revenden por la mitad (el ajuste Refund). Un administrador amuebla gratis y no cobra nada al vender. El catálogo de piezas es config/shared/furniture.lua.

Coches de exposición#

La tercera página de la barra. El personal toma un coche del propio stock de la tienda, lo maneja exactamente como un mueble y luego lo prepara (colores, ruedas, livery, puertas y ventanillas, suciedad, motor y luces, una plataforma giratoria), todo aplicado en vivo. Un coche de exposición no gasta stock: es el escaparate. Los jugadores que pasan ven una placa flotante con su nombre, precio e indicadores, y al pulsar el coche se abre la sala de exposición con él. Los coches de exposición son sólidos, están congelados y bloqueados: nadie puede empujarlos, subirse ni abrir sus puertas.

Funciones opcionales#

Cada una de estas es un interruptor en Settings → Dealerships, y la mayoría vienen desactivadas, porque cada una cambia lo que cuesta un coche o cómo se posee. La mayoría también se puede ajustar por concesionario en la pestaña Trading del creador: una explanada puede desactivar algo que el servidor tiene activado, nunca activar algo que tiene desactivado.

Imágenes y música#

La imagen de un vehículo se busca en este orden, y gana el primer resultado:

1. La imagen propia del concesionario para ese modelo.

2. La imagen común del servidor para ese modelo (creador → Images).

3. La URL base más el nombre del modelo: web/build/vehicles/adder.png por defecto.

4. La imagen de cada vehículo de serie de la propia documentación de FiveM, por eso un servidor nuevo ya muestra un coche en cada tarjeta.

5. El logotipo del fabricante.

El estudio fotográfico (creador → Images → Capture) fotografía cada vehículo que no tiene imagen. Primero encuadras un coche: arrastra y usa la rueda hasta que el plano quede bien; ese encuadre se reutiliza para cada modelo, escalado a su tamaño. Después recorre la cola en una plataforma abierta de LSIA, con el mundo cargado alrededor, el tráfico oculto y la hora y el clima fijos. Las imágenes van a Fivemanage, a cualquier dirección personalizada que responda a una subida con una URL (un webhook de Discord sirve) o a la carpeta propia de este servidor. Necesita screenshot-basic.

Sesenta logotipos de fabricantes vienen con el script; un fabricante sin logotipo recibe un monograma con sus iniciales.

La música viene de tres listas, en orden: la propia del concesionario (pestaña Branding), la del servidor (Settings) y las trece pistas incluidas en la carpeta music/: phonk, house y electrónica, con volumen igualado y créditos en music/CREDITS.md. Una pista es un nombre de archivo en music/, una dirección mp3/ogg o un enlace de YouTube. Los jugadores controlan su propio volumen, el modo aleatorio y el modo streamer, que solo reproduce pistas que un administrador marcó como libres de derechos.

Para música que tiene que sonar sí o sí, usa archivos. Un enlace de YouTube solo se reproduce si el dueño del vídeo permite insertarlo, y la mayoría de subidas de discográficas no lo permiten. El reproductor salta un vídeo rechazado y vuelve a tus archivos.

Los ajustes#

La banda Settings de la ventana del creador contiene todo el comportamiento, en seis páginas. Cada campo tiene una descripción, cada guardado se conserva como una versión a la que puedes volver, y un buscador encuentra un ajuste en las seis páginas. Nada necesita reinicio.

Estos valores están en tu base de datos, no en un archivo. defaults.lua solo aporta la primera versión en un servidor nuevo; editarlo después no cambia nada. Restore default en una página vuelve a poner lo que venía de serie.