OreGenLib

OreGenLib

This Plugin allows you to inject your ore packs into the natural world Generation using an XML sheet inside your pack and making this plugin a dependency of your mod on Curseforge . It also comes with tools to test if your injection was successful.

2.6 тысяч загрузок
Обновлён 6 дней назад

Скриншоты

Описание

Если вы просто ищете инструменты для тестирования, ознакомьтесь с моим другим плагином - EZDEV (скоро выйдет), который имеет инструменты телепортатора и многое другое в нем, например, основанное на Ui меню, руда, биом и многое другое!

Оригинальная идея мода пришла из Уголь! Meowerz (MIT)

Важное напоминание: сделайте этот плагин зависимым от вашего мода от Curseforge, если вы используете его для впрыска руды в пакеты активов. Чтобы сделать это, когда вы впервые загружаете свой мод, чтобы проклясть в нижней части страницы, где он запрашивает ваш «журнал изменений», вы увидите, что «добавить соответствующий проект» нажмите это и введите «OreGenLib» без цитат, это должно позволить вам выбрать этот плагин и добавить его в качестве зависимости! (Возможно, вы захотите добавить в описание своего мода, что он устанавливает этот мод в качестве необходимого мода, если кто-то видит этот мод и удаляет его, потому что он не знает, что это такое, он больше не будет вводить руды, и базовая игра не будет отправлять предупреждение о зависимости, отсутствующей для обычных модов с застегнутыми активами, только Jar «Plugins» с обновления 2.)
Я обновлю этот пункт, если они добавят ошибки, вызванные зависимостью, для модов с активами и объясню, как добавить зависимость в файл манифеста.


OreGenLibrary (MIT) — XML-Driven Ore Worldgen + Ore/Biome/Zone Admin UI & Teleport Tools

OreGenLibrary Это настраиваемая библиотека генерации руды, которая позволяет авторам модпаков добавлять или настраивать генерацию руды с помощью простого XML-файла. Код не требуется. Он также включает Игровые страницы UI (активы) для просмотра руд/биомов и экспортной документации.


Что делает этот мод

1) Правила генерации грузов из XML

OreGenLibrary автоматически сканирует установленную папку модов для пакетов активов, содержащих этот файл:

Ore_Gen/CustomOreTypes.xml

Он объединяет все найденные конфигурации и использует их для управления миром.

Где ваш XML входит в ваш пакет / мод:

YourPackOrMod/
манифест. Джонсон
Ore_Gen
CustomOreTypes.xml 

Вы можете иметь несколько пакетов активов, содержащих Ore_Gen/CustomOreTypes.xml OreGenLibrary объединяет их всех.


2) Инъекции руд в мировое поколение (как работает инъекция)

OreGenLibrary подключается к конвейеру генерации кусков сервера и применяет ваши правила руды только тогда, когда кусочек генерируется заново..

Важное правило ванильного стиля: Существующие куски не меняются автоматически — чтобы увидеть новые правила руды, исследуйте новые куски (или используйте инструменты ретрогена ниже).


3) Поддерживает два стиля размещения (ваш выбор)

OreGenLibrary поддерживает оба Подходы — выберите то, что подходит вашей упаковке:

A) Спаун/местонахождение хоста

Классический генератор руды, который помещает вены на основе:

  • Исполнитель: chancePerChunk

  • веныМин/вены Макс

  • ВенаSizeMin / ВенаSizeMax

  • yMin / yMax

  • плюс различные правила замены хоста

Это «ручное управление» и отлично подходит, когда вы хотите точной настройки.

В) Шаблон / Инъекция в ближний вейн

Укрепляет ваше заказное размещение руды рядом Существующие семейства базовых руд (Iron/Copper/etc) вместо просто случайного размещения.

Это полезно, когда вы хотите, чтобы распределение модифицированной руды «следовало» за базовым семейством руды.

Ни один из режимов не «рекомендуется» — это разные инструменты для разных целей балансировки.


