Del plano
al primer bloque.

Empieza en dos minutos

1. Descarga e instala el plugin en el servidor.
2. Concede el permiso blockforma.use a tus constructores.
3. Dentro del juego, escribe /blockforma.
4. Elige 2D o 3D, figura, radio y relleno. La altura se calcula automáticamente.
5. Usa el catalejo para inspeccionar la preview. Abre de nuevo el menú y confirma la posición.
6. Coloca los bloques que marca la guía. Cuando la capa esté completa, avanzará automáticamente.

BlockForma es una guía visual personal: tú colocas cada bloque. No necesita un mod del cliente y no construye, rompe ni sustituye bloques por ti.

Instalación y compatibilidad

1. Detén el servidor.
2. Copia BlockForma-0.8.0.jar en su carpeta plugins/.
3. Arranca el servidor. Se creará plugins/BlockForma/config.yml.
4. Comprueba que la consola muestra BlockForma 0.8.0 activado y concede los permisos.

Plugin para servidores Java basados en Paper. Compilado con Java 21 y API base Paper 1.21. La versión 0.8.0 se ha comprobado en un servidor aislado Purpur 26.2. Esa prueba no certifica todas las versiones ni todos los forks: Paper/Pufferfish 1.21.1 forman parte del objetivo de compatibilidad, pero esta entrega no acredita una prueba específica en cada uno. Usa la versión de Java requerida por tu servidor. No es un plugin de Bedrock, Forge, Fabric, BungeeCord ni Velocity.

No requiere WorldEdit, ProtocolLib ni un mod tipo Litematica. LuckPerms es opcional: puedes usar tu gestor habitual de permisos.

Permisos y acceso

Los permisos principales son blockforma.use, blockforma.teleport y blockforma.admin. Los antiguos novacraft.blockforma.use, novacraft.blockforma.teleport y novacraft.blockforma.admin siguen como alias de sus equivalentes para conservar los accesos existentes. Utiliza los nombres nuevos para asignaciones nuevas. El teleport tiene permiso separado. Puedes conceder el constructor sin permitir viajes. El borrado y las figuras usan el permiso de acceso y se limitan a proyectos propios.

Ejemplos con LuckPerms

En la consola, sin barra inicial. Sustituye constructores por un grupo existente y Jugador por el nombre correspondiente.

lp group constructores permission set blockforma.use true
lp user Jugador permission set blockforma.use true
lp user Jugador permission check blockforma.use
lp group constructores permission set blockforma.teleport true

Para retirar la concesión directa al grupo:

lp group constructores permission unset blockforma.use

Otros grupos o el estado OP pueden seguir concediendo acceso. Sintaxis contrastada con la documentación oficial de LuckPerms.

El constructor gráfico

Abre /blockforma o /bfguide. Arriba eliges 2D/3D y abres Mis proyectos; debajo seleccionas la figura. Cada figura tiene un icono propio, un nombre editable y una explicación sencilla al pasar el ratón. La seleccionada aparece marcada. Las flechas permiten volver; la barrera cierra el menú. Los cuatro controles de medidas y relleno son radio, altura, restablecer altura automática y hueca/maciza.

• Radio y altura: clic izquierdo suma 1, derecho resta 1; con Shift cambia de 10 en 10.
• Reloj: recupera la altura automática. No aparece en figuras 2D.
• Relleno: alterna una superficie hueca cerrada o un volumen macizo.
• Catalejo: abre la preview nueva en tus pies.
• Crear guía aquí: guarda y activa una construcción en tu posición. Si hay una activa, pide un segundo clic y conserva la anterior en Mis proyectos.
• Fila inferior: capa anterior/siguiente, pausar/reanudar, avance automático, estado y primera capa pendiente.
• Cancelar guía: retira los marcadores y conserva el proyecto para continuar después.

No hay selector de material: puedes construir con materiales distintos. El tipo de bloque no tiene que coincidir con una referencia.

Figuras, medidas y altura automática

La base se define con un radio: el ancho y el largo máximos son 2 × radio + 1. El centro ocupa un bloque. Esta versión no tiene controles independientes de largo y ancho.

La pirámide automática retrocede un bloque hacia dentro por cada capa. Una altura manual mayor puede producir escalones de varios bloques. Las curvas conservan su perfil y no tienen escalones uniformes.

Modificar la altura activa el modo personalizado: ese valor prevalece aunque cambies el radio o la figura 3D. El reloj vuelve al modo automático. Todas las formas 3D aceptan altura personalizada; una esfera puede quedar estirada o achatada. Los proyectos ya guardados no cambian de tamaño por estas opciones. En el plugin, Polígono es un hexágono; en la web puedes elegir de 3 a 12 lados.

