Item Scrapper [1.20.1]

Мод Item Scrapper вводит специализированную верстачную станцию для утилизации предметов. С этим модом игроки получают доступ к системе, позволяющей разбирать предметы на основные компоненты настраиваемым и иммерсивным способом.

Новая система Datapack

Item Scrapper теперь использует современную систему конфигурации на основе датапаков! Это означает:

• Лучшую совместимость с модами - другие моды могут предоставлять свои собственные конфигурации для Item Scrapper
• Готовые к использованию пакеты контента - мы предоставляем официальные пакеты для популярных модов
• Генерацию шаблонов - мод может генерировать шаблоны конфигураций, чтобы помочь вам создавать пользовательские датапаки
• Перезагрузку - используйте /reload для обновления конфигураций без перезапуска (если это датапак, не работает, если он упакован как мод/jar)

Требуется пакет контента

⚠️ Важно: Для использования этого мода вам необходим совместимый пакет контента/датапак! Мод предупредит вас, если конфигурации не обнаружены.

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

• Item Scrapper Pack - VPB 
• Item Scrapper Pack - Armor & Tools 
• Item Scrapper Pack - TACZ 

Ключевые особенности

Верстак для утилизации

• Многоблочная структура: Стол для утилизации 2x1, на который помещаются предметы
• Визуализация предметов: Видите свои предметы, разложенные на поверхности стола с реалистичным позиционированием
• Молоток для утилизации: Используйте прилагаемый инструмент-молоток для разборки предметов
• Система прогресса: Визуальная обратная связь показывает прогресс утилизации с помощью частиц и эффектов

Система конфигурации Datapack

• Добыча на основе рецептов: Автоматически генерируйте материалы из рецептов крафта предметов
• Пользовательские таблицы добычи: Используйте систему таблиц добычи Minecraft для уникальных дропов
• Поддержка нескольких рецептов: Предметы могут ссылаться на несколько рецептов для сложных материалов
• Совпадение NBT: Различные варианты одного и того же предмета (например, модифицированное оружие) могут иметь уникальные конфигурации

Расширенный пользовательский опыт

• Поддержка горячих клавиш: Нажмите P (настраивается), чтобы разместить предметы прямо на утилизаторе
• Умные подсказки: Настраиваемые подсказки для предметов показывают информацию об утилизации
• Визуальные эффекты: Эффекты частиц, звуки и анимации улучшают процесс утилизации
• Система прочности: Состояние предмета влияет на коэффициенты восстановления материалов

Расширенные функции

• Система взрывов: Предметы могут иметь шанс взрыва во время утилизации
• Опции округления: Выберите, как обрабатывать дробные количества материалов (STANDARD/ FLOOR/ CEILING)
• Интеграция с модами: Встроенная поддержка оружия TACZ и PointBlank
• Автогенерация: Автоматически создает конфигурации для помеченных предметов
• Отладочная система: Комплексное ведение журнала для устранения неполадок

Структура Datapack

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

Структура JAR/Mod (lowcodefml):

item-scrapper-pack-example-1.0.0.jar
├── META-INF/
│   └── mods.toml
├── pack.mcmeta
└── data/
    └── item_scrapper_pack_example/    # ID вашего пакета модов
        └── item_scrapper/             # Целевое пространство имен мода
            ├── recipes/
            │   ├── iron_sword_result.json
            │   └── iron_pickaxe_result.json
            └── transforms/
                ├── iron_sword_transform.json
                └── iron_pickaxe_transform.json

Структура ZIP/Datapack:

item-scrapper-example-datapack.zip
├── pack.mcmeta
└── data/
    └── item_scrapper_pack_example/    # Пространство имен вашего пакета
        └── item_scrapper/             # Целевое пространство имен мода
            ├── recipes/
            │   ├── iron_sword_result.json
            │   └── iron_pickaxe_result.json
            └── transforms/
                ├── iron_sword_transform.json
                └── iron_pickaxe_transform.json

Объяснение структуры:

• Первый уровень: Уникальное пространство имен вашего пакета контента (предотвращает конфликты между разными пакетами)
• Второй уровень: Пространство имен item_scrapper (указывает моду Item Scrapper загрузить эти конфиги)
• recipes/: Содержит конфигурации поведения утилизации для предметов
• transforms/: Содержит данные визуального позиционирования для предметов на столе утилизации

Конфигурация рецепта

{
  "minecraft:diamond_pickaxe": [
    {
      "lootable": {
        "autoGenerateFromRecipe": true,
        "recipeId": "minecraft:diamond_pickaxe",
        "returnAmount": {
          "min": 25.0,
          "max": 35.0
        },
        "amountForMaxReturn": 1
      },
      "requiredHits": 4.0,
      "explosionChance": 0.0,
      "explosionPower": 0.0,
      "useDurabilityMultiplier": true,
      "roundingType": "STANDARD"
    }
  ]
}

