Plots Plugin

Plots

Un sistema dinámico de gestión de terrenos basado en prefabs. Define cuadrículas, carga estructuras complejas y protege tu mundo con enmascaramiento inteligente.

Una forma sencilla pero poderosa de gestionar espacios creativos, permitiéndote centrarte en lo que realmente importa: construir.

Tabla de Contenidos

Introducción

Instalación

Generación Dinámica

Muestra

Configuración

Inicio Rápido

Comandos

El Sistema de Enmascaramiento

Permisos

Localización

Arquitectura de Datos

Instalación

Coloca el archivo .jar en tu carpeta de mods.

(Opcional) Añade tus archivos .prefab.json a plugins/Hytale_Plots/prefabs/.

Inicia el servidor para generar la configuración predeterminada.

Generación Dinámica

Plots no es solo una cuadrícula estática. Se adapta a tu diseño específico.

• Tamaño Adaptativo: La cuadrícula se ajusta automáticamente a cualquier ancho de carretera o parcela (ya sea de 4 o 150 bloques de ancho).
• Modo Islas (Enmascaramiento): Perfecto para mundos de islas flotantes. El sistema entiende la forma de tu construcción y evita expansiones que se desvíen del diseño original.
• Protección de Vacío: Impide que los jugadores se unan a islas separadas o construyan en el “vacío”, manteniendo la estética de tu mapa intacta.
• Soporte No Cuadrado: Soporte completo para ancho y profundidad independientes (por ejemplo, parcelas de 32×64).

Muestra

Aquí tienes un ejemplo de lo que puedes lograr utilizando un prefab personalizado para la parcela dentro de nuestro sistema dinámico. Estas islas flotantes se generaron automáticamente utilizando el sistema de cuadrículas y se protegieron con nuestra lógica de enmascaramiento granular.

Una estructura de parcela de isla personalizada generada a partir de un prefab e integrada perfectamente en la cuadrícula.

Vista desde arriba que muestra cómo se distribuye el prefab de la parcela por el mundo.

Configuración

El config.json permite un control total sobre tu mundo. A continuación, se presenta un desglose de los principales ajustes:

General & Mundo

• Idioma: El idioma utilizado para los mensajes (predeterminado: en_us).
• PlotWorldName: El nombre de la carpeta para tu mundo de parcelas dedicado.
• DefaultWorldTime: La hora de inicio del mundo (por ejemplo, midday, night).

Parcelas (Configuraciones de Cuadrícula)

• PlotSize: El área interna de construcción de cada parcela.
• RoadSize: El ancho de los caminos entre parcelas. Establecer en 0 para una cuadrícula sin huecos.
• MaxPlotsDefault: Cuántas parcelas puede reclamar un jugador por defecto.

Bloques (Lógica Base)

• Bedrock/Superficie/Relleno: Define los materiales base para la generación de tu mundo.
• Consejo Profesional: Establece estos en Empty o Air para crear un “Mundo de Vacío” técnico perfecto para islas flotantes.

Prefabs (El Núcleo)

• Road/Plot/Intersection: Vincula diseños de prefab específicos a la cuadrícula.
• Importante: Usa el nombre del archivo SIN la extensión .prefab.json (por ejemplo, usa my_island para my_island.prefab.json).

Inicio Rápido

• /plot claim – Toma posesión de la parcela en la que estás.
• /plot home – Te lleva de vuelta a tu construcción.
• /plot trust <player> – Da permiso a un amigo para construir contigo.
• /plot rename <name> – Dale a tu proyecto un nombre único.

Comandos

Jugadores

Comando	Descripción
/plot claim	Reclama la parcela actual
/plot auto	Encuentra y reclama la parcela libre más cercana
/plot home	Teletransporta a tu parcela principal
/plot trust <player>	Otorga permiso de construcción a otro jugador
/plot untrust <player>	Revoca el permiso de construcción de un jugador
/plot info	Muestra detalles sobre la parcela en la que te encuentras
/plot list	Lista todas tus parcelas poseídas

Administración

Comando	Descripción
/plot delete	Elimina un registro de parcela (solo administradores)
/plot reload	Recarga configuraciones y prefabs
/plot bypass	Habilita el modo de construcción libre para administradores

El Sistema de Enmascaramiento

Hemos creado una lógica de protección avanzada para servidores creativos:

• Respeto del Vacío: Si el espacio entre islas no es parte de tu prefab original, nadie puede construir allí. Esto mantiene el aspecto de “isla aislada”.
• Libertad Vertical: Si una columna ya contiene suelo de tu prefab, el jugador es libre de construir hacia arriba o hacia abajo, permitiendo sótanos o torres.
• Límite Inferior: La construcción por debajo del nivel 0 está automáticamente bloqueada para evitar desorden visual en la parte inferior del mapa.

Permisos

Plots utiliza un sistema de permisos granular. Puedes asignar estos nodos a jugadores o grupos:

Permisos Generales

Permiso	Descripción
plots.*	Acceso administrativo completo (parcelas ilimitadas, omitir protección)
plots.user	Permiso base para usuarios comunes
plots.claim	Permite reclamar parcelas con /plot claim o /plot auto
plots.delete	Permite eliminar parcelas poseídas con /plot delete
plots.delete.*	Permite eliminar cualquier parcela (Administrador)
plots.world	Permite visitar el mundo de parcelas dedicado con /plot world
plots.list	Permite listar parcelas poseídas con /plot list
plots.info	Permite ver información de la parcela con /plot info
plots.rename	Permite renombrar parcelas con /plot rename
plots.trust	Permite gestionar miembros de confianza con /plot trust

Permisos de Límite

Permiso	Descripción
plots.limit.X	Establece el número máximo de parcelas que un jugador puede poseer (por ejemplo, plots.limit.5)

Localización

Estamos comprometidos a apoyar tantos idiomas como sea posible.

• Ayúdanos a traducir: Visita nuestro Proyecto de Crowdin para contribuir.
• La personalización completa de mensajes está disponible en el directorio lang/ dentro de la carpeta del plugin.

Documentación Futura

Un sitio de documentación más completo y organizado está actualmente en desarrollo. ¡Mantente atento para tutoriales avanzados, referencias de API y consejos de diseño!

Arquitectura de Datos

Todo se guarda en formatos simples y ligeros:

plugins/Hytale_Plots/
├── prefabs/                <- Tus diseños JSON
├── plots.json          <- Registro de todas las propiedades
└── config.json             <- Configuraciones generales