Vista previa sobre el terreno

Una preview nueva nace en el bloque que ocupan tus pies: X, Y y Z se redondean hacia abajo a la cuadrícula. No depende de hacia dónde mires. Una vez abierta queda anclada: caminar, volar o bajar no la arrastra.

Abre el constructor para desplazarla al norte, sur, este, oeste, arriba o abajo. Cada clic mueve un bloque; Shift mueve diez. Construir en esta posición confirma ese origen. Cancelar vista previa la cierra y deja disponible la guía anterior. Cambiar los parámetros cancela la preview para evitar confirmar una figura desfasada.

Los cubos azules representan la superficie exterior, incluso en formas macizas. Solo los ve su dueño. Por defecto se muestran hasta 4096 cubos próximos, en una zona de 32 bloques alrededor del jugador y solo en zonas del mundo cargadas. Los cubos aparecen progresivamente. Para inspeccionar un proyecto grande con este modo, recórrelo. La preview se limpia al salir, cambiar de mundo o apagar el servidor.

Ver una figura grande: preview ampliada

En el constructor, pulsa el ojo de ender de la esquina superior derecha. Alterna entre Vista previa: cercana y Vista previa: ampliada. Funciona también con una preview ya abierta y solo cambia tu vista. Pulsa otra vez para recuperar la cercana. Al salir del servidor vuelve al modo cercano.

Cuantos más bloques visibles, más trabajo para el servidor y tu ordenador. Puedes notar menos FPS y una aparición más lenta. La ampliada se genera poco a poco; no aparece entera de golpe. Si va mal, vuelve a cercana o cancela la vista previa.

Ejemplo: una pirámide de radio 75 y altura automática 76 tiene 45.002 cubos de superficie, por lo que cabe completa en la ampliada. Para verla entera deben estar cargadas las zonas que ocupa y ser suficiente la distancia de visión y seguimiento de entidades del servidor y del cliente. BlockForma no cambia esas opciones ni carga todo el terreno por abrir una preview. Si una figura supera 65.536 cubos, avisa y prioriza los más próximos.

Proyecto guardado: Mis proyectos → Ver en el terreno utiliza siempre su mundo y origen guardados. Sus controles de desplazamiento están bloqueados. Continuar mantiene la identidad, capa y progreso.

Cambiar textos e idioma

Desde 0.8.0, el plugin crea plugins/BlockForma/lang.yml al arrancar. Puedes editar los nombres de figuras, sus explicaciones, títulos, botones, textos al pasar el ratón, avisos, errores y barra de progreso. El idioma es común para todo el servidor; no se selecciona automáticamente por jugador. Descargar archivo de textos de ejemplo.

1. Haz una copia de lang.yml.
2. Ábrelo en un editor de texto y guárdalo en UTF-8 para conservar las tildes.
3. Cambia los valores entre comillas, conservando las claves de la izquierda y los espacios de sangrado.
4. Reinicia el servidor para aplicar los cambios. No hay comando de recarga.

Ejemplo: llamar «Bola» a la esfera

shapes:
  sphere: "Bola"
  sphere-description: "Figura redonda, como una pelota"
  dome: "Media esfera"
  dome-description: "Una bola cortada por la mitad"

Edita esas líneas dentro de la sección shapes existente; no añadas una segunda sección del mismo nombre. El menú muestra el nombre y una explicación sencilla. Por defecto, Esfera se explica como «Forma de bola» y Octaedro como «Dos pirámides unidas por la base».

Números y colores

Los textos pueden contener variables como {0}, {1} y {2}. El plugin las sustituye por radio, capa, coordenadas u otros valores. Puedes moverlas de sitio para traducir una frase, pero debes conservarlas. Los colores usan &a (verde), &b (azul claro), &c (rojo) y &e (amarillo).

builder:
  radio-0: "&eRadio: {0}"
  cerrar-menu: "&cCerrar menú"

Si falta una clave, su valor no es texto o se elimina una variable necesaria, se utiliza la frase española incluida. Si el YAML no puede leerse, el plugin avisa en consola y usa los textos originales sin sobrescribir tu archivo. Una actualización conserva tus cambios; las claves nuevas funcionan con su valor predeterminado hasta que las añadas.

El archivo no cambia los comandos, los permisos, los identificadores de las figuras, los nombres de materiales ni la geometría. Tampoco renombra proyectos ya guardados: usa el comando de nombre para eso. Los diagnósticos técnicos de consola pueden permanecer en su idioma original. El manual web explica los nombres predeterminados; no se traduce automáticamente al editar el archivo del servidor.

Construir por capas y guardar el avance