Конфигурация трансформации

{
  "minecraft:diamond_pickaxe": [
    {
      "xLocation": 0.0,
      "yLocation": 0.0,
      "zLocation": 0.0,
      "layingRotation": 0.0,
      "scale": 1.0
    }
  ]
}

Расширенное совпадение NBT (для модифицированных предметов)

{
  "tacz:modern_kinetic_gun": [
    {
      "requiredNbt": "{GunId:"tacz:glock_17"}",
      "lootable": {
        "autoGenerateFromRecipe": true,
        "recipeId": "tacz:glock_17",
        "returnAmount": {
          "min": 45.0,
          "max": 70.0
        }
      },
      "requiredHits": 2.0
    }
  ]
}

Опции конфигурации

Поля рецепта

• lootable: Определяет, как генерируются материалы
  • autoGenerateFromRecipe: Генерировать из рецепта крафта предмета
  • recipeId/recipeIds: Какой рецепт(ы) использовать (поддерживает массивы)
  • returnAmount: Мин./макс. процент возвращаемых материалов
  • amountForMaxReturn: Сколько предметов нужно для полной эффективности
  • lootTable: Альтернатива - использовать пользовательскую таблицу добычи
• requiredHits: Количество необходимых ударов молотка
• explosionChance: Процентный шанс взрыва (0-100)
• explosionPower: Сила взрыва при срабатывании
• useDurabilityMultiplier: Влияет ли состояние предмета на выход
• roundingType: Как обрабатывать дробные количества (STANDARD/FLOOR/CEILING)
• requiredNbt: Данные NBT, необходимые для этой конфигурации

Поля трансформации

• xLocation: Смещение позиции по оси X на столе
• yLocation: Смещение позиции по оси Y на столе
• zLocation: Смещение позиции по оси Z на столе
• layingRotation: Угол поворота предмета
• scale: Масштабирование размера отображаемого предмета
• requiredNbt: Данные NBT, необходимые для этой трансформации

Система автогенерации

Мод может автоматически генерировать шаблоны конфигураций для:

• Тегов предметов: Настройте forge:armors, tacz:guns, pointblank:all и т.д.
• Отдельных предметов: Укажите точные предметы, например minecraft:diamond_sword
• Интеграции TACZ: Автоматическое обнаружение и настройка рецептов оружия
• Интеграции PointBlank: Поддержка рецептов оружия PointBlank

Как это работает: Сгенерированные конфиги размещаются в generated_datapacks/item_scrapper_generated/ как шаблоны. Вам необходимо вручную скопировать эту папку в папку датапаков вашего мира или использовать ее в качестве основы для создания собственного пакета контента.

Управление и интерфейс

• Разместить предмет: Клавиша P (настраивается) - Разместить удерживаемый предмет прямо на утилизатор
• Собрать предметы: Правый клик по утилизатору для сбора выхода, Shift+Правый клик для сбора всего
• Утилизация: Левый клик Молотком для утилизации, когда предметы на столе
• Экран конфигурации: Доступ через Mod Menu для клиентских настроек

Интеграция с модами

TACZ (Timeless and Classics Zero)

• Автоматическое обнаружение рецептов оружия
• Поддержка как старых, так и новых форматов TACZ
• Сопоставление вариантов оружия на основе NBT

PointBlank

• Нативная поддержка рецептов оружия PointBlank
• Автоматическое извлечение ингредиентов
• Полная совместимость с модами

Начало работы

1. Установите мод - Основной мод Item Scrapper
2. Получите пакет контента - Выберите один вариант:
   • VPB Pack для предметов мода VPB
   • Armor & Tools Pack для ванильного/модифицированного снаряжения
   • TACZ Pack для оружия TACZ
   • Или используйте функцию автогенерации для создания шаблонов, затем вручную установите их как датапаки
3. Скрафтите блоки - Стол для утилизации и Молоток для утилизации
4. Разместите предметы - Используйте клавишу P или правый клик, чтобы разместить предметы на столе
5. Начните утилизацию - Бейте по предметам молотком, чтобы разобрать их!

Профессиональные советы

• Несколько предметов: Складывайте несколько предметов для массовой обработки
• Прочность имеет значение: Ремонтируйте предметы перед утилизацией для лучшего выхода
• Безопасность при взрывах: Некоторые предметы могут взорваться - соблюдайте дистанцию!
• Шаблоны конфигураций: Автогенерированные конфиги необходимо вручную скопировать в saves/[world]/datapacks/, чтобы они работали
• Быстрое тестирование: Используйте /reload для быстрого тестирования изменений конфигурации
• Производительность: Настройте лимиты рендеринга, если испытываете лаги со многими предметами