Beyond Dimensions

Beyond Dimensions

Beyond Dimensions — это мод, сосредоточенный на хранении и утилитах. Он добавляет «Пространственную сеть» — универсальную систему хранения, поддерживающую предметы, жидкости, энергию FE, опыт, химикаты Mekanism, источники Ars Nouveau, ману Botania и Souls из Industrial Foregoing. Он сочетает исключительную вместимость и производительность с удобным интерфейсом, легко справляясь с потребностями в хранении для большинства сценариев.

С чего начать

Вам нужно победить Wither или получить Nether Star любым другим способом. Скрафтите из неё Нестабильный фрагмент пространства-времени. Держите этот фрагмент в инвентаре в течение одного часа, и он превратится в Стабильный фрагмент пространства-времени. Используйте его, чтобы скрафтить Генератор пространственной сети и активируйте его, чтобы создать свою Пространственную сеть. Затем просто нажмите горячую клавишу (по умолчанию: 'O'), чтобы открыть интерфейс хранилища.

Система хранения

• Вместимость: Стандартная вместимость хранилища является максимальной. Оно может хранить 2,1 миллиарда различных типов предметов или ресурсов, причём каждый тип способен вмещать 2^63^-1 единиц (максимальное значение Java long). Максимальное количество хранимых типов, вместимость на тип и способы расширения хранилища можно настроить с помощью KubeJS.
• Производительность: Система хранения прошла обширную оптимизацию. Тесты производительности показывают отличные результаты как при подключении к AE2, так и при использовании только этого мода. Конкретные результаты тестов смотрите в разделе Тестирование производительности.
• Мультиплеер: Система хранения привязывает сети с помощью прав игроков. Одну сеть можно предоставить нескольким игрокам. Кроме того, общий доступ можно организовать через Терминалы в виде предметов.

Интерфейс

Интуитивный интерфейс хранилища: Мод предоставляет интерфейс, следующей логике взаимодействия, совместимой с популярными модами для хранения, такими как AE2 и RS.

• Встроенная сетка крафта.
• Несколько режимов поиска: прямой ввод текста ищет по названиям, подсказкам или ID модов. Префикс # для строгого поиска по подсказкам. Префикс @ для строгого поиска по ID модов.
• Настраиваемое количество отображаемых строк предметов.
• Несколько вариантов сортировки: по времени попадания в хранилище, по количеству, по названию, по ID мода.

Универсальная система слотов: Любой слот в любом GUI мода может хранить все поддерживаемые типы ресурсов и поддерживает механики быстрого взаимодействия.

Быстрые операции с контейнерами: Нажмите правой кнопкой мыши по слоту, держа соответствующий контейнер, чтобы быстро положить/забрать ресурсы из контейнера. Например: ПКМ по слоту с Shulker Box, Sophisticated Backpack или любым контейнером быстро поместит предметы в контейнер; ПКМ по пустому слоту быстро извлечёт предметы из контейнера и поместит их в слот. Эта операция поддерживает жидкости, химикаты Mekanism и даже энергию FE.

Поддержка автоматизации и утилиты

Мод предоставляет блоки для автоматизации и утилитарные предметы. Эти блоки нужно привязать к сети, и большинство из них поддерживает управление редстоуном, что позволяет взаимодействовать с другими модами через хранилище.

• Канал пространственной сети: Открывает доступ ко всему содержимому хранилища Пространственной сети. Позволяет вводить/выводить через трубы, воронки, шины хранения AE2/RS и улучшения разгрузки Sophisticated Backpack.
• Энергетический канал пространственной сети: Работает почти так же, как Канал сети, но предназначен для передачи энергии FE. Его интерфейс показывает текущий поток энергии FE. Поддерживает «Режим выброса», выводящий FE в соседние блоки со скоростью 2,1 миллиарда FE/тик.
• Сетевой интерфейс: Аналог ME Interface. Имеет «Слоты шаблонов» и «Слоты хранения». Пытается вставлять хранимые ресурсы в сеть и извлекать ресурсы из сети, отмеченные в слотах шаблонов. Поддерживает Режим выброса.
• Сетевая помпа: Активно вытягивает ресурсы из соседних контейнеров и помещает их в Пространственную сеть. Имеет слоты фильтров с поддержкой режимов чёрного/белого списка.
• Сетевая воронка: Поглощает nearby сущности предметов и даже текущие жидкости, помещая их напрямую в сеть. Её радиус действия настраивается (от 2 блоков до целого чанка). При больших радиусах интервал работы увеличивается. Имеет слоты фильтров с поддержкой чёрного/белого списка.
• Сетевая печь: Позволяет отмечать рецепты (вход и топливо). Автоматически вытягивает отмеченные ресурсы из сети для переплавки. Поддерживает FE или лаву в качестве топлива. Готовую продукцию можно выбрасывать в соседние контейнеры или возвращать в сеть.
• Сетевой кормилец: Когда голод игрока опускается ниже заданного порога, он кормит игрока едой, отмеченной в сети. Не расходует «бесконечную» еду вроде Neverending Bacon или Eternal Steak. Надевается в слот Charm из Curios.
• Сетевой магнит: Аналог Сетевой воронки, но портативный. Поглощает сущности предметов с большей частотой, чем воронка. Имеет горячую клавишу для включения/выключения. Надевается в слот Charm из Curios.
• Быстрая передача предмета из основной руки: Нажмите средней кнопкой мыши по блоку, чтобы мгновенно извлечь стак предметов того типа, который держите в руке, из сети. Присядьте + средняя кнопка мыши, чтобы положить предмет(ы) из руки обратно в сеть. Эту привязку клавиш можно настроить.