4) Мощные фильтры (биомы, зоны, категории)

Каждое правило руды может быть ограничено с помощью фильтров, таких как:

  • биом включает/исключает (совпадение токенов)

  • Зона и уровень Соответствие (только Зона 4 уровня 5)

  • Категория / Ключи обнаружения (на берегу/под землей/и т.д.

  • Префикс соответствия семейств биом/зона

Это позволяет вам делать такие вещи, как:

  • «Испанец только в зоне 4 под землей»

  • «Испанец только в пустыне накапливает биомы»

  • «Испанцы только в прибрежных категориях»

  • Отдельные варианты на хост (Stone/Basalt/Sandstone/etc)


5) Страницы пользовательского интерфейса администратора (просмотр + инструменты телепортации)

OreGenLibrary включает пользовательские страницы пользовательского интерфейса, которые предоставляют:

  • Список руды UIПоисковый список загруженных идентификаторов руды и действий

  • Биологический список UIПросмотр всех биомов от текущего генератора

  • Известный биом UIЗонд биом карты вокруг вас и список близлежащих биомов

  • Руководство UIвнутриигровая документация + инструменты экспорта


6) Безопасная телепортация + "Последние известные места добычи руды"

Инструменты телепорта включают:

  • Безопасная логика телепортации (пытается избежать нереста внутри блоков, найдя подходящее соседнее пространство)

  • Зонд без телепорта (сохранить представительную координату)

  • Последний известный Места хранения (постоянные между перезагрузками)


Команды (креативная/административная группа)

Корневая команда:

  • кустомореген
    Алиасы:

  • винтик

  • КОГ

/g перезарядка

Перезагрузить все CustomOreTypes.xml Сканирование (Rescans).

  • Необязательно: ясно Повторное применение правил для В настоящее время загруженные куски вокруг вас (не удаляет куски; может повлиять на подземные сооружения)

  • Необязательно: -radius=<chunks> (используется с ясно)

/cog ретроген

Бюджетное повторное применение по соседним частям (включая инструменты безопасности):

  • -radius=<chunks> (по умолчанию 2)

  • -maxY=<y> (дефолт 45)

  • --бюджет=<куски> (по умолчанию 120)

  • сухой (симуляция / предварительный просмотр)

  • -подтвердить (необходимо реально бежать)

/g guide

Откройте страницу в игре Modder Guide.

/g listore

Открывает доступный для поиска список идентификаторов руды, загруженных из XML.

/cog listbiomes

Списки все биомы, сконфигурированные генератором тока (включает мод-добавленные биомы).

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

Обследует карту биома вокруг вас и перечисляет набор наблюдаемых биомов (не требует наличия кусков).

/g currentbiome

Печатает однострочный вывод, показывающий ваш текущий Biome + Зона.

/g tp

Телепортный помощник (ор или биом). Поддерживаемые аргументы включают:

  • руда (наименование базовой руды)

  • биом (биом токен или полное имя биома)

  • радиус

  • максимум

  • следующий (Первые N матчи)

  • откат (или радиус откидной нагрузки)

  • Последний = 1 (телепорт для хранения последней известной руды)

  • зонд = 1 (сохранить результат без телепортации)

  • х / z (ручные координаты превышены)

  • этикетка (необязательная маркировка)

Для точного формата аргумента, который ожидает ваш сервер, откройте /g guide В игре — примеры.


Где найти документы + экспорт (HTML / примеры / таблица)

В игре Guide

Используйте:

  • /g guide

Страница гида включает Экспортная помощь Docs кнопки, которые записывают файлы в стабильную папку на диске.

Пакет экспортной продукции (по умолчанию)

Экспорт пишется на:

%AppData%\Hytale\UserData\Mods\oregenlibrary-docs

(Вы можете переопределить каталог Модов с помощью env var) OREGENLIB_MODS_DIR.

