OreGenLib

Si solo estás buscando las herramientas de prueba, consulta mi otro complemento –EZDEV (próximamente) que tiene las herramientas de teletransportación y mucho más, como un menú de teletransportación basado en UI, teletransportación de minerales, teletransportación de biomas y más que vendrá pronto!

La idea original para el mod provino de ¡Carbón! por Meowerz (MIT)

Recordatorio importante: haz de este complemento una dependencia de tu mod en Curseforge si lo estás utilizando para inyectar minerales para tus paquetes de activos. Para hacer esto, cuando subas tu mod por primera vez a Curseforge, en la parte inferior de la página donde se te pide tu “registro de cambios”, verás “agregar proyecto relacionado”; haz clic en eso y escribe “OreGenLib” sin las comillas, esto debería permitirte seleccionar este complemento y agregarlo como una dependencia. (Puede que quieras ponerlo en la descripción de tu mod que instala este mod como un mod requerido, porque si alguien ve este mod y lo desinstala porque no sabe lo que es, tampoco inyectará los minerales y el juego base no enviará una advertencia sobre la falta de dependencia para mods empaquetados normales, solo para “Plugins” de Jar a partir de la actualización 2.
–Actualizaré este párrafo si añaden errores impulsados por dependencias para mods de activos empaquetados y explicaré cómo agregarlo como una dependencia en el archivo de manifiesto.

OreGenLibrary es una biblioteca de generación de minerales configurable que permite a los autores de paquetes de mods agregar o ajustar la generación de minerales utilizando un archivo XML simple — sin código requerido. También incluye páginas de UI en el juego (activos) para navegar por minerales/biomas y exportar documentación.

1) Carga reglas de generación de minerales desde XML

OreGenLibrary escanea automáticamente la carpeta de mods instalados en busca de paquetes de activos que contengan este archivo:

✅ Ore_Gen/CustomOreTypes.xml

Fusiona todas las configuraciones encontradas y las utiliza para impulsar la generación del mundo.

Dónde va tu XML dentro de tu paquete/mod:

YourPackOrMod/
  manifest.json
  Ore_Gen/
    CustomOreTypes.xml

Puedes tener múltiples paquetes de activos que contengan Ore_Gen/CustomOreTypes.xml — OreGenLibrary los fusiona todos.

2) Inyecta minerales en la generación del mundo (cómo funciona la inyección)

OreGenLibrary se conecta a la tubería de generación de chunks del servidor y aplica tus reglas de minerales solo cuando un chunk es generado recientemente.

Regla importante al estilo vanilla: los chunks existentes no cambian automáticamente — para ver nuevas reglas de minerales, explora nuevos chunks (o usa las herramientas de retrogeneración a continuación).

3) Soporta dos estilos de colocación (tu elección)

OreGenLibrary soporta ambos enfoques — elige lo que se ajuste a tu paquete:

A) Colocación de Spawn / Reemplazo-Host

Un generador de minerales clásico que coloca vetas basándose en:

• chancePerChunk

• veinsMin / veinsMax

• veinSizeMin / veinSizeMax

• yMin / yMax

• más reglas de reemplazo por variante de host

Este es el “control manual” y es excelente cuando deseas un ajuste exacto.

B) Inyección de Plantilla / Cerca de Veta

Ancla tu colocación de minerales personalizada cerca de familias de minerales del juego base existentes (Hierro/Cobre/etc) en lugar de una colocación puramente aleatoria.

Esto es útil cuando deseas que la distribución de tus minerales modificados “siga” donde existe una familia de minerales base.

Ningún modo es “recomendado” — son herramientas diferentes para diferentes objetivos de balanceo.

4) Filtros poderosos (biomas, zonas, categorías)

Cada regla de mineral puede ser restringida usando filtros como:

• Bioma incluye/excluye (coincidencia de tokens)

• Zona y coincidencia de Nivel (ej: Zona 4 nivel 5 solo)

• Categoría / claves de descubrimiento (costa/subterráneo/etc)

• Coincidencia de prefijos para familias de biomas/zona

Esto te permite hacer cosas como:

• “Aparecer solo en la Zona 4 subterránea”

• “Aparecer solo en biomas de pilas del desierto”

• “Aparecer solo en categorías de costa”

• “Separar variantes por host (Piedra/Basalto/arenisca/etc)”

5) Páginas de UI de administración (navegar + herramientas de teletransportación)