Интеграция с модами и поддержка

• Поддерживает перетаскивание для отметки призрачных ингредиентов и быстрый перенос рецептов в JEI/EMI.
• Отметка призрачных ингредиентов в JEI/EMI распознаёт предметы, хранящиеся в AE2 Generic Stack.
• Добавляет AE2 Dimensional ME Storage Cell для чтения содержимого привязанной сети. Обеспечивает более чем в 10 раз higher performance по сравнению с использованием Storage Buses.
• Поддерживает хранение химикатов из Mekanism.
• Сетка крафта поддерживает мод Polymorph.
• Portable Network Terminal можно экипировать в слот Charm из Curios. Установка Beyond Dimensions вместе с Curios добавляет дополнительный слот Charm.
• Поддержка KubeJS: предоставляет классы, позволяющие настраивать логику создания сети, начальную вместимость, способы расширения и прямое управление хранилищем.
• Отключает мод Inventory Profiles Next (IPN) внутри GUI мода из-за значительных изменений интерфейса, делающих их несовместимыми. Для быстрого переноса используйте Mouse Tweaks.

Разработка аддонов и помощь по кастомизации через KubeJS

Разработка аддонов

Добавление новых типов хранимых ресурсов в коде не составляет труда. Реализуйте следующие интерфейсы и зарегистрируйте тип ресурса вместе с соответствующими обработчиками:

1. IStackType — позволяет моду распознавать и хранить этот тип ресурса.
2. IStackHandlerWrapper — позволяет моду программно взаимодействовать с контейнерами/блоками мода, содержащими этот ресурс.
3. CapabilityHelper.BlockCapabilityMap — позволяет другим модам получать доступ к этому типу ресурса через трубы/Storage Buses из блоков.
4. CapabilityHelper.ItemCapabilityMap — включает быстрое взаимодействие со слотом контейнера (средний клик) для предметов, содержащих этот ресурс.
5. UnifiedStorage.typedHandlerMap — позволяет основному хранилищу Dimensional Network управлять этим ресурсом.
6. StackTypedHandler.typedHandlerMap — позволяет периферийным блокам (например, Network Interfaces) управлять этим ресурсом в своих внутренних слотах.

Особая совместимость с AE2, даже если пропущена, не мешает использованию storage buses для чтения.: 7. AEHelper.ISTACK_TO_AEKEY_MAP — сопоставляет объекты ресурсов Beyond Dimensions с ключами AE2 (для чтения Dimensional ME Storage Cell). 8. AEHelper.AEKEY_TO_STACK_TYPE_MAP — сопоставляет ключи AE2 обратно с типами ресурсов Beyond Dimensions (для операций Dimensional ME Storage Cell).

Примеры реализации смотрите в основном файле регистрации мода (BeyondDimensions.java). Примечание: детали регистрации могут измениться в будущих версиях.

Помощь по кастомизации через KubeJS

Чтобы настроить вместимость сети:

1. Отключите стандартный рецепт Dimensional Network Generator.
2. Используйте предоставленные классы/методы, доступные через KubeJS, чтобы реализовать свою логику создания и расширения сети.

Кроме того, мод открывает некоторые другие классы для KubeJS. Подробности смотрите здесь.

Класс UnifiedStorage также содержит немало других методов, позволяющих напрямую изменять содержимое хранилища игрока.

API мода поставляется с полными комментариями на китайском. Ознакомьтесь с ними здесь.

Прочая информация

Тестирование производительности

Тесты охватывали три сценария на одной и той же машине при одинаковых фоновых условиях с использованием мода Spark. Во всех тестах использовалось 1319 случайно сгенерированных уникальных предметов.

1. Отдельный Beyond Dimensions: Предметы хранятся/изменяются через Beyond Dimensions. Ввод/вывод через трубы Mekanism.
2. Beyond Dimensions через ячейку хранения AE2: Сеть подключена к AE2 через Dimensional ME Storage Cell. Ввод/вывод через трубы Mekanism.
3. Нативное хранилище AE2: Предметы хранятся на стандартных дисках AE2 (21 x 64k Storage Cells). Ввод/вывод через трубы Mekanism.

Примечание: В сценарии 1 используются блоки Beyond Dimensions (Dimensional Network Pathway, Network Interface) и отражается основная производительность мода. В сценариях 2 и 3 используются идентичные конфигурации AE2 (Export Bus, ME Interface, бесконечные каналы), отличающиеся только источником хранения, что позволяет провести прямое сравнение.

Результаты:

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

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

• Изменение максимальной вместимости ванильного хранилища предметов/жидкостей на 64-битные целые числа (выполнено).
• Хранение опыта (XP) и утилиты для работы с ним.
• Хранение Source из Ars Nouveau и утилиты для работы с ним.
• Специализированный компонент хранения для Refined Storage (RS).
• Добавление механик прогрессии (изначально даётся ограниченное хранилище, которое требуется расширять).
• Больше утилит и инструментов автоматизации.
• Дополнительные полезные предметы и снаряжение.

Поддерживаемые версии

Поддержка других версий Minecraft не планируется до тех пор, пока текущий план развития для поддерживаемых версий не будет в значительной степени выполнен.