VaultLootBeams [1.18.2]

Vault Loot Beams

Форк популярного мода Loot Beams, модифицированный специально для модпака VaultHunters 3rd Edition.

Функции

Loot Beams

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

Требования к отрисовке

• Render Distance - Расстояние, на котором будет отображаться луч добычи. Принимает значения 0-1024 блоков, по умолчанию 24.
• Require Ground - Если включено, луч добычи будет отображаться только если предмет находится на земле, а не в воздухе.
• Whitelist Color Overrides - Если включено, предметы с переопределением цвета автоматически считаются включенными в белый список для отрисовки.
• Render Condition - ItemCondition для автоматического определения, должен ли предмет отображать луч. По умолчанию Lists Only.
• Render Whitelist - ItemList для предметов, которые всегда должны отображать луч добычи.
• Render Blacklist - ItemList для предметов, которые никогда не должны отображать луч добычи. (Это переопределяет белый список.)

Свойства отрисовки

• Beam Radius - Радиус луча добычи, принимает 0-5, по умолчанию 1.
• Beam Height - Высота луча добычи, максимум 10, по умолчанию 2.
• Beam Y Offset - Вертикальное смещение луча добычи, максимум 10, по умолчанию 0.
• Beam Alpha - Прозрачность луча добычи, принимает 0-1, по умолчанию 0.7.
• White Beam Center - Должен ли луч иметь дополнительный внутренний белый луч, включено по умолчанию.
• Beam Shadow - Должен ли луч иметь цветную тень (заменяет стандартную тень предмета), включено по умолчанию.
• Shadow Radius - Радиус тени, принимает 0.00001-1, по умолчанию 0.5.
• Shadow Alpha Multiplier - Множитель прозрачности тени, тень наследует прозрачность луча и умножается на этот коэффициент, принимает 0.00001-3, по умолчанию 1.
• Animate Shadow - Должна ли тень анимироваться вместе с покачиванием предмета, включено по умолчанию.
• Beam Render Mode - Режим отрисовки луча добычи, может быть установлен в:
  • Glowing - Луч будет отображаться "как" молния, заставляя его светиться (эмиссивно) и хорошо работать с шейдерами. Это режим отрисовки по умолчанию.
  • Beacon - Луч будет иметь текстуру, подобную маяку, если вы использовали оригинальный мод Loot Beams, так всегда отображались лучи.
  • Solid - Луч будет использовать сплошные цвета.
• Beam Color Mode - Режим цвета по умолчанию для лучей добычи, любой предмет, который не предоставляет цвет луча добычи и не имеет настроенного цвета, будет иметь цвет, определенный этим режимом:
  • Default - Статический белый цвет.
  • Name Color - Берет цвет названия предмета.
  • Rarity Color - Берет цвет редкости предмета.
  • Name or Rarity Color - Если присутствует, использует цвет названия, в противном случае использует редкость. (по умолчанию)
• Color Overrides - Карта ColorGroup для предоставления пользовательских цветов для определенных предметов.

ColorGroup

Группа цветов связывает ItemList со списком цветов. Если есть несколько цветов, они будут циклически меняться с помощью градиентного эффекта. Группы цветов могут быть определены несколькими способами:

• Inline - Встроенный список предметов к единственному цвету или массиву цветов.
• Full - Идентификатор для группы цветов с ItemList и списком цветов. Внутри группы цветов вы можете определить цвета следующими способами:
• Integer Color - Один цвет в виде упакованного целого числа
  • Принимает как прямые целые числа 11146495, так и шестнадцатеричные целые числа 0xAA14FF
• Hex Color - Один цвет в виде шестнадцатеричной строки
  • Принимает как "#AA14FF", так и "0xAA14FF"

Пример полной карты:

{
  "color_map": {
    "minecraft:diamond": 0x00FF00, // Один цвет для одного предмета
    "minecraft:*_axe": ["#FF0000", "0x00FF00"], // Несколько цветов для частичного идентификатора предмета
    "favorites": { // Полная группа цветов со списком предметов и встроенным цветом
      "items": [
        "minecraft:diamond",
        "minecraft:*_sword",
        "minecraft:netherite_ingot"
      ],
      "colors": 0xFFFF00
    },
    "other_favorites": { // Полная группа цветов со списком предметов и несколькими цветами
      "items": [
        "minecraft:golden_apple",
        "minecraft:enchanted_golden_apple"
      ],
      "colors": ["#FF00FF", "#00FFFF"]
    }
  }
}

Частицы луча добычи

• Beam Particles - Должен ли луч добычи иметь частицы, включено по умолчанию.
• Particle Groups - Карта идентификаторов в ParticleGroup, определяющая эффекты частиц для лучей добычи определенных предметов.

ParticleGroup

• Particle Size - Размер частиц, принимает 0.00001-10, по умолчанию 0.25.
• Particle Speed - Скорость частиц, принимает 0.00001-10, по умолчанию 0.1.
• Particle Spread - Начальное рассеивание частиц, принимает 0.00001-10, по умолчанию 0.05.
• Particle Count - Количество частиц, появляющихся каждую секунду, принимает 1-20, по умолчанию 19.
• Particle Lifetime - Время жизни частиц в тиках, принимает 1-100, по умолчанию 20, по мере старения частицы ее прозрачность будет уменьшаться до тех пор, пока она не исчезнет.
• Particle Condition - ItemCondition для автоматического определения, должен ли предмет иметь частицы. По умолчанию Lists Only.
• Particle Whitelist - ItemList для предметов, которые всегда должны иметь частицы.
• Particle Blacklist - ItemList для предметов, которые никогда не должны иметь частицы. (Это переопределяет белый список.)

