Addonv1.0

xCrops Addon

Módulo de agricultura avanzada para xFoods con ciclos visuales, cuidados y plagas.


Introducción

xCrops añade un sistema de agricultura realista donde las plantas tienen ciclos de vida visuales usando ItemDisplays, requieren cuidados específicos y pueden infectarse con plagas.

Atención

xCrops requiere tanto xLib como xFoods Core instalados.

Instalación

  • Requiere xLib y xFoods, en ese orden.
  • Coloca xFoodsCrops.jar en /plugins/ y reinicia.
  • Se extraen las especies, maceteros, máquinas, el mercado y los idiomas por defecto. Nunca se sobrescribe lo que ya exista.

El idioma se elige igual que en xFoods, con 'language' en config.yml y los ficheros de lang/. Vienen incluidos inglés y español, y /xfcrops admin reload los recarga sin reiniciar.

Importante

El mercado necesita Vault Y un plugin de economía registrado (EssentialsX, CMI o similar). Vault por sí solo no basta: es solo la pasarela. Sin economía, /xfcrops market avisa y se cierra; el resto del plugin funciona igual.

Características

  • Fases visuales con ItemDisplays — el crecimiento se muestra bloque a bloque
  • Necesidad de agua, luz solar y fertilizantes
  • Fertilizantes químicos (crecimiento rápido) y orgánicos (mejor calidad)
  • Sistema de plagas: se curan con pesticida a mano o con el Fumigador Automático
  • Integración con las recetas de cocina de xFoods
  • La calidad del cultivo determina la cosecha: del 40% del rendimiento con calidad 0 al 100% con calidad 1

El ciclo de cultivo

  • Coloca un macetero. Sobre él aparece un holograma con su estado.
  • Click derecho con una semilla para plantar.
  • La planta avanza por fases. El holograma dice el progreso, la calidad y qué le falta.
  • Cuando pide algo (agua, abono, luz) hay que dárselo o la calidad baja.
  • En estado LISTO, click derecho para cosechar.

La calidad final multiplica la cosecha: va del 40% del rendimiento con calidad 0 al 100% con calidad 1. Es el incentivo para atender las plantas en vez de plantarlas y olvidarse.

Atención

Una planta con una necesidad sin atender durante más de wither-time segundos se marchita y se pierde.

Configurar una especie

Cada especie es un fichero en species/. El id sale del nombre del fichero, y las fases se recorren en el orden en que aparecen: la última es la que queda LISTA para cosechar.

yaml
# species/tomate.yml
display-name: "Tomate"
seed:
  material: BEETROOT_SEEDS
  display-name: "&cSemilla de Tomate"
requirements:
  seed-nbt: "tomate"     # lo natural es que coincida con el nombre del fichero
growth:
  wither-time: 2400      # segundos con una necesidad sin atender antes de morir
  stages:
    fase0:
      material: SHORT_GRASS
      scale: 0.5
      duration: 90       # segundos
      requirements:
        riego:
          type: NUTRIENT
          chance: 1.0
          nbt: "WATER"   # valor exacto: lo esperan la regadera y el autoregador
          display-name: "&bAgua"
    fase1:
      material: SWEET_BERRIES
      scale: 1.8
      duration: 0        # última fase = lista para cosechar
harvest:
  xfoods-id: "tomate"    # tiene que existir como comida en xFoods
  amount: 3

Atención

El material de una fase tiene que existir como ÍTEM. Materiales que son solo bloque (SWEET_BERRY_BUSH, POTATOES, CAVE_VINES...) hacen que la planta no se pueda dibujar. Usa SWEET_BERRIES en vez de SWEET_BERRY_BUSH.

Atención

En un requisito de tipo LIGHT, poner light.max por debajo de 15 bloquea la planta a cielo abierto: de día la luz es 15 y el jugador no tiene forma de bajarla, porque la Lámpara de Cultivo solo la sube. Usa solo el mínimo salvo que el cultivo sea de interior a propósito.

Los valores de nbt que reconoce la automatización son exactamente WATER (riego), organic (abono orgánico) y chemical (acelerante químico).

Maceteros y Automatización

Los maceteros (pods/) definen los modificadores del cultivo, y las máquinas de automatización (machines/) riegan, abonan, iluminan, fumigan y cosechan solas dentro de su radio.

yaml
# pods/macetero_hidroponico.yml
display-name: "&bMacetero Hidropónico"
item:
  material: DECORATED_POT
modifiers:
  growth-speed: 1.9      # 1.0 = duración tal cual la define la especie
  nutrient-rate: 2.4     # multiplica la pérdida de calidad por descuido
  yield: 1.2             # multiplica la cantidad cosechada
probabilities:
  pest-chance: 0.11      # probabilidad de plaga POR MINUTO (11%)

Información

pest-chance es la probabilidad por minuto, entre 0.0 y 1.0. Con 0.05 la planta tiene un 5% de infectarse en un minuto dado.

Atención

Una máquina de tipo SMART_LIGHT solo funciona si su material es REDSTONE_LAMP: el plugin enciende y apaga el bloque, y solo sabe hacerlo con lámparas de redstone.

Herramientas y plagas

Regadera de Cobre

Riega a mano sin gastar un ítem por uso: tiene 1000 ml de capacidad y cada riego consume 50. Se recarga con Esencia de Agua, que sale del Destilador de Agua de xFoods. Agáchate y haz click derecho para abrir su panel de recarga; click derecho sobre un macetero para regar.

Hoz de Cosecha

Cosechar con ella da un 40% de probabilidad de obtener además una semilla de lo que acabas de recoger. Es lo que permite que un cultivo se mantenga solo sin comprar semillas cada vez.

Plagas y pesticida