Что гид в настоящее время экспортирует через кнопки

  • ПримерCustomOreTypes.xml

  • OreGenLibrary_XML_Reference.html

  • TemplateDictional.html

Где находится электронная таблица

Раритетная таблица упакована внутри мод JAR по адресу:

  • docs/OreRarity_UserGuide.xlsx

Если в вашей версии еще нет кнопки, вы можете:

  • Откройте мод JAR с 7-Zip/WinRAR

  • экстракт docs/OreRarity_UserGuide.xlsx

  • (необязательно) размещать его вместе с экспортируемыми документами в Орегенлибрационные данные/докс


Заметки об обновлениях мира / изменения ванили

Обновления Vanilla Worldgen часто требуются новые куски Отражать новое распределение руды. OreGenLibrary ведет себя так же для инъекций: новые куски получают правила автоматически; существующие куски нуждаются в инструментах ретрогена, если вы хотите, чтобы изменения применялись задним числом.


Лицензия

OreGenLibrary выходит под МТИ Лицензия (Сохранить атрибуцию + лицензию при перераспределении).


 

Показать оригинальное описание (English)

If you are just looking for the testing tools check out my other plugin --EZDEV (coming soon) which has the teleporter tools and much more in it like a Ui based whom to whom tp menu, ore tp, biome tp, and more coming!

Original Idea for the mod came from Coal! by Meowerz (MIT)

Important Reminder: make this plugin a dependency of your mod on Curseforge if you are using it to inject ore for your asset packs. to do this when you upload your mod for the first time to curseforge at the bottom of the page where its asking for your "change log" you will see "add related project" click that and type out "OreGenLib" without the quotes this should allow you to select this plugin and add it as a dependency! (You may want to put it in the description of your mod that it installs this mod as a required mod for if someone sees this mod and uninstalls it because they dont know what it is it will not inject the ores anymore either and the base game will not send a warning about dependency missing for normal asset zipped mods only Jar "Plugins" as of update 2.
--I will update this paragraph if they add dependency driven errors for zipped asset mods and explain then how to add as a dependency in manifest file.


OreGenLibrary (MIT) — XML-Driven Ore Worldgen + Ore/Biome/Zone Admin UI & Teleport Tools

OreGenLibrary is a configurable ore-generation library that lets modpack authors add or tweak ore generation using a simple XML file — no code required. It also includes in-game UI pages (assets) for browsing ores/biomes and exporting documentation.


What this mod does

1) Loads ore generation rules from XML

OreGenLibrary automatically scans installed mods folder for asset packs containing this file:

Ore_Gen/CustomOreTypes.xml

It merges all found configs and uses them to drive worldgen.

Where your XML goes inside your pack/mod:

YourPackOrMod/
  manifest.json
  Ore_Gen/
    CustomOreTypes.xml

You can have multiple asset packs containing Ore_Gen/CustomOreTypes.xml — OreGenLibrary merges them all.


2) Injects ores into world generation (how injection works)

OreGenLibrary hooks into the server’s chunk generation pipeline and applies your ore rules only when a chunk is newly generated.

Important vanilla-style rule: existing chunks don’t change automatically — to see new ore rules, explore new chunks (or use the retrogen tools below).


3) Supports two placement styles (your choice)

OreGenLibrary supports both approaches — choose what fits your pack:

A) Spawn / Replace-Host placement

A classic ore generator that places veins based on:

  • chancePerChunk

  • veinsMin / veinsMax

  • veinSizeMin / veinSizeMax

  • yMin / yMax

  • plus per-variant host replacement rules

This is “manual control” and is great when you want exact tuning.

B) Template / Near-Vein injection

Anchors your custom ore placement near existing base-game ore families (Iron/Copper/etc) rather than purely random placement.

This is useful when you want your modded ore distribution to “follow” where a base ore family exists.

Neither mode is “recommended” — they are different tools for different balancing goals.


4) Powerful filters (biomes, zones, categories)

