Створення вашого першого блоку

Блоки є будівельними блоками Minecraft (без каламбуру) - як і все інше в Minecraft, вони зберігаються в реєстрах.

Підготовка вашого класу блоків

Якщо ви завершили сторінку Створення свого першого предмета, цей процес здасться вам дуже знайомим – вам потрібно буде створити метод, який реєструє ваш блок і його блок-предмет.

Вам слід помістити цей метод у клас під назвою ModBlocks (або як ви хочете його назвати).

Mojang робить щось надзвичайно подібне з ванілльними блоками; ви можете звернутися до класу Blocks, щоб побачити, як вони це роблять.

public class ModBlocks {
	public static Block register(Block block, String name, boolean shouldRegisterItem) {
		// Register the block and its item.
		ResourceLocation id = ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, name);

		// Sometimes, you may not want to register an item for the block.
		// Eg: if it's a technical block like `minecraft:air` or `minecraft:end_gateway`
		if (shouldRegisterItem) {
			BlockItem blockItem = new BlockItem(block, new Item.Properties());
			Registry.register(BuiltInRegistries.ITEM, id, blockItem);
		}

		return Registry.register(BuiltInRegistries.BLOCK, id, block);
	}

}

Як і з предметами, вам потрібно переконатися, що клас завантажено, щоб усі статичні поля, що містять екземпляри вашого блоку, були ініціалізовані.

Ви можете зробити це, створивши фіктивний метод initialize, який можна викликати в ініціалізаторі мода, щоб запустити статичну ініціалізацію.

INFO

Якщо ви не знаєте, що таке статична ініціалізація, то це процес ініціалізації статичних полів у класі. Це робиться, коли клас завантажується JVM, і робиться до створення будь-яких екземплярів класу.

public class ModBlocks {
    // ...

    public static void initialize() {}
}

public class ExampleModBlocks implements ModInitializer {
	@Override
	public void onInitialize() {
		ModBlocks.initialize();
	}
}

Створення та реєстрація вашого блоку

Подібно до предметів, блоки приймають у своєму конструкторі клас BlockBehaviour.Properties, який визначає властивості блоку, такі як його звукові ефекти та рівень видобутку.

Ми не будемо розглядати всі варіанти тут — ви можете самостійно переглянути клас, щоб побачити різні варіанти, які мають бути зрозумілими.

Для прикладу ми створимо простий блок, який має властивості бруду, але є іншим матеріалом.

TIP

Ви також можете використовувати BlockBehaviour.Properties.ofFullCopy(AbstractBlock block), щоб скопіювати налаштування блоку що існує, у цьому випадку ми могли б використати Blocks.DIRT, щоб скопіювати налаштування dirt, але для прикладу ми скористаємося конструктором.

public static final Block CONDENSED_DIRT = register(
		new Block(BlockBehaviour.Properties.of().sound(SoundType.GRASS)),
		"condensed_dirt",
		true
);

Щоб автоматично створити блок-предмет ми можемо передати true параметру shouldRegisterItem методу register, який ми створили на попередньому кроці.

Додавання вашого блоку до групи предметів

Оскільки BlockItem створюється та реєструється автоматично, щоб додати його до групи предметів, ви повинні використати метод Block.asItem(), щоб отримати примірник BlockItem.

У цьому прикладі ми використаємо спеціальну групу предметів, створену на сторінці Групи власних предметів.

public static final Block CONDENSED_OAK_LOG = register(
		new RotatedPillarBlock(
				BlockBehaviour.Properties.of()
						.sound(SoundType.WOOD)
		), "condensed_oak_log", true
);
	ItemGroupEvents.modifyEntriesEvent(ModItems.CUSTOM_ITEM_GROUP_KEY).register((itemGroup) -> {
		itemGroup.accept(ModBlocks.CONDENSED_DIRT.asItem());
	});

Тепер ви повинні помітити, що ваш блок знаходиться у творчому інвентарі, і його можна розмістити у світі!

Однак є кілька проблем: блок-предмет не має назви, і блок не має текстури, моделі блоку чи моделі предмета.

Додання перекладу для блока

Щоб додати переклад, ви повинні створити ключ перекладу у своєму файлі перекладу - assets/example-mod/lang/en_us.json, це англійська, для української створіть uk_ua.json.

Minecraft використовуватиме цей переклад у творчому інвентарі та інших місцях, де показано його назву, наприклад у повідомленнях команд.

{
  "block.example-mod.condensed_dirt": "Condensed Dirt"
}

