VaultLootBeams

Vault Loot Beams

Форк популярного мода Loot Beams, изменённый специально для модпака VaultHunters 3rd Edition. Учтите, что многие «новые» функции этого мода были перенесены из оригинального Loot Beams для более новых версий игры. Поэтому я не могу приписывать эти функции полностью себе, даже если я изменил или переписал их реализацию для этого форка.

Возможности

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 — Карта id к [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 — Должна ли табличка имени отрисовывать ванильные редкости предметов, по умолчанию отключено.
• 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.
• Mod Id — нацелен на все предметы в указанном моде, например 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 в конфиг по умолчанию.

   • Добавляет в белый список всю броню vault, предметы в основной руке, во второй руке и curios.
   • Добавляет в белый список gemstones, keypieces, blank keys, unidentified keys, knowledge stars и antiques.
   • Предоставляет цвета для artifacts, inscriptions, lost bounty, old notes, bounty pearls, catalysts, card deck, pogs, всех treasure keys и всех seals.

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

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