Los cubos verdes señalan las posiciones pendientes de la capa activa. Al colocar un bloque válido, desaparece su marcador. Tierra y bloque de césped cuentan igual; hierba como planta, helechos, flores y otra vegetación ligera siguen pendientes y conservan su marcador. Aire, agua y lava no completan la construcción.

Cuando se verifican todas las posiciones requeridas, el modo automático pasa a la capa siguiente. Puedes desactivarlo en el menú y cambiar de capa manualmente. La barra superior de progreso muestra capa, bloques y capas completadas; se oculta a los seis segundos sin cambios y reaparece al progresar o consultar /blockforma estado.

La comprobación se hace poco a poco y solo en las zonas del mundo que el servidor tiene cargadas: recorre toda la capa si el avance parece detenido. Se guarda cada cinco segundos cuando cambia el progreso, al desconectar y al apagar correctamente. Los proyectos guardan mundo, origen, forma, dimensiones, capa y marcas de avance. Solo puede haber una guía activa por jugador.

Al reanudar se verifica de nuevo la capa activa. Roturas, colocaciones, explosiones y pistones invalidan las marcas afectadas. Una edición externa que no emita eventos puede requerir volver a esa capa para verificarla.

Biblioteca de proyectos

Abre el cofre Mis proyectos o /blockforma proyectos. La biblioteca muestra hasta 36 proyectos por página con nombre, estado, capas completadas, mundo y origen.

• Clic izquierdo: abre Ver en el terreno, Continuar construcción, Ir a la construcción y Eliminar.
• Clic derecho: abre directamente la confirmación de borrado.
• Confirmación: verde elimina el proyecto guardado; rojo cancela. Nunca se borran bloques reales.
• Nombre: /blockforma nombre Mi pirámide cambia el nombre de la guía activa; máximo 48 caracteres.

Pausar mantiene la guía activa, pero oculta los marcadores y detiene la comprobación. Cancelar la deja guardada e inactiva; no reaparece hasta continuarla. Eliminar borra su registro y progreso. Crear otra figura conserva las anteriores.

Para ver o continuar un proyecto debes estar en su mundo. El teleport permite llegar a otro mundo que esté cargado en ese mismo servidor. Los mundos descargados no eliminan tus proyectos.

Teleport al centro o junto al proyecto

Mis proyectos → abre un proyecto → Ir a la construcción, la perla de ender. Funciona antes de colocar el primer bloque y cuando la obra ya está empezada. Nunca utiliza tu posición actual para cambiar el origen guardado.

1. Carga las zonas de destino en segundo plano.
2. Busca en la columna central suelo de bloque completo y dos bloques de aire para el jugador.
3. Si el destino central está a más de tres bloques verticales del origen, prioriza ocho columnas exteriores al perímetro, a radio + 2: cuatro laterales y cuatro diagonales.
4. Entre esos puntos exteriores elige la altura segura más próxima al origen. Así una pirámide maciza alta permite llegar junto a su base.
5. Si no hay alternativa exterior, puede usar el centro seguro. Si ninguno de los puntos comprobados sirve, informa del problema sin teletransportar dentro de bloques.

Comprueba los límites del mundo y su frontera. Mantiene la orientación y respeta la cancelación del evento de teleport por otros plugins. No hay comando independiente: usa la perla del menú. Requiere blockforma.teleport además de blockforma.use. Sin ese permiso, el menú indica Teleport no disponible. No activa automáticamente la guía ni cambia su avance. La búsqueda está limitada a esas nueve columnas; no explora todo el terreno.

Referencia completa de comandos

Todos los comandos de BlockForma se usan dentro del juego y requieren blockforma.use. Los corchetes indican argumentos opcionales: no los escribas.

Crear directamente

/blockforma crear piramide 10
/blockforma crear piramide 10 maciza stone 30
/blockforma crear esfera 12 hueca
/blockforma capa 5

El segundo ejemplo utiliza altura personalizada 30. El argumento material se conserva por compatibilidad con comandos antiguos y debe ser un material de bloque válido; no obliga al jugador a construir con él. Para especificar altura por comando debes incluir los argumentos anteriores. Solo maciza activa el relleno completo; usa hueca para la superficie.

Formas: esfera/sphere, cupula/dome, cilindro/cylinder, cono/cone, cubo/cube, piramide/pyramid, octaedro/rombo3d/octahedron, icosaedro/icosahedron, circulo/circle, cuadrado/square, rombo/diamond, triangulo/triangle y poligono/polygon. También se aceptan las grafías españolas con tilde. Cambiar los nombres visibles en lang.yml no crea nuevos alias de comandos.

