Limitaciones conocidas

El conversor se encarga de la mayoría de las configuraciones, pero hay algunas limitaciones que conviene tener en cuenta.

Limitaciones generales

• Código y scripts propios: el scripting específico de cada plugin (por ejemplo, las actions de ItemsAdder o los disparadores de skills de MythicMobs) no se puede convertir automáticamente
• Funciones exclusivas de un plugin: algunas funciones existen en un plugin y no en otro. Esas propiedades generan advertencias y pueden perderse en la conversión
• Archivos del resource pack: el conversor solo se encarga de los archivos de configuración YAML. Los archivos de textura (PNG) y de modelo (JSON) hay que moverlos a mano a la estructura de carpetas que espera el plugin de destino
• Formatos de código de color: el conversor traduce automáticamente entre MiniMessage y los códigos de color legacy, pero los degradados complejos o el formato avanzado pueden necesitar una revisión manual
• Eventos y mechanics: los manejadores de eventos propios y los mechanics específicos de cada plugin normalmente no son convertibles, porque dependen de la API particular de cada uno

Notas por plugin

ItemsAdder

• Los bloques personalizados que usan bloques reales (tallo de champiñón, bloque musical) pueden necesitar un ajuste manual después de la conversión
• Las configuraciones de emotes no se convierten
• ItemsAdder usa un namespace en su sección info: el conversor lo extrae automáticamente

Oraxen

• Los glifos y las fuentes personalizadas pueden necesitar una revisión manual después de la conversión
• Las configuraciones específicas de mechanics pueden convertirse solo en parte
• Oraxen no admite tridentes personalizados: dan error durante la conversión

Nexo

• Al ser un plugin más nuevo, algunas funciones legacy de plugins más antiguos pueden no tener un equivalente directo
• Los componentes de Nexo son compatibles con las versiones 1.21.1 a 1.21.5
• Nexo admite tridentes de forma nativa, con propiedades display_transform

CraftEngine

• CraftEngine usa una estructura de item distinta, con bloques behavior en lugar de Mechanics
• Las configuraciones de bloque tienen un sistema propio de block_model y state
• Hay componentes disponibles para las versiones 1.20.5 a 1.21.11
• El formato de namespace usa la sintaxis namespace:item_id en las claves de item

MythicCrucible

• La integración de skills de MythicMobs (Skills, Triggers) es específica del plugin y no se puede trasladar a otros
• Los modificadores de atributos usan el formato propio de MythicCrucible, distinto al de los demás plugins
• Las categorías de encantamiento incluyen los tipos arma, a distancia, armadura, herramienta, universal, maldición y tridente
• Solo admite bloques de tipo NOTEBLOCK: los demás mechanics de bloque (TRIPWIRE, MUSHROOM) no están disponibles
• No admite los tipos de item comida, cultivo ni fuente
• Usa PascalCase en las claves YAML (por ejemplo, Material, Display, Generation), al contrario que los demás plugins

HMCCosmetics

• Solo está disponible como destino de conversión: no puedes convertir DESDE HMCCosmetics hacia otros plugins
• El conversor asigna los items a huecos de cosmético (casco, mochila, peto, pantalones, botas, mano secundaria, globo)
• No todos los tipos de item tienen una correspondencia con sentido en los huecos de cosmético: revisa el hueco asignado después de convertir
• El soporte de tintes es opcional y se puede activar durante la conversión

Entender el resultado de una conversión

Después de una conversión puedes ver tres tipos de avisos:

Advertencias de propiedades

Propiedades concretas que se han trasladado pero que quizá necesiten revisión. Cada advertencia incluye el ID del item, el nombre de la propiedad y una descripción del problema. Las advertencias tienen niveles de gravedad:

• Info: nota informativa, no hay que hacer nada
• Advertencia: puede necesitar una revisión manual
• Error: la propiedad no se ha podido convertir

Funciones no compatibles

Funciones detectadas en la config de origen que no tienen equivalente en el plugin de destino. Se muestran con el ID del item, el nombre de la función y una explicación.

Errores generales

Problemas críticos que han impedido que partes de la conversión se completasen.

Reportar problemas

Si te encuentras con una conversión que no funciona bien, cuéntanoslo en nuestro servidor de Discord  con:

1. La configuración de origen (el YAML original)
2. Los plugins de origen y destino que elegiste
3. Las advertencias o errores que salieron
4. Qué falló o en qué se diferencia de lo que esperabas