RPG Inventory

RPG Inventory

Добавляет новый экран инвентаря с дополнительными слотами для экипировки и другими механиками, связанными с экипировкой.

Расширенный экран инвентаря

Расширенный экран инвентаря — самая заметная функция этого мода.

Однако его можно отключить в конфиге сервера. Это также отключит все остальные функции, которые от него зависят.

Новые слоты для экипировки

Эти новые слоты для экипировки работают так же, как и существующие четыре слота для брони.

Все слоты можно настроить по отдельности. Эти параметры включают:

• включён ли слот
• виден ли слот
• можно ли вручную класть предметы в слот
• можно ли вручную доставать предметы из слота
• положение слота

Новые слоты, доступные в инвентаре:

• 1 слот для пояса
• 1 слот для ожерелья
• 2 слота для колец (второй отключён по умолчанию)
• 1 слот для перчаток
• 1 слот для наплечников
• 1 слот для реликвии
• 1 слот для классового предмета (по умолчанию не виден и недоступен для ручного взаимодействия)

«Заклинательные» слоты

Также есть 8 «заклинательных» слотов, которыми напрямую управляет атрибут сущности «rpginventory:active_spell_slot_amount». Его значение определяет, сколько слотов включено.

Опция конфига сервера «default_spell_slot_amount» управляет количеством заклинательных слотов, активных у каждого игрока по умолчанию.

Заклинательные слоты изначально были задуманы для использования с книгами заклинаний на базе Spell Engine, но они работают и с другими предметами.

Переработка слотов для рук

Это расширение существующего слота для второй руки. Новый «слот для руки» «заменяет» текущий выбранный слот хотбара.

Предметы в обоих слотах для рук можно «убрать в ножны» (нажатием горячей клавиши), что снова даёт доступ к слотам хотбара. При повторном нажатии предметы извлекаются из ножен.

Предметы в ножнах отображаются на модели игрока. Точное положение можно настроить в клиентском конфиге, а предметы из тегов предметов «rpginventory:not_shown_when_in_sheathed_hand» и «rpginventory:not_shown_when_in_sheathed_offhand» не отображаются, когда находятся в этих слотах.

Ванильная горячая клавиша «Swap Hands» отключена, пока активна Переработка слотов для рук. Обмен предметов инвентаря на хотбар с помощью цифровых клавиш по-прежнему работает.

Двуручная стойка

Это особый случай, когда в ножны убрана только вторая рука. Это приводит к уникальной ситуации, когда слот основной руки занят, а слот второй руки пуст. Двуручную стойку можно переключить нажатием горячей клавиши. Это невозможно, если предмет в слоте основной руки находится в теге предметов «rpginventory:non_two_handed_items».

Двуручная стойка сама по себе не включает новые функции, но такие моды, как Better Combat Extension, могут её использовать.

Предметы для пустой руки

Когда рука не убрана в ножны, но соответствующий слот не содержит предмета, рука игрока не пуста. Вместо этого удерживается предмет из соответствующего «слота для пустой руки».

Слоты для пустой руки всегда содержат предмет под названием «Empty Hand Weapon». Технически это оружие. Если установлен Better Combat, это позволяет вести бой без оружия.

Альтернативные слоты для рук

Эти два слота могут содержать те же предметы, что и обычные слоты для рук, но удерживаемые предметы не считаются «экипированными» (модификаторы атрибутов/зачарования и т. д. не действуют).

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

Технические слоты для экипировки

Механики Переработки слотов для рук используют различные «скрытые» слоты для экипировки:

• 1 слот для руки в ножнах
• 1 слот для второй руки в ножнах
• 1 слот для пустой руки
• 1 слот для пустой второй руки
• 1 альтернативный слот для руки
• 1 альтернативный слот для второй руки

Дополнительные настройки горячих клавиш

Все действия горячих клавиш Hand Slot Overhaul имеют настраиваемые дополнительные эффекты:

• применение перезарядки к предметам в соответствующем слоте
• требования/затраты выносливости (если установлен Stamina Attributes)

Экран эффектов состояния

Активные и видимые эффекты состояния отображаются в правой части экрана инвентаря. Они сортируются по категории (вредные, полезные и нейтральные). У эффектов может быть описание (добавляется путём присвоения значения <effect_translation_key>.description в языковых файлах), которое также отображается.

Эффекты в теге эффектов "rpginventory:food_effects" отображаются в отдельном списке.

Подсказки слотов

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

Дополнительные настройки и функции

Сетку крафта 2x2 в инвентаре игрока можно отключить.