No hay comandos reload, tp, importación ni exportación de proyectos del plugin. El borrado definitivo y el teleport están en el menú.

Configuración del servidor

Archivo: plugins/BlockForma/config.yml. Detén el servidor antes de editarlo y vuelve a arrancarlo para aplicar los cambios. El mismo archivo contiene los proyectos: no lo sustituyas entero para cambiar un límite.

guide:
  visible-radius: 32
  max-markers-per-player: 500
  marker-material: LIME_STAINED_GLASS
  completed-marker-material: LIGHT_BLUE_STAINED_GLASS
limits:
  max-radius: 512
  max-height: 1025

• visible-radius: alcance horizontal de los marcadores de la capa activa, en bloques.
• max-markers-per-player: máximo de marcadores de guía visibles por jugador. No limita el tamaño guardado.
• marker-material: material de bloque utilizado para el marcador pendiente.
• completed-marker-material: opción heredada sin efecto en 0.8.0. Las posiciones completadas dejan de mostrar marcador.
• max-radius y max-height: límites administrativos de creación. Además se comprueba que toda la figura quepa entre las alturas mínima y máxima del mundo.

Usa enteros positivos y un material de bloque válido. Aumentar el límite de altura no cambia el techo del mundo. La preview tiene dos modos por jugador: cercana (32 bloques, 4096 cubos) y ampliada (superficie completa, máximo 65.536 cubos). Estas opciones de guía no modifican esos límites. No existe recarga de configuración mediante comando.

Constructor web y PDF

El constructor web ofrece selección 2D/3D, radio de 1 a 4096, altura automática o manual y relleno. Las capas se recorren con botones, deslizador, mapa de capas o flechas del teclado. Puedes marcar cada capa como terminada, ir a la siguiente pendiente y reiniciar sus marcas con confirmación.

Arrastra la vista 3D para girarla y usa Restablecer vista para recuperar la posición inicial. En el plano puedes acercarte y desplazarte para seguir figuras grandes. Exportar plano genera un PDF por capas con identidad de NovaCraft, figura, número de capa y representación 3D.

El avance de la web se guarda en ese navegador, en ese dispositivo. La altura manual también se conserva al recargar. No hay cuenta ni sincronización entre navegadores, web y servidor; el PDF no importa un proyecto al plugin. Configura en el juego la figura que quieras seguir allí. Borrar los datos del sitio elimina las marcas locales.

Los límites de la web y del servidor son distintos. El radio máximo de la web no implica que el servidor permita esa medida. Los PDFs de construcciones grandes pueden tardar y consumir mucha memoria; mantén la página abierta hasta finalizar.

Construcciones bajo el agua

Los planos 3D huecos incluyen suelo, paredes y cierre superior calculados sobre bloques completos. Las pruebas comprueban que el agua no pueda alcanzar el interior pasando de una casilla a otra por sus caras. Las figuras 2D no forman un recinto cerrado.

El contador comprueba ocupación, no impermeabilidad del material que colocas. Una capa terminada no certifica que escaleras, bloques anegados u otros materiales elegidos sellen el agua. Para un recinto estanco sigue todo el plano con bloques completos que cierren el paso, sin huecos, y revisa el agua que ya existía dentro: construir una envolvente no vacía automáticamente su interior.

Actualizar, conservar y recuperar proyectos

1. Detén el servidor y guarda una copia de plugins/BlockForma/.
2. Sustituye únicamente la JAR anterior. No dejes dos versiones cargándose en plugins/.
3. Conserva config.yml, donde se guardan ajustes y proyectos.
4. Arranca y comprueba la versión en consola. Evita recargas en caliente.

Los registros están agrupados por UUID de jugador en projects; active-projects indica la guía activa. El formato antiguo de sesiones se migra con copia config-before-projects.yml. La carpeta antigua NovaCraftBlockforma se recupera si todavía no existe configuración nueva.

No hay sincronización entre tus dos servidores: cada instalación mantiene sus propios datos. Para recuperar una copia, detén el servidor antes de restaurarla y conserva los UUID de mundos y jugadores. Una copia hecha antes de construir no contendrá el avance posterior.

Preguntas y resolución de problemas

Versión y autores

BlockForma 0.8.0 · Creado por k4o0s y RaulRex00 para NovaCraft. Manual revisado el 20 de septiembre de 2026 contra el código de esta versión.

Incluye textos editables en lang.yml, preview cercana o ampliada por jugador, proyectos persistentes, altura automática, plantas pendientes y teleport con alternativa junto al perímetro. Las comprobaciones realizadas cubren geometría de cerramientos, conteo y avance, marcadores, guardado, menús y búsqueda de destino. No equivalen a una certificación en todas las versiones de Minecraft.