Ви можете перезапустити гру або створити свій мод і натиснути F3+T, щоб застосувати зміни, і ви побачите, що блок має назву у творчому інвентарі та інших місцях наприклад екран статистики.

Моделі й текстури

Усі текстури блоків можна знайти в теці assets/example-mod/textures/block - приклад текстури для блоку «Condensed Dirt» можна використовувати безплатно.

<0>Текстура</0>

Щоб текстура промальовувалася в грі, ви повинні створити модель блоку і предмета, які можна знайти у відповідних місцях для блоку «Condensed Dirt»:

• assets/example-mod/models/block/condensed_dirt.json
• assets/example-mod/models/item/condensed_dirt.json

Модель предмета досить проста, вона може просто використовувати модель блоку як батьківську, оскільки більшість моделей блоку підтримують відтворення в інтерфейсах:

{
  "parent": "example-mod:block/condensed_dirt"
}

Однак у нашому випадку модель блоку має бути батьківською для моделі block/cube_all:

{
  "parent": "block/cube_all",
  "textures": {
    "all": "example-mod:block/condensed_dirt"
  }
}

Коли ви завантажуєте гру, ви можете помітити, що текстури все ще немає. Це тому, що вам потрібно додати визначення стану блоку.

Створення визначення стану блоку

Визначення стану блоку використовується для вказівки грі, яку модель промальовувати на основі поточного стану блоку.

Для прикладу блоку, який не має складного стану блока, у визначенні потрібен лише один запис.

Цей файл має міститися в папці assets/example-mod/blockstates, а його назва має збігатися з ідентифікатором блоку, який використовується під час реєстрації вашого блоку в класі ModBlocks. Наприклад, якщо ID блоку condensed_dirt, файл повинен мати назву condensed_dirt.json.

{
  "variants": {
    "": { "model": "example-mod:block/condensed_dirt" }
  }
}

Стани блоку справді складні, тому вони розглядаються на наступній сторінці: Блокові стани

Перезапустіть гру або перезавантажте за допомогою F3+T, щоб застосувати зміни – ви зможете побачити блокову текстуру в інвентарі та фізично у світі:

Додання здобичі для блоку

Під час розбивання блоку під час виживання ви можете побачити, що блок не падає — можливо, вам потрібна ця функція, однак, щоб ваш блок випадав як предмет під час ламання, ви повинні застосувати його таблицю здобичі — файл таблиці здобичі слід розмістити в теку data/example-mod/loot_table/blocks/.

INFO

Щоб краще зрозуміти таблиці здобичі, ви можете звернутися до сторінки Minecraft Wiki - Таблиці здобичі.

{
  "type": "minecraft:block",
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "minecraft:item",
          "name": "example-mod:condensed_dirt"
        }
      ],
      "conditions": [
        {
          "condition": "minecraft:survives_explosion"
        }
      ]
    }
  ]
}

Ця таблиця здобичі забезпечує випадіння одного предмета з блоку, коли блок ламаний або підірваний вибухом.

Рекомендований інструмент

Ви також можете захотіти, щоб ваш блок можна було збирати лише певним інструментом - наприклад, ви можете зробити свій блок, що ламається швидше за допомогою лопати.

Усі теґи інструментів слід розміщувати в теці data/minecraft/tags/block/mineable/, де назва файлу залежить від типу використовуваного інструменту, одного з наступного:

• hoe.json
• axe.json
• pickaxe.json
• shovel.json

Вміст файлу досить простий - це список предметів, які потрібно додати в теґ.

Цей приклад додає блок «Condensed Dirt» до теґу shovel.

{
  "replace": false,
  "values": ["example-mod:condensed_dirt"]
}

Якщо ви бажаєте, щоб для видобутку блоку був потрібен інструмент, додайте .requiresTool() до налаштувань блоку, а також додайте відповідний теґ видобутку.

Рівень копання

Подібним чином теґ рівня майнінгу можна знайти в теці data/minecraft/tags/block/ й відповідає такому формату:

• needs_stone_tool.json - потребує як мінімум кам'яні інструменти
• needs_iron_tool.json - потребує як мінімум залізні інструменти
• needs_diamond_tool.json - потребує як мінімум діамантові інструменти.

Файл має той самий формат, що й файл інструменту збору врожаю – список предметів, які потрібно додати до теґу.

Додаткові уточнення

Якщо ви додаєте кілька блоків до свого моду, ви можете розглянути можливість використання генерації даних, щоб автоматизувати процес створення моделей блоків і предметів, визначень станів блоків, і таблиці здобичі.