Дополнительные функции

Эти функции работают независимо от Expanded Inventory Screen.

Предметы, заблокированные достижениями

Стек предметов с компонентом "rpginventory:advancement_locked" имеет один из 3 различных режимов 'status', который сохраняется в компоненте.

Различные режимы:

• 'not_unlocked'
• 'unlocked', у него самый низкий приоритет. Предмет можно экипировать и использовать, только если он находится в этом режиме.
• 'locked', у него самый высокий приоритет

Компонент "advancement_locked" имеет 5 строковых полей:

• "unlock_advancement": id 'достижения разблокировки'. Если у игрока открыто это достижение, статус меняется на 'unlocked', если нет — статус 'not_unlocked'. Если это поле — пустая строка, предмет не может быть 'not_unlocked'.

• "lock_advancement": id 'достижения блокировки'. Если у игрока открыто это достижение, статус — 'locked'. Если это поле — пустая строка, предмет не может быть 'locked'.

• "not_unlocked_tooltip_text": эта строка опционально отображается в подсказке предмета, когда статус предмета — 'not_unlocked'. Поддерживает локализацию.
• "tooltip_text": эта строка опционально отображается в подсказке предмета, когда статус предмета — 'not_unlocked'. Поддерживает локализацию.
• "locked_tooltip_text": эта строка опционально отображается в подсказке предмета, когда статус предмета — 'not_unlocked'. Поддерживает локализацию.

Слоты инвентаря, содержащие предмет с режимами статуса 'not_unlocked' или 'locked', могут опционально отображать наложение на слот.

Эксклюзивная экипировка

Предметы экипировки могут быть частью нескольких "групп эксклюзивной экипировки", которые определяются как строки, сохранённые в компоненте данных "rpginventory:exclusive_equipment". Каждая группа может присутствовать только на одном надетом предмете одновременно. Если группа обнаружена на дополнительных предметах, эти предметы либо перемещаются в обычный инвентарь, либо выбрасываются на землю.

Предметы, созданные игроком

Стеки предметов с компонентом "rpginventory:saves_crafting_player" сохраняют игрока, который их создал. Этот игрок затем отображается строкой в подсказке предмета (можно отключить в клиентском конфиге).

Это чисто косметическая функция.

Предметы, привязанные к игроку

Предметы можно привязать к игроку. Привязанные к игроку предметы может использовать только этот игрок. У привязанных к игроку предметов есть дополнительная строка подсказки, показывающая имя игрока. (Можно отключить в клиентском конфиге)

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

Как привязать предмет к игроку

Если стек предметов имеет компонент "rpginventory:bounds_to_player", стек предметов привяжется к игроку, когда будет помещён в инвентарь игрока. В этот момент компонент "rpginventory:bounds_to_player" будет удалён, а вместо него добавлен компонент "rpginventory:player_bound". Этот компонент сохраняет профиль игрока.

Ограниченные изменения экипировки

Настройка сервера "allow_equipment_changes" управляет тем, можно ли класть предметы в слоты экипировки или убирать их оттуда.

Когда у игрока есть эффект статуса "rpginventory:civilisation", предметы можно класть в слоты экипировки или убирать их оттуда независимо от настройки конфига.

Когда у игрока есть эффект статуса "rpginventory:wilderness", предметы нельзя класть в слоты экипировки или убирать их оттуда независимо от настройки конфига.

Стеки предметов с компонентом данных "rpginventory:ignores_equipment_change_restrictions" игнорируют эти ограничения.

Неиспользуемые предметы

Предметы в теге предметов "unusable_when_low_durability" или с компонентом данных "rpginventory:unusable_when_low_durability" ведут себя так же, как элитры. Вместо того чтобы уничтожаться при потере всей прочности, они становятся неиспользуемыми, пока их не починят. У неиспользуемых предметов другой ключ перевода (обычный + "_broken").

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

Манекены и предметы снаряжения

Манекены — это блоки, у которых есть слоты хранения, похожие на слоты экипировки игроков. Предметы, помещённые в эти слоты, образуют «снаряжение», которое игроки могут надеть. Надевание снаряжения заполняет слоты экипировки игрока копиями предметов снаряжения. Заполняются только пустые слоты или слоты, содержащие предмет снаряжения.

Изменение и/или надевание предметов снаряжения можно отключить для игроков не в творческом режиме с помощью данных блок-энтити.

Предметы снаряжения

В зависимости от настройки серверного конфига к предметам снаряжения применяется либо компонент данных "rpginventory:is_destroyed_on_death", либо "rpginventory:is_kept_on_death".

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

