Documentación de OV Constructor

OV Constructor (ov_constructor)

Que hace

ov_constructor es el editor de mapas propio de Otra Vida. El staff entra con /constructor <proyecto> y trabaja con una camara libre: coloca piezas con un clic, las mueve y las gira, y al cerrar el editor lo guardado se publica en el mundo para todos los jugadores. Las piezas aparecen como objetos reales con colision.

Version 0.2.1, en pruebas.

Lo mas importante

• Camara libre con cursor: F alterna entre cursor y camara. Escape cierra el editor.
• Colocar con un clic: un rayo detecta suelo, techo y paredes y orienta la pieza.
• Mover y girar con el gizmo o con el teclado (flechas, RePag/AvPag, X/Z). Guardar y Cerrar confirman el movimiento pendiente.
• Lista de piezas (boton "Lista de piezas"): seleccionar, llevar la camara a la pieza y borrar desde la lista, con filtro por nombre.
• Borrar: pieza con Supr, boton "Limpiar todo" y marcado de objetos vainilla para borrar.
• Capas, rejilla y angulo para colocar con orden.
• Publicado en el mundo: las piezas guardadas aparecen como objetos reales con colision al cerrar el editor y se quitan al alejarte (150 m).
• Fotos de props: miniaturas en la paleta y en la lista de piezas.
• Indicadores en pantalla: rueda de "Guardando..." y avisos al guardar y al cargar el mundo.
• Diagnostico: /mundover muestra una esfera sobre cada objeto del mundo.

Requisitos

• OneSync.
• ox_lib.
• screenshot-basic, solo para las fotos de props.
• Permiso ov.constructor o grupos admin/god de qbcore.

Instalacion

1. Copia la carpeta ov_constructor a resources.
2. Anade ensure ov_constructor en tu server.cfg, despues de ox_lib y, si vas a usar las fotos, de screenshot-basic.
3. La carpeta datos/ del recurso debe poder escribirla el usuario con el que corre el servidor (si no, no se guardan los proyectos ni las fotos).
4. Da el permiso al staff (ver la seccion siguiente) y reinicia el servidor.

Permisos

Pueden usar el editor:

• Quien tenga el permiso ov.constructor.
• Los grupos admin y god de qbcore.

Como se usa (paso a paso)

1. Escribe /constructor <proyecto> con el nombre del proyecto en el que quieres trabajar.
2. Mueve la camara libre. Pulsa F para cambiar entre camara y cursor.
3. Elige una pieza y haz clic para colocarla. Se orienta sola segun detecte suelo, techo o pared.
4. Ajusta la pieza con el gizmo o con el teclado (flechas, RePag/AvPag, X/Z).
5. Usa la capa, la rejilla y el angulo si necesitas colocar con precision.
6. Abre "Lista de piezas" para seleccionar una pieza, llevar la camara hasta ella o borrarla. Puedes filtrar por nombre.
7. Para quitar una pieza, seleccionala y pulsa Supr. Con "Limpiar todo" borras todo el proyecto. Tambien puedes marcar objetos vainilla para borrar.
8. Pulsa Guardar o Cerrar: ambos confirman el movimiento pendiente. Al cerrar el editor, lo guardado se publica en el mundo.

Controles

Fotos de props

El boton "Fotos de props" lleva al jugador a un estudio abierto con luz de dia y fotografia cada modelo elegido con screenshot-basic. Puedes elegir entre:

• Propios OV.
• Piezas del proyecto.
• Solo los que no tienen foto.

La interfaz reduce la imagen y el servidor guarda la miniatura en datos/fotos.json. La paleta y la lista de piezas muestran esas miniaturas. Al terminar, el editor se vuelve a abrir.

Limites: maximo 60 modelos por tanda y 400 fotos guardadas.

Como se publica en el mundo

• Lo guardado se publica para todos los jugadores.
• Las piezas aparecen como objetos reales con colision al cerrar el editor.
• Se quitan al alejarte (150 m).
• Al guardar y al cargar el mundo ves avisos en pantalla. Mientras guarda, aparece una rueda de "Guardando...".
• /mundover muestra una esfera sobre cada objeto del mundo. Sirve como diagnostico.

Archivos y datos

• Proyectos: datos/proyectos/*.json.
• Miniaturas de las fotos de props: datos/fotos.json.
• Log del servidor: recibe reportes del cliente, como los FPS del editor y los errores.

Pruebas

Hay pruebas offline con lua5.4, que se ejecutan desde la carpeta del recurso:

• tests/test_matematica.lua
• tests/test_proyecto.lua
• tests/test_proyecto_2.lua
• tests/test_servidor.lua
• El banco de flujo: tests/flujo_editor.lua

El LEEME no indica cuantas pruebas hay ni sus resultados.

Limites y estado

Version 0.2.1, en pruebas. Es un editor para el staff, no para los jugadores.

Sin probar en el juego:

• Las fotos de props: el estudio, la camara y la captura.
• La aparicion de los objetos del mundo dentro de interiores MLO.
• La sensacion de la deteccion de superficies.

Limites conocidos:

• Maximo 60 modelos por tanda de fotos y 400 fotos guardadas.
• Las piezas del mundo se quitan al alejarte (150 m).
• Las fotos requieren screenshot-basic.