Основные концепции Minecraft

Этот раздел был разработан как 10 000-метровый обзор для новичков, охватывающий основные понятия и определения, необходимые в качестве базовых знаний, прежде чем вы начнете разработку своего первого мода. Некоторые понятия относятся к элементам, видимым в игре, другие - к используемым файлам или классам, которые часто используются при моддинге. Понимание этих терминов и понятий, надеюсь, облегчит понимание других разделов Вики.

Понятие	Описание
Предмет(Item)	Что-то, что можно взять в руку, уронить на землю, поместить в инвентарь или хранить в контейнере. Это может быть инструмент или блок, который вы держите в руке, прежде чем поместить его.
Блок(Block)	Ключевой компонент для всего, что вы строите в Minecraft и размещаете в мире. Многие блоки - это кубы, но большинство вещей, которые вы размещаете в мире, реализованы в виде блоков, например, печь. Некоторые блоки даже не очень похожи на кубики, например, кнопки, заборы и двери, и все же они рассматриваются как блоки. Важно отметить, что блок следует рассматривать в коде как определение типа блока, а не как фактический отдельный блок, который вы видите в игре.
Состояние блока(Block state)	Состояние блока (часто встречается в коде под названием “state”) - это конкретный экземпляр блока вместе с его свойствами (например, ориентация, нахождение в воде или стадия роста). Это то, что вы обычно воспринимаете как блок во время игры. Каждое состояние блока может иметь свою собственную 3D модель.
Предмет блока(Block item)	Форма предмета блока, так что вы можете держать их в руке, складывать и хранить.
Сущность(Entity)	Динамические объекты в мире, которые обычно двигаются. Например, `ItemEntity` для предметов, и, конечно, `LivingEntity`. Некоторые другие вещи иногда также реализуются как сущности, например, снаряды, рамки предметов и картины.
Живая сущность(Living entity)	Подкатегория сущностей, которые живы и движутся в мире, например, игроки и мобы (коровы, зомби, летучие мыши и т.д.).
Сущность блока(Block entity)	Хранит дополнительные данные для блока, например, содержащиеся предметы или крафты. Они могут предоставлять дополнительную логику для блока, например, при тикании. Не все блоки имеют блочные сущности - те, которые имеют, реализуют `BlockEntityProvider`. Блочные сущности не то же самое, что сущности!
Модель блока/предмета(Block/item model)	Модель - это набор описательных данных, используемых для представления внешнего вида блока или предмета. Например, железный блок или печь будет содержать информацию, описывающую форму и размер каждой из его сторон, а также информацию о том, где найти текстуру (изображение), которая используется для придания конкретной поверхности ее уникального вида. Модели обычно описываются в файлах JSON, но также могут быть сгенерированы с помощью Java-кода.
Модель сущности(Entity model)	Сущности также имеют свои собственные 3D-модели, которые обычно определяются полностью в коде как экземпляры `net.minecraft.client.render.entity.model.EntityModel`.
Текстура	Это графические изображения, используемые для придания поверхностям их уникального вида. Они обычно реализуются в виде файлов .PNG размером 16×16 пикселей для блоков и предметов, или в виде более крупных изображений для сущностей и элементов графического интерфейса.
Рендерер(Renderer)	Хотя большинство модов используют `blockstates` и JSON файлы моделей плюс .PNG текстуры для полного представления блоков и предметов и полагаются на механизм рендеринга по умолчанию, чтобы показать их в мире так, как вы ожидаете, но бывают ситуации, когда вам нужно более сложное строение. В этих случаях вам потребуется создать собственный рендерер для достижения желаемого результата. Сущности всегда используют рендереры.
NBT	NBT - это формат файлов для хранения данных, используемый в Minecraft. Методы сохранения/загрузки NBT - это то, что вы используете в классе сущности или блочной сущности, чтобы убедиться, что ваши данные сохраняются и загружаются из сохранения мира. Звучит сложно, но это простое дело - переопределить пару методов и поместить туда пару строк кода. Это хорошо описано в разделе “Добавление сущности блока”.
Стороны(Sides)	Minecraft состоит из двух частей, клиентской и серверной. Когда вы играете на сервере, разделение очевидно, но серверная часть все еще существует, когда вы играете на своем компьютере. Вы часто увидите, что данный переопределенный метод вызывается и клиентом, и сервером, и чтобы определить, на какой стороне вы отвечаете, вам нужно будет проверить это. Самый простой и распространенный способ - проверка с помощью булевого метода `world.isClient()`. Более подробное объяснение смотрите в этой статье.
Синхронизация данных(Data sync)	Хотя вы можете хранить данные блока на его блочной сущности, такие данные не перемещаются автоматически между сервером и клиентом. Вы должны включить ее самостоятельно с помощью пары строк кода, следуя описанию в разделе “Добавление сущности блока”.