# Tabla definitiva de rarezas de PickLoot para Minecraft Java 1.21.1

Esta tabla pertenece a la lógica visual de PickLoot. No reemplaza la rareza interna de
Minecraft ni modifica las estadísticas de los objetos. Su objetivo es representar dificultad
de obtención, riesgo, escasez y avance de supervivencia.

La clasificación se evalúa en este orden:

1. Una regla del usuario en `config/pickloot-rarities.json` controla el color y tiene prioridad visual.
2. Un objeto con encantamientos reales recibe **Legendario**.
3. Se aplican las excepciones y familias de Minecraft 1.21.1 descritas debajo.
4. Se conserva una rareza vanilla significativa que no haya sido corregida por la tabla.
5. Todo objeto vanilla restante recibe **Normal**. Por tanto, ningún ID queda sin clasificación.

## Niveles

| Nivel | Criterio |
|---|---|
| Normal | Cotidiano, renovable, fabricable temprano o abundante |
| Común | Requiere progreso moderado, una mecánica especial, magia, arqueología o un recurso intermedio |
| Raro | Exploración peligrosa, botín exclusivo, baja probabilidad o progreso tardío |
| Épico | Recompensa única, jefe, progreso extremo, obtención excepcional o acceso administrativo |
| Legendario | Cualquier objeto con componentes de encantamiento reales |

## Legendario

No depende del ID. PickLoot inspecciona `ENCHANTMENTS` y `STORED_ENCHANTMENTS`; por ello incluye
equipo encantado y libros encantados. Un simple efecto de brillo, una poción o una manzana dorada
encantada sin encantamientos almacenados no activa esta regla.

## Épico

- Toda la familia `minecraft:netherite_*`, incluyendo equipo, materiales, bloque y plantilla.
- `minecraft:ancient_debris`
- `minecraft:beacon`
- `minecraft:dragon_egg`
- `minecraft:elytra`
- `minecraft:enchanted_golden_apple`
- `minecraft:heavy_core`
- `minecraft:mace`
- `minecraft:nether_star`
- `minecraft:silence_armor_trim_smithing_template`
- Cabezas: Creeper, Dragón, Piglin, jugador, Esqueleto, Esqueleto Wither y Zombi.
- Objetos administrativos/no obtenibles normalmente: barrera, bedrock, budding amethyst,
  command blocks, command-block minecart, debug stick, end portal frame, jigsaw, knowledge book,
  light, reinforced deepslate, spawner, structure block/void, trial spawner y vault.

## Raro

Familias completas:

- `minecraft:diamond_*` y el diamante base.
- `minecraft:emerald_*` y la esmeralda base.
- `minecraft:music_disc_*`.
- Todas las plantillas `*_armor_trim_smithing_template`, excepto Silence, ya clasificada como épica.
- Todos los objetos `*_banner_pattern`.
- Todas las shulker boxes, incluyendo sus colores.

Excepciones exactas:

- Conduit, armadura de caballo de diamante, fragmento de disco 5 y echo shard.
- Heart of the Sea, lodestone, name tag, nautilus shell y recovery compass.
- Ominous trial key, saddle, shulker shell y sniffer egg.
- Sponge, wet sponge, Totem of Undying y trident.

## Común

Familias completas:

- Equipo y objetos `minecraft:golden_*`.
- Toda la armadura `minecraft:chainmail_*`.
- Todos los fragmentos `*_pottery_sherd`.

Recursos de progreso:

- Oro: minerales normal y deepslate, mineral del Nether, lingote, nugget, bloque, raw gold y su bloque.
- Redstone: mineral normal y deepslate, polvo y bloque.
- Lapislázuli: mineral normal y deepslate, gema y bloque.
- Cuarzo: mineral del Nether, cuarzo y bloque.
- Gilded blackstone.

Magia y dimensiones:

- Blaze rod/powder, dragon breath, end crystal, Ender pearl/eye y experience bottle.
- Ghast tear, magma cream, nether wart, phantom membrane y rabbit foot.
- Brewing stand, enchanting table, Ender chest y respawn anchor.
- Prismarine shard/crystals, sculk catalyst y sculk shrieker.

Trial Chambers, arqueología y criaturas:

- Armadillo scute, wolf armor, turtle scute/helmet y goat horn.
- Breeze rod, wind charge, trial key y ominous bottle.
- Pitcher pod y torchflower seeds.

Utilidad especial:

- Golden apple, armaduras de caballo de oro y hierro.
- Amethyst shard/block/cluster, obsidian, crying obsidian y slime ball.
- Anvil, chipped/damaged anvil, jukebox y magma block.

## Normal

Todo ID vanilla 1.21.1 que no coincida con una regla anterior. Esto incluye de forma intencional:

- Tierra, piedra, arena, grava, maderas, hojas y bloques decorativos.
- Cultivos, flores, semillas comunes y alimentos habituales.
- Carbón, hierro y cobre, sus minerales, materiales crudos, lingotes y bloques.
- Herramientas de madera, piedra e hierro; armaduras de cuero y hierro.
- Brújula, reloj, mecanismos de redstone fabricables, transportes y utilidades tempranas.
- Bloques constructivos del Nether, End, océanos, cuevas y Trial Chambers.

## Objetos de mods

PickLoot respeta primero la rareza que el mod publica en `ItemStack#getRarity()`. Si el mod deja
el valor vanilla predeterminado, utiliza tags `c:gems`, `c:ores`, `c:raw_materials` y `c:ingots`,
además de términos conservadores del ID para reconocer gemas, artefactos, reliquias, herramientas,
armaduras y materiales de progreso. Los autores de modpacks pueden corregir cualquier caso mediante
`pickloot-rarities.json` sin recompilar PickLoot.

## Decisiones deliberadas

- El tótem, tridente y conduit son raros, no épicos: son difíciles, pero se pueden obtener repetidamente.
- El beacon es épico porque exige derrotar al Wither.
- La manzana dorada normal es común; la encantada es épica.
- Restos ancestrales y toda la progresión de netherita son épicos.
- Compass y clock son normales por ser fabricables temprano.
- Los objetos técnicos están en épico para que sean visibles si un comando o mod los arroja al mundo.
