Modding:Adding Block Behavior/ru: Difference between revisions

<languages/>

{{GameVersion|1.19.3}}

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

Возможно, вам захочется взглянуть на существующие [[Block Json Properties#p_behaviors|Поведения Блоков]], прежде чем реализовывать свои собственные.

 

Итак, прежде всего нам нужно создать само поведение, которое представляет собой класс, наследующийся от BlockBehavior

Этот класс предоставляет несколько методов, которые мы можем переопределить. При использовании Visual Studio вы можете найти полный список методов, наведя курсор мыши на "BlockBehavior" и нажав "F12".

Метод <code>bool OnBlockInteractStart(IWorldAccessor world, IPlayer byPlayer, BlockSelection blockSel, ref EnumHandling handling)</code> выглядит идеально подходящим для нашей цели.

Что метод должен делать?

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

# Проверить, можно ли поместить блок в эту новую позицию.

# Удалить блок в старой позиции.

# Поместить блок того же типа на новую позицию.

# [[Modding:Behavior_Traversal|Skip]] логика по умолчанию, которая в противном случае поместит любой удерживаемый предмет на старую позицию.

     public override bool OnBlockInteractStart(IWorldAccessor world, IPlayer byPlayer, BlockSelection blockSel, ref EnumHandling handling)

         // Найдите выбранную позицию

         BlockPos pos = blockSel.Position.AddCopy(blockSel.Face.Opposite);

         // Можем ли мы разместить здесь блок?

        if (world.BlockAccessor.GetBlock(pos).IsReplacableBy(block))

             // Удалите блок в текущей позиции и поместите его в выбранную позицию

         // Сообщите игровому движку и другим моделям поведения блоков, что мы обработали взаимодействие игрока с блоком.

         // Если бы мы не задали поле обработки, игрок все равно смог бы ставить блоки, если бы они были у него в руках.

        handling = EnumHandling.PreventDefault;

    }

== Регистрация ==  

Чтобы зарегистрировать BlockBehavior, нам нужно создать класс мода, переопределив от <code>Start(ICoreAPI)</code> и зарегистрировать его с указанным именем:

public override void Start(ICoreAPI api)

}

== Распространение ==  

Чтобы закончить все, откройте modtools и введите <code>pack <your mod id></code>. Теперь вы можете взять zip-файл и поделиться им с другими людьми.

== Тестирование ==  

= Расширенное Поведение =  

Наше созданное поведение все еще довольно простое, но возможностей гораздо больше. Поведение может иметь особые свойства, которые могут быть определены самим типом блока.

== Пример ==  

Поведение жидкости поддерживает некоторые особые свойства, как показано в этом примере с типом блока "Вода":

== Разбор свойств ==  

Для того чтобы разобраться со специальными свойствами, существует метод <code>Initialize(JsonObject)</code>. Каждый blocktype создает новый экземпляр поведения, поэтому этот метод можно использовать для разбора свойств.

* Толчок блока на расстояние

* Тянуть блок, если игрок крадется

Дополнительно нам нужно добавить два поля, одно для расстояния, а другое - если игрок должен потянуть за блок, когда крадется...

Теперь мы можем разобрать эти два свойства следующим образом:

Следующее, что нам нужно изменить, - это сам метод interact, чтобы он позаботился о свойствах расстояния и притяжения...

 

 

            // Сообщите игровому движку и другим моделям поведения блоков, что мы обработали взаимодействие игрока с блоком.

            // Если бы мы не задали поле обработки, игрок все равно смог бы ставить блоки, если бы они были у него в руках.

            handling = EnumHandling.PreventDefault;

== Добавление другого блока ==  

Блок будет толкать два блока вместо одного, и игрок может тянуть его, крадясь, нажимая правую кнопку мыши.

= Скачать Мод =