Object Stacks 1.2.3

Представляем ObjectStacks — плагин, который позволяет размещать разворачиваемые объекты друг на друга по вертикали, создавая аккуратные и компактные базы! Устали от беспорядка в вашей базе? Просто кликните правой кнопкой мыши, держа предмет в руках, чтобы поставить его на уже существующий объект того же типа. Идеально подходит для организации печей, хранилищ, генераторов и многого другого!


Возможности ObjectStacks

• Стопка в один клик: Просто нажмите правую кнопку мыши, чтобы поставить объект друг на друга — никаких команд, только интуитивный геймплей
• Точное вертикальное расстояние: Настраиваемое Y-Offset для каждого типа объекта обеспечивает идеальное выравнивание и предотвращает пересечения
• Лимиты на основе прав доступа: Контролируйте, сколько объектов может ставить каждая группа игроков (например, обычные игроки: 2, VIP: 4)
• Ограничение зоной стройки: Опциональное ограничение только зонами ящика инструментов для поддержания баланса игры
• Умная система стабильности: Автоматическая проверка стабильности предотвращает создание парящих конструкций и гарантирует реалистичное размещение
• Черный список скинов: Предотвращает стопку определенных скинов предметов, которые могут вызвать визуальные или игровые проблемы
• Интеграция с буксиром: Полная поддержка стопки на буксирах с автоматическим привязыванием и обходом проверки стабильности
• Защита от падения: Предотвращает падение стопленных объектов при удалении базовых объектов, сохраняя целостность конструкции
• Автоматическое управление правами: Все права автоматически регистрируются на основе вашей конфигурации
• Полное логирование: Опциональная система логирования с несколькими уровнями (Нет, Файл, Консоль, Все) для отладки
• Широкая совместимость: Поддерживает хранилища, электрические предметы, компостеры и многие другие разворачиваемые объекты
• Простая настройка: Простой файл конфигурации JSON — добавьте новые объекты за пару минут

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

Чтобы поставить объект друг на друга:

1. Держите в руках разворачиваемый предмет, который хотите поставить
2. Смотрите на существующий объект того же типа (должен быть в пределах 3 метров)
3. Нажмите правую кнопку мыши (кнопка вторичного огня)
4. Предмет автоматически установится сверху на нужной высоте

Кулдаун: Между попытками стопки есть кулдаун 0.5 секунды, чтобы предотвратить спам кликами.

Права доступа

Права доступа следуют формату: objectstacks.<shortname>.<group>

Объяснение формата прав:

• objectstacks - префикс плагина
• <shortname> - короткое имя, определенное в конфигурации объекта (например, "box_wooden", "electric_furnace")
• <group> - ваше пользовательское имя группы (например, "use", "vip", "premium")

Примеры:

• objectstacks.storage_barrel_b.use - Обычные игроки могут ставить до 2 бочек для хранения (лимит задан в конфиге)
• objectstacks.storage_barrel_b.vip - VIP игроки могут ставить до 4 бочек
• objectstacks.electric_furnace.use - Обычные игроки могут ставить до 2 печей
• objectstacks.electric_furnace.vip - VIP игроки могут ставить до 4 печей

Важно: Плагин использует наивысший лимит из всех прав, которые есть у игрока. Если у игрока есть права objectstacks.box_wooden.use (лимит: 2) и objectstacks.box_wooden.vip (лимит: 4), он сможет ставить до 4 ящиков.

Поддерживаемые объекты

Контейнеры для хранения:

• Деревянный ящик (малый)
• Большой деревянный ящик
• Бочка для хранения B
• Бочка для хранения C
• Гроб для хранения
• Средневековый большой деревянный ящик
• Бамбуковая бочка
• Плетеная бочка
• Бочка Abyss (вертикальная и горизонтальная)

Электрические предметы:

• Электрическая печь
• Малый генератор
• Малый топливный генератор
• Перезаряжаемая батарея (малая, средняя, большая)

Другие:

• Компостер

Примечание: Вы можете добавить любой разворачиваемый объект в конфигурацию. Просто найдите путь к его префабу и настройте Y-Offset и права доступа.

Руководство по конфигурации

Уровень логирования:

• None - Отключить все логирование
• File - Логировать в файлы в oxide/logs (или carbon/logs)
• Console - Логировать в консоль сервера
• All - Логировать и в файлы, и в консоль

Можно ставить только в зонах стройки?: Когда установлено в true, игроки могут ставить объекты только в зонах ящиков инструментов (или на буксирах). Это предотвращает чрезмерную стопку в общественных местах и поддерживает баланс игры. Установите в false, чтобы разрешить стопку где угодно.

Черный список скинов: Массив ID скинов, которые нельзя использовать для стопки. Добавьте сюда ID скинов, чтобы предотвратить стопку проблемных скинов. Пример: [123, 1223]

