Robots

Máquinas que minan para su dueño, incluso mientras está desconectado. Es la capa de ingreso pasivo del servidor.

Los robots son entidades que se colocan dentro de las minas. Para minería virtual por tiempo, ver Autominers.

El ciclo

1. El jugador despliega un robot dentro de una mina con /robot place o desde un Robot Workshop.
2. Cada ciclo el robot llena su depósito interno con bloques sacados de la tabla ponderada de su tier.
3. Mientras trabaja consume combustible, que se compra con tokens.
4. /robot collect vacía el depósito al inventario, o lo vende directamente si el auto-sell está activo.
5. /robot upgrade lo pasa al siguiente tier por dinero y tokens.

Las ventas del robot pasan por el mismo sistema de venta que la minería manual, así que la producción de robots mueve el mercado dinámico igual que minar a mano.

Cuerpo del robot

Cada robot está en el mundo como un pequeño minero: la cabeza del dueño o la skin elegida con /robot skin, armadura teñida según el tier, un pico acorde al tier y un brazo que se mueve con partículas y sonidos de bloque.

• Click derecho sobre un robot abre su menú. Otros jugadores ven de quién es.
• Solo se animan si hay un jugador dentro de display.animation-range (32 bloques).
• Los cuerpos no se guardan en los chunks: aparecen mientras su chunk está cargado y se quitan al apagar, así un crash no deja duplicados.

Robot Workshop (NPC)

Un Robot Workshop es un aldeano. Al hacerle click derecho muestra los robots del jugador y despliega uno nuevo en un lugar libre alrededor del taller, mirando hacia su mina.

• Se coloca junto a cualquier mina pública con /robot station create [mina]. Sin id, usa la mina más cercana.
• Aparece automáticamente junto al spawn de cada mina privada (stations.in-private-mines).

Comandos

Aliases: /robots, /robotminer, /minero. Si tenés un solo robot, el id es opcional en todos los subcomandos.

Permisos y límite

Cada jugador puede tener un robot por defecto (default-limit: 1). Para vender más espacios, dale por ejemplo pulseprison.robots.limit.5 a un rango. Gana el nodo más alto y nunca baja el valor por defecto.

Si tu servidor ya tenía un robots.yml con el viejo default-limit: 3, al iniciar se cambia a 1 automáticamente. Si lo habías cambiado a otro número, se respeta.

Menú de gestión

/robot open <id> o click derecho sobre el robot:

Abrir el menú calcula antes la producción pendiente, así los números siempre están al día.

Tiers por defecto

Fórmula: blocks-per-cycle × (3600 / cycle-seconds).

default-tier: basic
default-limit: 1
max-offline-hours: 8
require-mine-region: true
display:
  enabled: true
  show-names: true
  animation-range: 32
  particles: true
stations:
  name: "&#b388ff⚙ Robot Workshop"
  in-private-mines: true
fuel:
  token-cost: 50
  units-per-purchase: 100

Producción offline

max-offline-hours limita cuánta producción se acumula sin el dueño: con 8, irse una semana paga igual solo ocho horas. En 0 se desactiva la producción offline. La producción también se corta cuando se acaba el combustible o se llena el depósito.

Interacción con otros módulos

• La mascota Bolt da ROBOT_OUTPUT y la estadística robot-output suma más, las dos suben los bloques por ciclo de todos los robots de su dueño.
• Las ventas con auto-sell aplican todos los multiplicadores: rango, prestigio, rebirth, árbol de habilidades, mascota y multiplicadores activos.
• Con require-mine-region: true los robots solo se pueden colocar dentro de minas.

Placeholders

API

RobotService robots = PulsePrisonProvider.get().robots();

robots.place(player, player.getLocation(), "basic");
int collected = robots.collect(player, "a3f1");
List<Robot> owned = robots.getRobotsOf(player.getUniqueId());

RobotProduceEvent se dispara cada vez que un robot acumula un ciclo. Ver Eventos.