Таблички с названиями луча

Лучи добычи могут дополнительно отображать табличку с названием предмета, показывающую название, его количество (опционально) и редкость (опционально).

• Beam Nameplate - Должны ли лучи добычи отображать таблички с названиями, включено по умолчанию.
• Nameplate on Look - Должна ли табличка с названием отображаться только когда игрок смотрит на предмет/луч, включено по умолчанию.
• Nameplate Look Sensitivity - Насколько близко игрок должен смотреть на предмет, чтобы табличка с названием отображалась, принимает 0-5, по умолчанию 0.018. Чем больше число, тем менее точным может быть игрок.
• Nameplate Outline - Должен ли текст таблички с названием иметь контур, включено по умолчанию.
• Nameplate Include Count - Должна ли табличка с названием включать количество предметов, включено по умолчанию.
• Nameplate Scale - Масштаб таблички с названием, принимает -10-10, по умолчанию 1.
• Nameplate Y Offset - Вертикальное смещение таблички с названием от сущности предмета, принимает -30-30, по умолчанию 0.75.
• Nameplate Text Alpha - Прозрачность текста таблички с названием, принимает 0-1, по умолчанию 1.
• Nameplate Background Alpha - Прозрачность фона таблички с названием, принимает 0-1, по умолчанию 0.5.
• Render Vanilla Rarities - Должна ли табличка с названием отображать редкости предметов vanilla, отключено по умолчанию.
• Custom Nameplate Rarities - Список пользовательских редкостей для отображения, если они обнаружены в подсказке предмета.
• Nameplate Condition - ItemCondition для автоматического определения, должен ли предмет иметь табличку с названием. По умолчанию Lists Only.
• Nameplate Whitelist - ItemList для предметов, которые всегда должны иметь табличку с названием.
• Nameplate Blacklist - ItemList для предметов, которые никогда не должны иметь табличку с названием. (Это переопределяет белый список.)

Звуки луча добычи

• Landing Sound - Должны ли лучи добычи воспроизводить звук при приземлении, отключено по умолчанию.
• Sound Volume - Громкость звука приземления, принимает 0-1, по умолчанию 0.3.
• Sound Condition - ItemCondition для автоматического определения, должен ли предмет воспроизводить звук при приземлении. По умолчанию Lists Only.
• Sound Whitelist - ItemList для предметов, которые всегда должны воспроизводить звук при приземлении.
• Sound Blacklist - ItemList для предметов, которые никогда не должны воспроизводить звук при приземлении. (Это переопределяет белый список.)

LootBeamHolder

Это простой API-интерфейс, который может быть реализован предметами внутри модов для обозначения предмета как держателя луча добычи.
Это позволяет предмету иметь отображаемый луч добычи без необходимости находиться в белом списке отрисовки или проходить условие отрисовки, а также позволяет динамически определять цвет луча на основе свойств предмета.
Интерфейс имеет 2 метода: shouldRenderBeam(ItemEntity, ItemStack) и getBeamColor(ItemEntity, ItemStack).
При желании вы можете зарегистрировать LootBeamHolder через LootBeamHolderRegistry вместо прямой реализации интерфейса.

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

Vault Loot Beams использует файл конфигурации json для настройки своих функций. Вы можете напрямую редактировать файл и перезагружать его в игре с помощью указанной горячей клавиши, или вы можете использовать внутриигровой редактор конфигурации (открывается указанной горячей клавишей) для изменения конфигурации. Есть несколько пользовательских типов опций конфигурации, используемых для нескольких опций конфигурации, подробно описанных ниже.

ItemCondition

Условие, применяемое к предметам, которое будет либо пройдено, либо провалено для соответствующей опции конфигурации.

• Lists Only - Учитывать только предоставленные белый и черный списки.
• All Items - Все предметы проходят.
• Equipment - Экипировка проходит. (Инструменты, Броня, Оружие и т.д.)
• Rare Items - Предметы с редкостью выше Common проходят.
• Rare or Equipment - Предметы, которые проходят Equipment или Rare Items.

ItemList

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

• Идентификатор предмета - Нацеливается на один предмет с предоставленным идентификатором, например minecraft:diamond.
• Частичный идентификатор предмета - Частичный идентификатор, обозначенный *, например minecraft:*_axe, частичные идентификаторы нацеливаются на все предметы в том же пространстве имен, путь которых заканчивается суффиксом после *
• Тег предмета - Нацеливается на все предметы в предоставленном теге, например minecraft:beds.
• Идентификатор мода - Нацеливается на все предметы в предоставленном моде, например minecraft или the_vault.

Интеграция с Vault Hunters

Vault Loot Beams поставляется со встроенной конфигурацией по умолчанию при использовании с модом The Vault. Интеграция делает 2 вещи:

1. Реализует LootBeamHolder для следующих предметов, позволяя использовать динамические цвета на основе свойств предметов
   • Augments, Blessings, Potions, Vault Crystals, Catalysts, Inscriptions, Jewels, и Tools
2. Добавляет ряд предметов и цветов Vault Hunters в конфигурацию по умолчанию.
   • Включает в белый список всю броню, основное оружие, дополнительное оружие и curios из Vault.
   • Включает в белый список gemstones, keypieces, blank keys, unidentified keys, knowledge stars, и antiques.
   • Предоставляет цвета для artifacts, inscriptions, lost bounty, old notes, bounty pearls, catalysts, card deck, pogs, всех treasure keys, и всех seals.

Исправления ошибок и оптимизации

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