Права и их количество стопленных объектов: Словарь, сопоставляющий имена прав с лимитами стопки. Лимит представляет собой максимальное количество объектов, которые можно поставить в одной стопке.

Объекты и смещения: Словарь, сопоставляющий пути префабов объектов с их конфигурацией:

• YOffset - Вертикальное расстояние между стопленными объектами (в метрах)
• Shortname - Используется для имен прав (формат: objectstacks.<shortname>.<group>)

Часто задаваемые вопросы

В: Как ставить объекты друг на друга?
О: Держите предмет в руках, смотрите на существующий объект того же типа (в пределах 3 метров) и нажмите правую кнопку мыши. Предмет автоматически установится сверху.

В: Почему стопка не работает у меня?
О: Проверьте эти требования:

• Тип объекта должен быть настроен в плагине
• У вас должно быть соответствующее право (например, objectstacks.box_wooden.use)
• Вы не должны превысить свой лимит стопки
• Если включено "Только в зонах стройки", вы должны быть в зоне ящика инструментов
• Скин предмета не должен быть в черном списке
• В месте размещения должна быть достаточная стабильность
• Вы должны смотреть на объект (в пределах 3 метров)
• Объект, на который вы смотрите, должен быть того же типа, что и предмет в ваших руках

В: Как добавить новый объект в конфигурацию?
О: Следуйте этим шагам:

1. Найдите путь к префабу объекта (используйте команду spawn в консоли F1 или проверьте документацию Rust)
2. Добавьте запись в "Objects and offsets":
   
   Код:
   
   Код:

   "assets/prefabs/path/to/object.prefab": {
     "YOffset": 1.0,
     "Shortname for permissions (objectstacks.THISNAME.[use/vip/etc.])": "my_object"
   }

   
   
3. Добавьте права с лимитами:
   
   Код:
   
   Код:

   "objectstacks.my_object.use": 2,
   "objectstacks.my_object.vip": 4

   
   
4. Перезагрузите плагин: o.reload ObjectStacks (Oxide) или c.reload ObjectStacks (Carbon)

В: Что такое Y-Offset и как определить правильное значение?
О: Y-Offset — это вертикальное расстояние между стопленными объектами, измеряемое в метрах. Чтобы определить правильное значение:

• Проверьте высоту объекта в игре или в Unity
• Установите Y-Offset немного больше высоты объекта, чтобы предотвратить пересечения
• Общие значения: 0.5-0.7 для маленьких объектов, 1.0-1.5 для средних, 1.5-2.0 для больших
• Тестируйте и корректируйте по необходимости — вы сразу увидите расстояние при стопке

В: Как работают лимиты стопки?
О: Лимиты контролируют максимальное количество объектов, которые можно поставить в одной стопке. Плагин подсчитывает все объекты одного типа в вертикальной колонке и предотвращает стопку сверх лимита. Плагин использует наивысший лимит из всех прав, которые есть у игрока.

В: Можно ли ставить объекты вне зон ящика инструментов?
О: Да, если вы установите "Can stack only in Building Privileged zones?": false в конфиге. По умолчанию это установлено в true для поддержания баланса игры.

В: Работает ли стопка на буксирах?
О: Да! ObjectStacks полностью поддерживает буксиры. При стопке на буксире:

• Проверки стабильности обходятся
• Объекты автоматически привязываются к буксиру
• Ограничения прав на стройку не применяются

В: Что произойдет, если я удалю базовый объект из стопки?
О: Плагин включает защиту земли через хук OnEntityGroundMissing. Если вы удалите базовый объект, стопленные объекты сверху проверят, есть ли под ними другой объект того же типа. Если найден в пределах диапазона Y-Offset, они не упадут, предотвращая случайное разрушение.

В: Как найти путь к префабу объекта?
О: Несколько способов:

• Используйте команду spawn в консоли F1 — она показывает пути префабов при вводе
• Проверьте конфиг по умолчанию для примеров похожих объектов
• Найдите документацию по префабам Rust онлайн
• Используйте команды консоли сервера, которые показывают префабы

В: Можно ли предотвратить стопку определенных скинов?
О: Да! Добавьте ID скина в массив "Blacklisted Skins" в конфиге. Например: "Blacklisted Skins": [123, 1223, 4567]

В: Что означает сообщение об ошибке "Building blocked!"?
О: Это означает, что включено "Can stack only in Building Privileged zones?", и вы пытаетесь поставить объект вне зоны ящика инструментов. Переместитесь в зону ТС или отключите эту настройку в конфиге.

В: Что означает "Not enough stability to place the entity"?
О: Плагин проверяет, есть ли в месте размещения достаточно структурной поддержки. Если вы видите это сообщение, попробуйте поставить в другом месте или убедитесь, что под ним есть подходящий фундамент.

В: Где я могу увидеть пример конфигурации?
О: Конфиг по умолчанию, генерируемый плагином, содержит полные примеры всех поддерживаемых объектов. Вы можете использовать его как шаблон при добавлении новых объектов.