Zap's Enhanced Enchantment Glints

ZEEG — Zap's Enhanced Enchantment Glints

Лёгкий клиентский мод для Fabric, который позволяет динамически настраивать блеск зачарований без ресурспаков.

Возможности

• Выбор цвета: задайте любое значение RGB или Hex

• Несколько режимов цикла:

  • Статичный: один сплошной пользовательский цвет.
  • Радуга: плавный цикл по спектру.
  • Двухцветный: плавный переход между двумя пользовательскими цветами.
• Переопределения для отдельных предметов: назначайте уникальные цвета блеска конкретным предметам (например, зелёный для незеритового меча, красный для лука).
• Переопределения по имени: динамически окрашивайте блеск в зависимости от имени предмета, переименованного на наковальне.
• Конфиги ресурспаков: создатели паков могут задавать стандартные конфигурации блеска через свои ресурспаки.
• Интуитивный интерфейс: удобный экран настроек, доступный прямо через Mod Menu.
• Нативная интеграция: совместим со встроенными настройками силы и скорости блеска в игре.
• Совместимость с модами: работает с любыми модовыми предметами.
• Удобство для разработчиков и датапаков: предоставляет пользовательский компонент данных zeeg:glint, позволяя другим модам, датапакам и команде /give легко задавать пользовательские свойства блеска любому предмету.

Поддержка версий и ветки

ZEEG поддерживает несколько версий Minecraft:

• 1.21.11
• 26.1.x
• 26.2.x

Использование

1. Установите ZEEG на Fabric (требуется Fabric API и Mod Menu).
2. Откройте Mod Menu -> ZEEG -> Configure.
3. Настройте цвета, скорости, переопределения или режимы цикла.
4. Нажмите Save & Reload, чтобы применить изменения сразу в игре.

Использование в ресурспаках

Создатели ресурспаков могут включать в свои паки стандартные пресеты конфигурации, переопределения для отдельных предметов или переопределения по именам. ZEEG автоматически обнаружит и загрузит эти конфиги, если эта функция включена.

Создайте JSON-файл с именем config.zg в вашем ресурспаке по пути: assets/zeeg/config.zg

Пример структуры config.zg:

{
  "red": 0,
  "green": 255,
  "blue": 128,
  "strength": 255,
  "cycleMode": 1,
  "rainbowSpeed": 25,
  "itemColors": [
    {
      "itemId": "minecraft:netherite_sword",
      "red": 255,
      "green": 0,
      "blue": 0
    }
  ],
  "namedColors": [
    {
      "name": "Excalibur",
      "red": 255,
      "green": 215,
      "blue": 0,
      "strength": 255,
      "cycleMode": 2,
      "red2": 255,
      "green2": 255,
      "blue2": 255
    }
  ]
}

Использование команд

Вы можете использовать команду /give, чтобы получить предметы с заранее настроенным пользовательским блеском, указав компонент данных zeeg:glint.

Форматы:

• Пользовательский блеск при зачаровании:

  /give @s minecraft:diamond_sword[zeeg:glint={r:255,g:255,b:0}]

• Радужный блеск:

  /give @s minecraft:diamond_sword[zeeg:glint={cycle_mode:1,speed:50}]

• Двухцветный блеск: плавный переход между красным и синим:

  /give @s minecraft:diamond_sword[zeeg:glint={cycle_mode:2,r:255,g:0,b:0,r2:0,g2:0,b2:255,speed:30}]

Доступные поля компонента:

• r, g, b (целое 0-255): основной цвет RGB (по умолчанию: 255).
• strength (целое 0-255): непрозрачность/сила блеска (по умолчанию: 255).
• cycle_mode (целое 0-2): 0 = статичный, 1 = радуга, 2 = двухцветный (по умолчанию: 0).
• speed (целое 1-100): скорость смены цикла (по умолчанию: 25).
• r2, g2, b2 (целое 0-255): вторичный целевой цвет RGB для двухцветного режима (по умолчанию: 255).

Использование в датапаках

Создатели датапаков могут использовать компонент zeeg:glint в таблицах добычи, результатах пользовательских рецептов или наградах за достижения.

Пример предмета в таблице добычи:

{
  "type": "minecraft:item",
  "name": "minecraft:netherite_sword",
  "functions": [
    {
      "function": "minecraft:set_components",
      "components": {
        "minecraft:enchantment_glint_override": true,
        "zeeg:glint": {
          "r": 255,
          "g": 0,
          "b": 0,
          "cycle_mode": 2,
          "r2": 255,
          "g2": 128,
          "b2": 0,
          "speed": 15
        }
      }
    }
  ]
}

## Использование мода

Разработчики модов могут читать и изменять компоненты блеска прямо на экземплярах `ItemStack` с помощью API.

### Получение данных блеска:
```java
import com.zapaxe.zeeg.GlintComponent;

GlintComponent glint = stack.get(GlintComponent.TYPE);
if (glint != null) {
    int red = glint.r();
    int green = glint.g();
    int blue = glint.b();
}

Применение данных блеска:

import com.zapaxe.zeeg.GlintComponent;

// Параметры: r, g, b, strength, cycleMode, speed, r2, g2, b2
GlintComponent customGlint = new GlintComponent(255, 0, 255, 255, 1, 20, 255, 255, 255);
stack.set(GlintComponent.TYPE, customGlint);