OreGenLibrary incluye páginas de UI personalizadas que proporcionan:

• UI de lista de minerales: lista buscable de IDs de minerales cargados y acciones

• UI de lista de biomas: navegar por todos los biomas del generador actual

• UI de biomas conocidos: sondear el mapa de biomas a tu alrededor y listar biomas cercanos

• UI de guía: documentación en el juego + herramientas de exportación

6) Teletransportación segura + ubicaciones de minerales “Última Conocida”

Las herramientas de teletransportación incluyen:

• Lógica de teletransportación segura (intenta evitar que aparezcas dentro de bloques encontrando un espacio cercano válido)

• Sondear sin teletransportar (almacenar una coordenada representativa)

• Última Conocida ubicaciones almacenadas (persistente entre reinicios)

Comandos (grupo creativo/admin)

Comando raíz:

• /customoregen
  Alias:

• /cog

• /COG

/cog reload

Recarga todas las configuraciones de CustomOreTypes.xml (rescanea).

• Opcional: --clear reaplica reglas a chunks actualmente cargados a tu alrededor (no elimina chunks; puede afectar construcciones subterráneas)

• Opcional: --radius=<chunks> (usado con --clear)

/cog retrogen

Reaplicación presupuestada sobre chunks cercanos (herramientas de seguridad incluidas):

• --radius=<chunks> (predeterminado 2)

• --maxY=<y> (predeterminado 45)

• --budget=<chunks> (predeterminado 120)

• --dry (simular / vista previa)

• --confirm (requerido para ejecutar realmente)

/cog guide

Abre la página de Guía de Modder en el juego.

/cog listore

Abre una lista de UI buscable de IDs de minerales cargados desde XML.

/cog listbiomes

Lista todos los biomas configurados por el generador actual (incluye biomas añadidos por mods).

/cog listknownbiomes [--radius=<chunks>]

Sondea el mapa de biomas a tu alrededor y lista el conjunto de biomas vistos (no requiere que los chunks ya existan).

/cog currentbiome

Imprime una salida de una línea mostrando tu actual Bioma + Zona.

/cog tp

Ayudante de teletransportación (mineral o bioma). Los argumentos soportados incluyen:

• ore (ID de mineral personalizado O nombre de familia de mineral base)

• biome (token de bioma o nombre completo de bioma)

• radius

• maxY

• next (saltar los primeros N coincidencias)

• fallback (radio de carga de chunk de reserva de mineral)

• last=1 (teletransportar a la última conocida almacenada para el mineral)

• probe=1 (almacenar un resultado sin teletransportar)

• x / z (sobrescrituras de coordenadas manuales)

• label (etiqueta de registro opcional)

Para el formato exacto de argumento que tu construcción de servidor espera, abre /cog guide en el juego — muestra ejemplos.

Dónde encontrar la documentación + exportaciones (HTML / ejemplos / hoja de cálculo)

Guía en el juego

Usa:

• /cog guide

La página de guía incluye botones de Exportar Ayuda Docs que escriben archivos en una carpeta estable en el disco.

Carpeta de salida de exportación (predeterminada)

Las exportaciones se escriben en:

%AppData%HytaleUserDataModsoregenlibrary-datadocs

(Puedes anular el directorio de Mods con la variable de entorno OREGENLIB_MODS_DIR.)

Lo que la guía actualmente exporta a través de botones

• exampleCustomOreTypes.xml

• OreGenLibrary_XML_Reference.html

• TemplateDictionary.html

Dónde está la hoja de cálculo

La hoja de cálculo de rareza está empaquetada dentro del JAR del mod en:

• docs/OreRarity_UserGuide.xlsx

Si tu versión no tiene un botón que la exporte aún, puedes:

• abrir el JAR del mod con 7-Zip/WinRAR

• extraer docs/OreRarity_UserGuide.xlsx

• (opcionalmente) colocarlo junto a los docs exportados en oregenlibrary-data/docs

Notas sobre actualizaciones del mundo / cambios de vanilla

Las actualizaciones de generación de mundos vanilla a menudo requieren nuevos chunks para reflejar la nueva distribución de minerales. OreGenLibrary se comporta de la misma manera para la inyección: los chunks recién generados reciben las reglas automáticamente; los chunks existentes necesitan herramientas de retrogeneración si deseas que se apliquen cambios de manera retroactiva.

Licencia

OreGenLibrary se publica bajo la Licencia MIT (mantén la atribución + licencia si redistribuyes).