Una planta con plaga deja de crecer y de avanzar de fase: curarla es lo único útil que se puede hacer con ella. El holograma lo avisa con PLAGA DETECTADA. Click derecho con el pesticida industrial la limpia y gasta una unidad.

Consejo

El Fumigador Automático hace lo mismo en un radio de 5 bloques. El pesticida a mano es para arreglos puntuales o para cuando aún no tienes la máquina.

Mercado de valores

El mercado da precio a todo lo que produces, y ese precio se mueve solo: comprar lo sube, vender lo baja, cada 30 minutos se aplica una variación aleatoria y el precio tiende poco a poco a volver a su base.

El jugador siempre vende al 80% del precio actual. Ese 20% de diferencia es lo que impide comprar barato y revender caro en el mismo sitio, y lo que hace que produzcas en vez de especular.

yaml
# market.yml
market-items:
  tomate:
    display-name: "&cTomate"
    base-price: 8.0
    min-price: 3.0        # suelo aunque todos vendan
    max-price: 20.0       # techo aunque todos compren
    demand-factor: 0.0015 # cuánto mueve el precio cada unidad
    volatility: 0.10      # variación aleatoria: hasta ±10%

El id es el de la comida en xFoods, sin la carpeta. La configuración incluida cubre 14 artículos que forman la cadena entera, con márgenes pensados para que la lección se vea sola: comprar carne cruda y venderla cocinada deja poco, montar la hamburguesa deja bastante más, y fallar el minijuego del café convierte 48 en 2.

Información

La hamburguesa podrida no está en el mercado a propósito: si dejas que la comida caduque, la pierdes. Eso no se rescata vendiéndola.

Comandos

ComandoPermisoDescripción
/xfcrops marketxfoodscrops.useMercado de valores (requiere Vault y market.yml).
/xfcrops admin givepod <id>xfoodscrops.adminEntrega un macetero.
/xfcrops admin giveseed <id>xfoodscrops.adminEntrega la semilla de una especie.
/xfcrops admin givemachine <id>xfoodscrops.adminEntrega una máquina de automatización.
/xfcrops admin giveregaderaxfoodscrops.adminEntrega la Regadera de Cobre (riego manual).
/xfcrops admin givehozxfoodscrops.adminEntrega la Hoz de Cosecha (40% de semilla extra).
/xfcrops admin givepesticidexfoodscrops.adminEntrega pesticida: click derecho sobre una planta con plaga.
/xfcrops admin giveorganicxfoodscrops.adminEntrega fertilizante orgánico.
/xfcrops admin givechemicalxfoodscrops.adminEntrega acelerante químico.
/xfcrops admin listxfoodscrops.adminLista las especies cargadas.
/xfcrops admin reloadxfoodscrops.adminRecarga especies, máquinas y mercado.

Información

Alias del comando: /crops y /xfoods-crops. El alias /harvest se retiró antes del lanzamiento porque colisionaba con casi cualquier otro plugin de agricultura.

Consejo

Los ítems que no caben en el inventario caen al suelo en vez de perderse, así que ningún comando de dar te borra el objeto por tener el inventario lleno.

Contenido incluido

  • 3 especies — Lechuga (rápida, 2 de cosecha), Tomate (5 fases, exige sol directo, 3 de cosecha) y Cafeto (lento, 3 semillas por cosecha).
  • 3 maceteros — Barro (neutro), Invernadero (lento y seguro, x1.6 de cosecha) e Hidropónico (x1.9 de velocidad pero 11% de plaga por minuto).
  • 6 máquinas de automatización — Autoregador, dos dosificadores, Lámpara de Cultivo, Fumigador y Recolector.
  • Regadera, Hoz, pesticida y dos fertilizantes.
  • market.yml con 14 artículos.

Las tres especies están pensadas para enseñar los tres tipos de requisito: la lechuga el abono, el tomate la luz y el cafeto la paciencia.

Qué consume cada máquina

  • Autoregador — radio 5, consume Esencia de Agua.
  • Dosificador de Abono — radio 5, consume BONE_MEAL.
  • Dosificador Químico — radio 5, consume GLOWSTONE_DUST.
  • Lámpara de Cultivo — radio 6, consume GLOWSTONE_DUST.
  • Fumigador Automático — radio 5, consume SPIDER_EYE.
  • Recolector Automático — radio 5, no consume nada.

Atención

Automatizar no sale gratis: cada máquina gasta su recurso por acción, y el Recolector recoge sin mirar la calidad. Atender a mano sigue rindiendo más por planta.

Problemas frecuentes

La planta no crece

Mira el holograma: dice exactamente qué le falta. Las causas habituales son una plaga sin tratar o un requisito de luz que no se cumple. Recuerda que un light.max por debajo de 15 es imposible de cumplir a pleno sol.

La automatización no atiende la planta

El valor de nbt del requisito tiene que ser exactamente WATER, organic o chemical. Con cualquier otro valor la máquina no reconoce la necesidad como suya y la ignora.

La Lámpara de Cultivo no enciende

Una máquina SMART_LIGHT solo funciona sobre un bloque REDSTONE_LAMP: el plugin la enciende y la apaga, y solo sabe hacerlo con lámparas de redstone.

La semilla no se planta

Si la especie se borró o se renombró, la semilla vieja apunta a algo que ya no existe y el plugin avisa al jugador. Vuelve a darla con /xfcrops admin giveseed.

La cosecha sale como un helecho genérico

Significa que harvest.xfoods-id apunta a una comida que no existe en xFoods. Revisa que el id coincida con el nombre del fichero de la comida, sin la carpeta.

Los maceteros de un mundo no aparecen

Los maceteros en mundos aún no cargados se conservan y vuelven solos cuando el mundo carga. El arranque lo dice por consola indicando cuántos hay en esa situación.