Item Scrapper [1.20.1]

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

Новая система датапаков

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

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

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

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

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

Верстак для разборки

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

Система конфигурации датапаков

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

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

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

Структура датапака

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

Структура JAR/Мода (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/Датапака:

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, требуемые для этой трансформации.

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

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

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

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

Полезные советы

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