Advanced Memory Card

Advanced Memory Card

Дополнение к Applied Energistics 2 (AE2), которое прокачивает Memory Card из AE2 двумя крупными функциями: массовым копированием конфигураций и продвинутым управлением P2P-туннелями.

🌟 Возможности

🔧 Два рабочих режима

Мод хранит своё состояние как «режим» в NBT предмета, и вы можете переключаться между ними в любой момент:

📋 Режим копирования

• Массовое копирование области: Сначала скопируйте конфигурацию одного устройства AE2, затем выберите два противоположных угловых блока, чтобы задать область, и нажмите ПКМ по воздуху, чтобы применить конфигурацию массово.
• Поддержка блоков и частей AE2: Обрабатывается каждый AEBaseBlockEntity (ME-контроллеры, интерфейсы, шины хранения и т. д.) и каждая часть на IPartHost внутри области.
• Защита от превышения объёма: Если объём области превышает серверный конфиг maxCopyVolume (по умолчанию 2048 блоков), вставка отклоняется с сообщением, чтобы предотвратить случайный выбор слишком большой области и лаги.
• Визуальная рамка выделения: Выделение окрашивается в реальном времени (красный = выбор первой точки / белый = выбор второй точки / зелёный = готово к вставке), с отдельными цветами для блока под прицелом и блоков вне зоны действия.
• Обратная связь в реальном времени: Подсказка предмета и строка чата показывают отмеченные координаты, размер области и количество вставленных блоков.

🕸 Режим настройки (настройка P2P-туннелей)

Нажмите ПКМ по любой части P2P-туннеля, чтобы открыть GUI настройки и визуально управлять всеми P2P-устройствами в текущей сети AE:

• Список P2P-дерева: Автоматически сканирует сеть и отображает все P2P-устройства, сгруппированные по типу / каналу, с разворачиванием/сворачиванием и поиском с фильтрацией.
• Панель деталей: При выборе узла показываются его тип, частота, роль входа/выхода, статус подключения и другое.
• Переименование / псевдоним: Задайте своё имя для отдельного P2P-устройства или псевдоним для целого канала (входной стороны канала) для удобной идентификации.
• Привязка частоты: Привяжите выбранный P2P к конкретной 4-значной шестнадцатеричной частоте (например, 0A1B). Не-ME P2P автоматически и разумно определяют свою роль входа/выхода.
• Назначение нового канала: Назначьте выбранному не-ME P2P совершенно новую свободную частоту и одним кликом сделайте его входной стороной.
• Автонастройка входа/выхода (только ME P2P): Автоматически решает, должен ли ME P2P работать как вход или выход, в зависимости от того, подключена ли его внешняя сеть к ME-контроллеру, и назначает частоту автоматически.
• Подсветка и поиск: Подсвечивает P2P-туннели в мире (свой / вход / выход отображаются разными цветами), опционально автоматически поворачивает голову к цели и отправляет информацию о местоположении и ссылку для телепортации в строку чата.
• Связи между измерениями: Исправляет ванильную проблему, когда клиент отправлял только координаты, из-за чего кросс-измеренческие P2P было невозможно найти. Теперь кодировка несёт информацию об измерении, что позволяет корректно находить и подсвечивать P2P-устройства между измерениями.

⌨️ Переключение режимов

• Клавиша V (по умолчанию, переназначается в настройках управления игры) — нажмите, держа Advanced Memory Card, чтобы переключить режимы.
• Shift + ПКМ — быстрое переключение между двумя режимами (в режиме копирования Shift + ПКМ выполняет нативное действие копирования AE2 вместо переключения).

📦 Установка

Требования

Мод также зависит от Jade, GuideME и JEI во время работы (распространённые аддоны экосистемы AE2; их установка рекомендуется для лучшего опыта).

Шаги

1. Скачай последний `advanced_memory_card-.jar` со страницы релизов.
2. Помести .jar файл в папку mods Minecraft.
3. Убедись, что необходимые моды выше установлены.
4. Запусти игру и найди предмет во вкладке креатива "Advanced Memory Card".

🛠 Конфигурация

Мод предоставляет как клиентский, так и серверный файлы конфигурации (расположены в директории config/):

Серверная конфигурация (advanced_memory_card-server.toml)

Клиентская конфигурация (advanced_memory_card-client.toml)

В основном используется для персонализации интерфейса и внешнего вида отрисовки. Можно настроить:

• Поведение подсветки: rotateHeadOnHighlight (автоповорот головы при подсветке), p2pHighlightDurationSec (длительность подсветки, 1–60 секунд).
• Виджет дерева P2P: цвета фона / выбранного / наведения, отступ, высота строки, расстояние между иконками, порог предупреждения о канале, максимальная длина имени и т.д.
• Панель деталей: фон, заголовок, метка, значение и цвета статуса (не активен / не подключён / подключён) и размеры макета.
• Обычные кнопки (FlatButton): цвета по умолчанию / при наведении / при нажатии / текста.
• Рамка выделения режима копирования: цвета для начальной точки, конечной точки, целевой точки, выхода за пределы и трёх состояний выделения.
• Отрисовка подсветки P2P: цвета для себя / входа / выхода.
• Цвет предмета: базовый цвет предмета и цвет оттенка.

Все цвета — шестнадцатеричные значения (ARGB для классов GUI, RGB для классов отрисовки) и могут быть отредактированы напрямую в файлах конфигурации.

📖 Краткое руководство по использованию

Режим копирования

1. Держи Advanced Memory Card в режиме копирования и Shift + ПКМ по исходному AE2-устройству, чтобы скопировать его конфигурацию.
2. ПКМ по первому угловому блоку, чтобы отметить начальную точку (красная).
3. ПКМ по противоположному угловому блоку, чтобы отметить конечную точку (белая); теперь он переходит в состояние готовности к вставке (зелёное).
4. ПКМ по воздуху, чтобы применить конфигурацию массово ко всем AE2-устройствам в регионе.

Режим конфигурации

1. Переключись в режим конфигурации и ПКМ по любой части P2P-туннеля, чтобы открыть GUI конфигурации.
2. Просматривай / ищи P2P в сети в левом дереве и выбери узел, чтобы просмотреть его детали справа.
3. Используй кнопки панели деталей для переименования, привязки частоты, назначения нового канала, автонастройки входа/выхода, подсветки и локации и многого другого.

🔧 Разработка и сборка (для разработчиков)

# Запустить клиент (среда разработки)
./gradlew runClient

# Собрать релизный jar
./gradlew build

# Сгенерировать датапаки / языковые файлы
./gradlew runData

*   Собран на Forge Gradle 6.x с тулчейном Java 17.
*   Использует Mixin (`advanced_memory_card.mixins.json`) для расширения `P2PTunnelPart` из AE2.
*   Ресурсные файлы создаются генераторами данных в `src/main/java/.../datagen` в `src/generated/resources/`.

## 📄 Лицензия

Этот проект имеет открытый исходный код под лицензией [GNU GPL-3.0](LICENSE.txt).