Crear un tipo de mina privada

Un tipo de mina privada es una estructura que construís una vez en el servidor y que después se copia, por paquetes, para cada jugador. Esta guía va desde el mundo vacío hasta el tipo guardado.

Necesitás pulseprison.pmine.admin.

Las tres partes de un tipo

text

┌──────────────── ÁREA (hacha) ────────────────┐
│  toda la estructura: isla, paredes, decoración │
│                                                │
│   spawn ●     ┌───── ZONA (pala) ──────┐       │
│  (afuera de   │ ░░░░░░░░░░░░░░░░░░░░░░ │       │
│   la zona)    │ ░░░░  ┌────────┐  ░░░░ │       │
│               │ ░░░░  │ inicio │  ░░░░ │       │
│               │ ░░░░  └────────┘  ░░░░ │       │
│               │ ░░ bedrock = expansión │       │
│               └────────────────────────┘       │
└────────────────────────────────────────────────┘

Parte	Qué es	Herramienta
Área	Todo lo que ve el jugador alrededor de la mina: piso, paredes, bordes de bedrock, decoración, spawn	Hacha de oro
Zona	La mina a su tamaño máximo. Los bloques que construyas ahí se ignoran: la parte abierta se llena con las etapas del tipo y la cerrada se ve de bedrock	Pala de oro
Spawn	Donde aparecen los jugadores. Tiene que estar dentro del área y fuera de la zona	Comando
Expansión	Cuántos bloques por lado empiezan cerrados. Cada expansión comprada abre un bloque más por lado	Comando

La zona no va en las mismas esquinas que el área: va adentro, por ejemplo dentro del borde de bedrock.

Ejemplo: una zona de 33×33 con expansión 15 empieza en 3×3. Con 1 expansión pasa a 5×5, con 2 a 7×7, y con 15 llega a 33×33. Como crece un bloque por cada lado, el ancho sube de a 2.

Paso a paso

1. Empezar

/pmineadmin setup <id>

Te lleva al mundo de construcción (pulseprison_pmines_build). Para rehacer un tipo existente, /pmineadmin setup <id> overwrite: se conservan su nombre y sus etapas de bloques.

Construí la estructura en ese mundo, o pegala con WorldEdit.

2. Marcar el área

/pmineadmin setup area

Recibís el hacha:

Clic izquierdo en el bloque de una esquina de toda la estructura.
Clic derecho en el bloque de la esquina opuesta, arriba y del otro lado.
Shift + clic derecho confirma. El hacha desaparece y el mensaje dice el tamaño y cuántos chunks ocupa.

Sin hacha: parate en cada esquina y usá /pmineadmin setup area pos1 y area pos2.

3. Marcar la zona minable

/pmineadmin setup zone

Recibís la pala:

Clic izquierdo en el bloque de la esquina más baja de la zona.
Clic derecho en el bloque de la esquina opuesta más alta.
Shift + clic derecho confirma. La pala desaparece y el mensaje dice la expansión máxima posible.

Marcá la mina completa, al tamaño que tendrá con todas las expansiones.

Sin pala: parate en las esquinas y usá /pmineadmin setup min y max.

Mientras marcás, las partículas muestran el área y la zona.

4. Marcar el spawn

Parate donde deben aparecer los jugadores, mirando hacia la mina, y usá:

/pmineadmin setup spawn

Se guarda exactamente donde estás parado, con la dirección a la que mirás.

5. Elegir la expansión

/pmineadmin setup expansion 15

Es cuántos bloques por lado empiezan cerrados con bedrock. El mensaje muestra el tamaño inicial y el final. La mina tiene que empezar con un cuadrado abierto de al menos setup.minimum-start-size bloques por lado (3 por defecto), así que el máximo es el lado menos ese valor, dividido dos. Con 0, las minas empiezan con la zona completa y nunca crecen.

El bloque de la parte cerrada se cambia con setup.locked-block, y la mina inicial más chica con setup.minimum-start-size, los dos en pmines/config.yml.

6. Revisar y guardar

text

/pmineadmin setup finish
/pmineadmin setup finish confirm

finish muestra un resumen y avisa si falta algo. finish confirm lee la estructura en varios ticks, sin congelar el servidor, y guarda:

pmines/structures/<id>.ppmine: la estructura.
pmines/types/<id>.yml: spawn, zona, expansión y etapas.

Al guardarse se ejecutan las acciones de setup.finish-actions: por defecto [player] spawn, que te saca del mundo de construcción.

Un tipo nuevo empieza con una etapa de piedra. Editá block-types en su archivo y usá /pmineadmin reload. Ver Tipos, etapas y expansión.

/pmineadmin setup cancel abandona el setup y quita las herramientas.

Usar el tipo

Para que sea el tipo de los jugadores nuevos, poné su id en default-mine de pmines/config.yml.
Para una progresión de tipos, listalos en mine-order con upgrade-next-mine: true.
Para pasar a un jugador a este tipo: /pmineadmin settype <jugador> <id>.

Problemas comunes

Mensaje	Qué pasa	Solución
El área es más grande que el límite	Se marcó mucho más que la estructura	Marcá solo la estructura o subí `setup.max-area-*` en `pmines/config.yml`
La estructura mide X chunks, pero las minas existentes usan parcelas de Y	Ya hay minas creadas con parcelas más chicas	Hacé el área más angosta, o borrá las minas existentes con `/pmineadmin delete <jugador> confirm`
La caja minable mide solo 1×N	Min y max quedaron en el mismo bloque o en la misma línea	Marcá esquinas opuestas en diagonal
El spawn está dentro de la caja minable	Los jugadores caerían en la mina	Parate al lado de la mina, fuera de la zona
La expansión pasa el límite	Dejaría la mina más chica que el tamaño inicial mínimo	Usá el máximo que indica el mensaje
Se guardó pero está desactivado	El tipo no entra en las parcelas actuales	Mirá la consola: dice el tamaño permitido
El área solo contiene aire	No hay nada construido en el área	Construí la estructura antes de guardar

Límites del setup

yaml

# pmines/config.yml
setup:
  max-area-width: 400
  max-area-height: 384
  max-area-blocks: 30000000
  locked-block: BEDROCK
  minimum-start-size: 3
  finish-actions:
    - "[player] spawn"

Evitan que un área mal marcada congele el servidor al leerla.