MiguelCrates

Создание и редактирование кейсов

MiguelCrates использует JSON-файлы конфигурации для определения кейсов. Это позволяет легко создавать новые кейсы или изменять существующие без изменения кода мода.

Расположение

Файлы конфигурации кейсов находятся в директории config/migueleconomy/crates/ вашего экземпляра Minecraft.

• Сервер/Клиент: config/migueleconomy/crates/

Каждый кейс — отдельный .json файл. Имя файла определяет уникальный ID кейса (например, common.json -> common).

Структура кейса

Базовая структура JSON-файла кейса выглядит так:

{
  "display_name": "My Custom Crate",
  "description": "A description of what's inside.",
  "icon": "minecraft:chest",
  "texture": "miguelcrates:block/common_crate",
  "rewards": [
    ...
  ],
  "obtain": {
    "sources": [
      ...
    ]
  }
}

Поля

Упрощённые зачарования (рекомендуется)

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

{
    "item": "minecraft:enchanted_book",
    "quantity": 1,
    "enchantments": {
        "minecraft:sharpness": 5,
        "minecraft:unbreaking": 3
    },
    "weight": 10
}

Продвинутый NBT

Для более сложных данных (атрибуты, имена и т.д.) вы по-прежнему можете использовать поле nbt.

{
    "item": "minecraft:diamond_sword",
    "nbt": "{display:{Name:'{\"text\":\"Excalibur\"}'}}",
    "weight": 5
}

Награды

Список rewards содержит объекты, определяющие, что игроки могут выиграть.

"rewards": [
  {
    "item": "minecraft:diamond",
    "quantity": 2,
    "weight": 10
  },
  {
    "command": "give @p minecraft:stone 64",
    "weight": 50
  },
  {
    "item": "minecraft:experience_bottle",
    "command": "xp add @p 5 levels",
    "weight": 10
  },
  {
    "item": "migueleconomy:money",
    "nbt": "{MoneyValue:100L}",
    "weight": 20
  }
]

• item: Ресурсное расположение предмета (например, minecraft:iron_sword). Если используется вместе с command, выступает в роли иконки.
• command: Команда для выполнения. Используйте @p для игрока, открывающего кейс.
• name: (Опционально) Кастомное отображаемое имя награды (например, «5 уровней опыта»).
• quantity: (Опционально, по умолчанию 1) Количество выдаваемых предметов.
• nbt: (Опционально) Строка NBT-данных для предмета.

• weight: Вес шанса. Чем выше вес, тем выше шанс.

  • Вероятность = weight / total_weight_of_all_rewards

Способы получения

Секция obtain определяет, как ящики генерируются в мире. Она содержит список sources.

1. Крафт (craft)

Позволяет игрокам скрафтить ящик на верстаке.

{
  "type": "craft",
  "recipe": {
    "type": "minecraft:crafting_shaped",
    "category": "misc",
    "pattern": [
      "AAA",
      "ABA",
      "AAA"
    ],
    "key": {
      "A": { "item": "minecraft:planks" },
      "B": { "item": "minecraft:chest" }
    },
    "result": {
      "id": "miguelcrates:crate",
      "count": 1,
      "components": {
        "minecraft:custom_data": { "CrateId": "your_crate_id" }
      }
    }
  }
}

2. Дроп с мобов (kill)

Выпадает при убийстве определённого существа.

{
  "type": "kill",
  "entity": "minecraft:zombie",
  "chance": 0.05
}

• entity: ID сущности (например, minecraft:creeper, minecraft:ender_dragon).
• chance: Вероятность от 0.0 до 1.0 (0.05 = 5%).

3. Таблицы лута (loot_table)

Добавляет ящик в ванильные таблицы лута (сундуки).

{
  "type": "loot_table",
  "id": "minecraft:chests/simple_dungeon",
  "chance": 0.1
}

• id: ID таблицы лута, в которую нужно добавить.
• chance: Вероятность появления ящика в сундуке.

Пример файла (example.json)

{
  "display_name": "Example Crate",
  "description": "An example configuration.",
  "icon": "minecraft:barrel",
  "texture": "miguelcrates:block/common_crate",
  "rewards": [
    {
      "item": "minecraft:apple",
      "quantity": 5,
      "weight": 50
    },
    {
      "item": "minecraft:golden_apple",
      "weight": 10
    }
  ],
  "obtain": {
    "sources": [
      {
        "type": "kill",
        "entity": "minecraft:skeleton",
        "chance": 0.02
      }
    ]
  }
}