Every ore rule can be restricted using filters such as:

  • Biome includes/excludes (token matching)

  • Zone and Tier matching (ex: Zone 4 tier 5 only)

  • Category / discovery keys (shore/underground/etc)

  • Prefix matching for biome/zone families

This lets you do things like:

  • “Spawn only in Zone 4 underground”

  • “Spawn only in Desert stacks biomes”

  • “Spawn only in shore categories”

  • “Separate variants per host (Stone/Basalt/Sandstone/etc)”


5) Admin UI pages (browse + teleport tools)

OreGenLibrary includes custom UI pages that provide:

  • Ore list UI: searchable list of loaded ore IDs and actions

  • Biome list UI: browse all biomes from the current generator

  • Known-biomes UI: probe biome map around you and list nearby biomes

  • Guide UI: in-game documentation + export tools


6) Safe teleporting + “Last Known” ore locations

Teleport tools include:

  • Safe teleport logic (tries to avoid spawning you inside blocks by finding a valid nearby space)

  • Probe without teleport (store a representative coordinate)

  • Last Known stored locations (persistent between restarts)


Commands (Creative/admin group)

Root command:

  • /customoregen
    Aliases:

  • /cog

  • /COG

/cog reload

Reloads all CustomOreTypes.xml configs (rescans).

  • Optional: --clear re-applies rules to currently loaded chunks around you (does not delete chunks; can affect underground builds)

  • Optional: --radius=<chunks> (used with --clear)

/cog retrogen

Budgeted re-application over nearby chunks (safety tools included):

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

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

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

  • --dry (simulate / preview)

  • --confirm (required to actually run)

/cog guide

Opens the in-game Modder Guide page.

/cog listore

Opens a searchable UI list of ore IDs loaded from XML.

/cog listbiomes

Lists all biomes configured by the current generator (includes mod-added biomes).

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

Probes the biome map around you and lists the set of biomes seen (does not require chunks to already exist).

/cog currentbiome

Prints a one-line output showing your current Biome + Zone.

/cog tp

Teleport helper (ore or biome). Arguments supported include:

  • ore (custom ore id OR base ore family name)

  • biome (biome token or full biome name)

  • radius

  • maxY

  • next (skip first N matches)

  • fallback (ore fallback chunk load radius)

  • last=1 (teleport to stored last-known for ore)

  • probe=1 (store a result without teleporting)

  • x / z (manual coordinate overrides)

  • label (optional logging label)

For the exact argument format your server build expects, open /cog guide in-game — it shows examples.


Where to find the docs + exports (HTML / examples / spreadsheet)

In-game Guide

Use:

  • /cog guide

The guide page includes Export Help Docs buttons that write files to a stable folder on disk.

Export output folder (default)

Exports are written to:

%AppData%\Hytale\UserData\Mods\oregenlibrary-data\docs

(You can override the Mods directory with the env var OREGENLIB_MODS_DIR.)

What the guide currently exports via buttons

  • exampleCustomOreTypes.xml

  • OreGenLibrary_XML_Reference.html

  • TemplateDictionary.html

Where the spreadsheet is

The rarity spreadsheet is bundled inside the mod JAR at:

  • docs/OreRarity_UserGuide.xlsx

If your version doesn’t have a button exporting it yet, you can:

  • open the mod JAR with 7-Zip/WinRAR

  • extract docs/OreRarity_UserGuide.xlsx

  • (optionally) place it alongside the exported docs in oregenlibrary-data/docs


Notes on world updates / vanilla changes

Vanilla worldgen updates often require new chunks to reflect new ore distribution. OreGenLibrary behaves the same way for injection: newly generated chunks receive the rules automatically; existing chunks need retrogen tools if you want changes applied retroactively.


License

OreGenLibrary is released under the MIT License (keep attribution + license if redistributing).


 

Последние версии

OreGenLibrary.jar

Early Access 28.01.2026 176.4 КБ
Скачать

OreGenLibrary.jar

Early Access 26.01.2026 173.9 КБ
Скачать