Terrastorage

Terrastorage

🟡 ВАЖНО: Известные проблемы совместимости

Версии 1.3.0 и 1.3.1 значительно улучшили совместимость с другими модами на хранение:

• 🟢 Sophisticated Storage & Backpacks: Совместимость в основном стабильна — осталась мелкая проблема с сортировкой и одна с добавлением предметов в избранное, но я не столкнулся ни с чем, что могло бы привести к дублированию или потере предметов.
• 🔴 Traveler's Backpack: Всё ещё есть проблемы, которые могут привести к потере предметов или, по крайней мере, к их временному исчезновению. Пока рекомендую воздержаться от использования Terrastorage вместе с ним.

Спасибо за терпение!

Terrastorage — это настраиваемый серверный и клиентский мод, который переносит потрясающие возможности хранения из Terraria в Minecraft, включая невероятно полезную функцию Quick Stack To Nearby Chests. На данный момент поддерживаются Fabric и Quilt.

Учтите, что Terrastorage нужно установить и на клиент, и на сервер, чтобы всё работало правильно. С этим разобрались, давайте перейдём к обзору возможностей:

Возможности

Loot and Deposit All:

• Loot All — переносит все предметы из хранилища в инвентарь игрока.
• Deposit All — переносит все предметы из инвентаря игрока в хранилище.

⏺️ Предметы сначала складываются в стопки с уже существующими в противоположном инвентаре, прежде чем переместиться в пустой слот.

⏺️ Избранные предметы не затрагиваются функцией Deposit All.

Quick Stack and Restock:

• Quick Stack — переносит предметы из инвентаря игрока в хранилище, используя один из двух режимов:

  • Smart Deposit — похож на Fill Up, но также перемещает все подходящие предметы в пустые слоты, создавая новые стопки по мере необходимости.

  • Fill Up — добавляет предметы в существующие стопки, пока они не достигнут максимальной вместимости, не затрагивая пустые слоты в принимающем инвентаре.
• Restock — переносит предметы из хранилища в существующие стопки в инвентаре игрока.

⏺️ Избранные предметы не затрагиваются функцией Quick Stack.

✳️ Режим Quick Stack можно настроить через опцию Storage Quick Stack Mode в Options Screen.

Item Favoriting:

• Item Favoriting — вы можете добавить предметы в избранное в своём инвентаре, удерживая клавишу-модификатор для Item Favoriting (по умолчанию — Left Alt) и кликая по ним левой кнопкой мыши.

✳️ Клавишу-модификатор можно изменить в меню управления.

⏺️ Избранные предметы защищены от:

• Выбрасывания из инвентаря.
• Shift-переноса в другой инвентарь.
• Обмена из хотбара в другой инвентарь при нажатии привязанной клавиши хотбара.
• Удаления в экране творческого инвентаря.
• Перемещения функциями Deposit All или Sort Inventory.
• Изменения функциями Quick Stack или Quick Stack To Nearby Storages.

Сортировка предметов и переименование:

• Сортировка предметов — сортирует предметы в хранилище.
• Переименование — переименовывает блок хранилища.

✳️ Способ сортировки для Сортировки предметов и Сортировки инвентаря управляется одной настраиваемой опцией.

⏺️ Сортировку предметов также можно активировать, наведя курсор на слот и нажав клавишу сортировки инвентаря (по умолчанию R, настраивается в меню управления).

⏺️ Переименованные блоки хранилищ отображают таблички с именем либо над собой, либо на стороне, обращённой к игроку, если сверху есть блок.

Сортировка инвентаря и быстрый стак в ближайшие хранилища:

• Сортировка инвентаря — сортирует предметы в инвентаре игрока.
• Быстрый стак в ближайшие хранилища — находит все ближайшие хранилища и выполняет операцию быстрого стака для каждого.

✳️ Способ сортировки для Сортировки предметов и Сортировки инвентаря управляется одной настраиваемой опцией.

⏺️ Сортировку инвентаря также можно активировать, наведя курсор на слот и нажав клавишу сортировки инвентаря (по умолчанию R, настраивается в меню управления).

✳️ По умолчанию функция Быстрый стак в ближайшие хранилища учитывает только хранилища в поле зрения игрока, это настраивается.

✳️ Функция Быстрый стак в ближайшие хранилища включает анимацию, в которой предметы летят от игрока к хранилищу. И длительность анимации, и интервал между летящими предметами настраиваются.

⏺️ Избранные предметы не перемещаются при Сортировке инвентаря и не изменяются функцией Быстрый стак в ближайшие хранилища.

Настройка

Клиентская сторона:

На клиентской стороне есть экран настроек, доступный через mod menu или командой /tsclient options, он позволяет настроить следующие параметры:

• Кнопка настроек — определяет, добавляется ли кнопка "Настройки", открывающая экран настроек, на экраны хранилищ.
• Защита хотбара — определяет, исключается ли хотбар из действий с хранилищами.

• Видимость рамки избранного — управляет тем, когда рисуется рамка избранного предмета на слотах с избранными предметами. Может быть установлено на:

  • Always — рамка рисуется всегда.
  • On Modifier Press — рамка рисуется только при удержании клавиши-модификатора (по умолчанию Left Alt).
  • Non-Hotbar — рамка рисуется везде, кроме хотбара.
  • On Modifier & Non-Hotbar — рамка рисуется только при удержании клавиши-модификатора и только вне хотбара.
  • Never — рамка никогда не рисуется.

