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

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/                &lt;- Tus diseños JSON
├── plots.json          &lt;- Registro de todas las propiedades
└── config.json             &lt;- Configuraciones generales