Дополнительные подсказки предметов

Их можно настроить в клиентском конфиге, включая позицию.

• предметы снаряжения
• предметы, привязанные к игроку (отключено для предметов снаряжения)
• предметы, созданные игроком (отключено для предметов снаряжения)
• предметы, заблокированные достижением (отключено для предметов снаряжения)
• находится ли предмет в теге предметов "two_handed_items".
• слоты, в которые предмет можно экипировать; это управляется тегами предметов.

Смерти в PVP

Когда здоровье игрока с эффектом статуса "rpginventory:pvp" достигает нуля, он не умирает, а вместо этого срабатывает эта функция.

Эффекты включают:

• удаление всех эффектов статуса (кроме эффекта pvp и всех записей тега эффектов статуса "rpginventory:kept_on_pvp_death")
• сброс ресурсов игрока (здоровье, мана, выносливость и т. д.)
• уменьшение усилителя «эффекта pvp» на единицу

• если новый усилитель больше или равен нулю:

  • телепортация игрока в определённое место (по умолчанию точка возрождения/мировая точка возрождения; меняется на «позицию доступа к местоположению» Script Blocks, когда он установлен)

• если новый усилитель меньше нуля:

  • телепортация игрока в его точку возрождения/мировую точку возрождения

Изменения инвентаря при смерти

RPG Inventory добавляет несколько механик, влияющих на то, что происходит с предметами в инвентаре игрока, когда игрок умирает.

Когда ванильное игровое правило "keep_inventory" установлено в true, все предметы сохраняются.

Эффект статуса "rpginventory:keep_inventory" применяется, когда экипирован предмет из тега предметов "sacrificed_to_keep_inventory_on_death" (в слоте экипировки, аксессуара или во второй руке).

Когда игрок умирает, имея этот эффект статуса, все экипированные предметы из тега предметов "sacrificed_to_keep_inventory_on_death" уничтожаются. Остальной инвентарь сохраняется независимо от игровых правил и всякого вроде «Проклятия исчезновения».

Ванильное зачарование «Проклятие исчезновения» применяется только тогда, когда ни один предмет не был пожертвован для сохранения инвентаря.

Оставшиеся предметы сохраняются при следующих условиях:

• у них есть компонент "rpginventory:is_kept_on_death"
• они находятся в теге предметов "rpginventory:empty_hand_weapons"

Предметы, которые не сохраняются, уничтожаются при следующих условиях:

• параметр серверного конфига "destroy_dropped_items_on_death" установлен в true
• у них есть компонент "rpginventory:is_destroyed_on_death"

Оставшиеся предметы выпадают как обычно.

Эффекты статуса

Когда "building_mode_status_effect_identifier" является допустимым идентификатором эффекта статуса и у игрока есть этот эффект статуса, несколько механик игнорируются.

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

Интеграции и совместимость с другими модами

Атрибут рюкзака

Кнопка, открывающая экран рюкзака, может быть добавлена на экраны инвентаря. Сетка крафта 2x2 должна быть отключена.

Атрибуты размера инвентаря

Хотбар в HUD можно настроить так, чтобы отображались только включённые слоты хотбара.

Spell Engine (только 1.21.1)

API эффектов статуса Spell Engine используется для нескольких механик, которые применяют к игроку "скрытые эффекты статуса" при выполнении определённых условий.

• когда предмет в основной руке находится в теге предметов "rpginventory:two_handed_items", а слот второй руки не пуст/не убран, игрок не может атаковать, использовать предмет или применять заклинания.
• когда предмет в основной руке не находится в теге предметов "rpginventory:attack_items" и параметр серверного конфига 'allow_attacking_with_non_attack_items' установлен в false, игрок не может атаковать.

Экран атрибутов игрока (только 1.21.1)

Когда установлен мод "Player Attribute Screen", на экране RPG Inventory активна кнопка переключения экрана атрибутов.

RPG Crafting (только 1.21.1)

Кнопка, открывающая экран ручного крафта, может быть добавлена на экраны инвентаря. Сетка крафта 2x2 должна быть отключена.

Numismatic Overhaul (только 1.21.1)

Виджет кошелька отображается на экране RPG Inventory.

Trinkets (только 1.21.1)

Слоты безделушек отображаются на экране RPG Inventory.

У всех слотов безделушек есть всплывающая подсказка. Её можно задать в языковом файле по этой схеме:

{
    "slot.tooltip.<group_name>.<slot_name>": "Test Slot"
}

Когда строка пустая, всплывающая подсказка не отображается.