• Сортировать по — определяет свойство, по которому сортируются предметы при использовании Сортировки предметов или Сортировки инвентаря. Может быть установлено на:

  • Item Group — предметы сортируются по их группе.
  • Item Count — предметы сортируются по количеству (от большего к меньшему).
  • Item Rarity — предметы сортируются по их редкости (от высшей к низшей).
  • Item Name — предметы сортируются по алфавиту по названию.
  • Item Id — предметы сортируются по их ID (от меньшего к большему).
• Режим быстрого стака хранилища — настраивает режим быстрого стака, используемый для операций с отдельным хранилищем. (Подробности см. в разделе Быстрый стак и пополнение.)
• Режим быстрого стака ближайших хранилищ — настраивает режим быстрого стака, используемый для ближайших хранилищ. (Подробности см. в разделе Быстрый стак и пополнение.)
• Текстуры кнопок — управляет текстурами, используемыми кнопками хранилища в инвентаре.

Помимо Экрана настроек, есть отдельный экран настройки кнопок, который позволяет настроить внешний вид кнопок параметров хранения, отображаемых в интерфейсах инвентарей хранилищ.

⏺️ Все эти параметры можно настроить через файл клиентской конфигурации, расположенный по пути .\config\terrastorage_client.toml. Этот файл предназначен для удобного ручного редактирования и содержит значения по умолчанию для каждого свойства, а также диапазон целочисленных значений.

Серверная сторона

Следующие серверные настройки можно изменить с помощью игровых команд. Чтобы изменить настройку, используйте команду /terrastorage [option] [new value]. Чтобы просмотреть текущее значение, используйте /terrastorage [option].

Доступные параметры:

• action-cooldown

  Задаёт время перезарядки для всех действий с хранилищами, в игровых тиках.

  По умолчанию: 10

• line-of-sight-check

  Определяет, учитывает ли функция «Быстрое складывание в ближайшие хранилища» только хранилища в поле зрения игрока.

  По умолчанию: true

• quick-stack-range

  Задаёт радиус действия функции «Быстрое складывание в ближайшие хранилища», в блоках.

  По умолчанию: 8

• item-animation-length

  Задаёт длительность анимации летящего предмета при использовании «Быстрого складывания в ближайшие хранилища», в игровых тиках.

  По умолчанию: 20

• item-animation-interval

  Задаёт интервал времени между анимированными летящими предметами, в тиках.

  По умолчанию: 5

• enable-item-favoriting (только для серверов 1.21+)

  Определяет, включена ли функция Избранные предметы на выделенных серверах. Установите false, чтобы обеспечить совместимость с ванильными клиентами. Недоступно в одиночной игре.

  По умолчанию: true

• keep-favorites-on-drop

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

  По умолчанию: true

⏺️ Эти настройки можно напрямую изменять через файл конфигурации, расположенный по пути .\config\terrastorage.toml. Как и файл клиентской конфигурации, он предназначен для удобного ручного редактирования. Ниже приведено его содержимое по умолчанию:

#The cooldown of all storage actions, in game ticks
#Range: 2 to 100, inclusive
#Default: 10
action_cooldown = 10
#==========
#Whether the Quick Stack To Nearby Storages feature only considers storages within the player's line of sight.
#Default: true
line_of_sight_check = true
#==========
#The range of the Quick Stack to Nearby Storages feature, in blocks
#Range: 3 to 16, inclusive
#Default: 8
quick_stack_range = 8
#==========
#The length of the flying item animation that occurs when Quick Stack To Nearby Storages is used, in game ticks
#Range: 10 to 200, inclusive
#Default: 20
item_animation_length = 20
#==========
#The interval between animated flying items, in game ticks
#Range: 0 to 20, inclusive
#Default: 5
item_animation_interval = 5
#==========
#Whether the item favoriting feature is enabled. Disable this to ensure compatibility with vanilla clients.
#Default: true
enable_item_favoriting = true
#==========
#Whether items will keep their favorite status once they are dropped as an item entity.
#Default: true
keep_favorites_on_drop = true

Совместимость

Поддерживаемые хранилища

Terrastorage без проблем работает со всеми ванильными блоками-хранилищами, такими как сундуки, бочки, шалкеровыми ящиками и даже с такими вещами, как вагонетки с сундуками и лодки с сундуками.

Совместимость с модифицированными блоками-хранилищами различается. Некоторые будут работать без каких-либо проблем, а другие могут не поддерживаться сразу. Если вы встретите блок-хранилище из другого мода, который, похоже, не работает с Terrastorage, не стесняйтесь открыть issue на GitHub, и я посмотрю, что можно сделать!

Ограничения функционала

Переименование блоков хранилища из модов, которые не наследуются от BaseContainerBlockEntity, или сущностей хранилища из модов, которые не наследуются от ContainerEntity, сейчас не поддерживается. Это ограничение, которое было бы сложно обойти, и, скорее всего, оно останется таким в обозримом будущем.

Благодарности

Текстуры в стиле Minecraft для кнопок Quick Stack To Nearby Storages и Sort Inventory любезно предоставила Ventgirl_Joanne.

Русский перевод предоставил Demzy123.

Обратная связь и поддержка

Если у вас есть вопрос, предложение или вы столкнулись с какими-либо проблемами, не стесняйтесь создать issue!

Обратите внимание: с 2 декабря 2024 года я начал учёбу, которая будет занимать меня ближайшие несколько лет. Это значит, что у меня будет значительно меньше времени активно работать над Terrastorage или отвечать на отзывы и проблемы.

Я всё ещё постараюсь решать важные проблемы и рассматривать предложения, когда это возможно, но время ответа может быть больше.