docs/MEJORAS-PARASITO.md

# Colaboración y mejoras del huésped

La criatura conserva sus decisiones y no ataca a bots. No se crea una alianza automáticamente: cada agente decide si estudiar al huésped, proponer una mejora o invertir sus materiales. Los mensajes de `/botmalo` llegan al buzón administrativo y pueden orientar una prueba.

Las herramientas son `parasite_upgrade_catalog`, `parasite_upgrade_propose`, `parasite_upgrade_status` y `parasite_upgrade_apply`. La propuesta lleva `capacity` y `goal`. Admite efectos del registro con `effect:namespace:id` y atributos con `attribute:namespace:id`, incluidos los aportados por mods. El catálogo permite buscar IDs existentes; Luna puede elegirlos y combinar adaptaciones según su experiencia. Por ejemplo, `effect:minecraft:fire_resistance` protege contra fuego y lava, y `effect:minecraft:water_breathing` facilita permanecer bajo agua.

Los efectos permanentes usan potencia de cero a dos y se renuevan localmente. Los instantáneos se ejecutan una sola vez al pagar; no se repiten gratis. Los atributos registrados deben existir en el cuerpo y agregan dos puntos por nivel, respetando los límites del propio atributo; velocidad usa ocho por ciento. También se conservan `HEALTH`, `SPEED`, `DAMAGE` y `PERCEPTION`, que agregan respectivamente ocho puntos de salud máxima, ocho por ciento de velocidad base, 1,5 de daño o seis bloques de percepción. Cada capacidad admite tres niveles y el cuerpo admite32 adaptaciones registradas. Ampliar salud máxima no cura y ninguna mejora cambia la protección del modo sensible.

Luna recibe una consulta independiente como tasador neutral. Sólo puede entregar una cotización de materiales. Usa el mismo proveedor y presupuesto acumulado de USD 5 que los bots, la criatura y Sol. El servidor comprueba IDs del registro, cantidades, materiales consumibles y un costo mínimo creciente. Una respuesta incompleta, inválida o sin crédito no produce una cotización de reemplazo.

El bot consulta el identificador `quote` y reúne los materiales. Un generalista puede pagar una cotización compartida, a menos de seis bloques del cuerpo canónico, usando exclusivamente su inventario. El inventario se comprueba entero antes de consumir algo. Las cotizaciones vencen tras un día del juego y una aplicación las consume; repetir la orden no aplica otro nivel. Recursos con NBT y contenedores quedan excluidos del cobro.

Los niveles, pagos, proponentes, impactos recibidos, causas de daño —incluida lava— y derrotas se guardan con el mundo. La información de combate se incluye en las tasaciones. La herramienta de estado permite compartir esos hechos con otros bots y cambiar de objetivo. Las mejoras no reviven una criatura muerta ni sustituyen la industrialización mediante Create. Una capacidad que todavía no existe en el juego necesita una extensión mecánica del mod; una descripción de Luna no ejecuta código Java arbitrario.

Para consultar desde administración:

```text
/Raps mimicer mejoras
/botmalo all Estudien al huésped y evalúen si les conviene colaborar. Consulten parasite_upgrade_status, propongan una mejora y consigan los materiales de la cotización antes de montarla.
```

Para probar una herramienta concreta sobre un bot:

```text
/Raps herramienta Helio parasite_upgrade_catalog {"query":"fire_resistance"}
/Raps herramienta Helio parasite_upgrade_propose {"capacity":"effect:minecraft:fire_resistance","goal":"Sobrevivir a las trampas de lava de los humanos"}
/Raps herramienta Helio parasite_upgrade_status {}
/Raps herramienta Helio parasite_upgrade_apply {"quote":"UUID-de-la-cotizacion"}
```

El tasador requiere una respuesta real de la API; las pruebas automatizadas usan transportes en memoria y nunca pagan llamadas. Los investigadores pueden consultar y proponer; el montaje físico requiere un generalista con los materiales.