AI Pathfinder

Как использовать?

• Во-первых, выберите базовую сущность.

  Эта сущность будет телом вашей пользовательской сущности. Она также может быть хитбоксом вашей сущности, если вы решите не реализовывать собственную систему хитбоксов. Если вы используете Minecraft версии 1.21.9+, рекомендуем выбрать сущность манекена в качестве базовой сущности.

• Во-вторых, свяжите вашу сущность с отображением пользовательской сущности.

  В зависимости от вашей реализации свяжите «отображение пользовательской сущности» с этой базовой сущностью. Это может быть как простая статичная модель, так и сложный риг из Animated-Java. Связывание можно выполнить через систему ID, которую датапак сам по себе не предоставляет.

• В-третьих, дайте вашей сущности тег ai.pathfinding

  С помощью команды /tag дайте вашей сущности тег ai.pathfinding:

/tag <entity> add ai.pathfinding

После добавления этого тега датапак инициализирует некоторые базовые значения для ИИ. Такие значения, как скорость передвижения ИИ, состояние ИИ, сила прыжка, дальность атаки, дальность обзора и угол обзора.

Вот и всё! Сущность с пользовательским ИИ, готовая слушать ваши команды! А теперь — большой список настраиваемых параметров:

Изменяемые значения

Скорборды

ai.State: Хранит состояние ИИ.
                          |__________ Idle = 0;
                          |__________ Walking = 1;
                          |__________ Sprinting = 2;

ai.Mode: Хранит «режим» ИИ.
                          |__________ Idle = 0;
                          |__________ Roaming Only = 1;
                          |__________ Chasing Target Entity = 2;

Значения времени:
ai.PathfindingDuration: Хранит, как долго ИИ ждёт перед созданием нового пути. Это значение уменьшается при генерации пути.
ai.ChasingEntityMemoryDuration: Хранит, как долго ИИ помнит сущность, прежде чем забудет её.
ai.baseLostEntityGracePeriod: Время, которое ИИ ждёт после потери целевой сущности, прежде чем начать поиск пути.

Значения ИИ:
ai.baseMovementSpeed: Хранит пользовательское значение скорости передвижения ИИ (меняется в зависимости от значения ai.State) (x1000)
ai.baseSprintSpeed: Хранит пользовательское значение скорости передвижения ИИ (меняется в зависимости от значения ai.State) (x1000)
ai.baseJumpStrength: Хранит пользовательское значение силы прыжка ИИ. (x1000)
ai.baseViewAngle: Хранит половину угла конуса обзора ИИ (x1000)
ai.baseViewRange: Хранит радиус половины угла конуса обзора (x1000)

Установка значения ИИ на скорборде с именем, начинающимся с префикса ai.base..., необязательна. Если их не задать, датапак будет использовать базовые значения, указанные ниже. Эти базовые значения также можно изменять, так как они хранятся в скорборде ai.Values.

### Базовые значения
Эти значения инициализируются в `ai:global/load` и масштабируются (x1000)

baseMovementSpeed = 150 baseSprintSpeed = 220 baseJumpStrength = 410 baseViewHalfAngle = 30000 // 60° Cone. baseLostEntityGracePeriod = 200 // AI stands still for 10 seconds before it starts moving again.

// These values are scaled (x10) since they're used in raycasting. baseViewRange = 300 // AI can see up to 30 blocks away (view cone radius is 30 blocks)

Изменяя эти значения, вы можете настроить ИИ под свои нужды!


### Дополнительные примеры:
- Допустим, вы хотите, чтобы ваша базовая сущность бегала только тогда, когда вам это нужно. Чтобы она бежала из одной точки в другую, установите её счёт ai.State в 2. Если вы хотите, чтобы она везде только ходила, установите её счёт ai.State в 1.
- Допустим, вы хотите, чтобы ваша сущность с ИИ только бродила, но не преследовала никаких сущностей. Установите её ai.Mode в 1.


А теперь API, который предоставляет датапак:
### API

"ai:api/pathfind" Usage: execute as at <location_marker_entity> run function ai:api/pathfind Usage (other): execute as positioned x y z run function ai:api/pathfind Once this function is ran, the AI will formulate a path towards the position of <location_marker_entity> or the (X,Y,Z) coordinate. Once the path is formed, it will begin travelling through it.

"ai:api/set_mode/chasing" Usage: execute as at @s as <target_entity> run function ai:api/set_mode/chasing Once this function is ran, <target_entity> will begin to be targetted by the AI. If <target_entity> appears in the View Cone of the AI, whose dimensions are specified by the ai.ViewRange and ai.ViewAngle scoreboards, the AI will start chasing <target_entity>.

"ai:api/set_mode/idle" Usage: execute as run function ai:api/set_mode/idle This function stops the AI from implementing pathfinding logic. Useful if you want to play an Animation.

"ai:api/set_mode/roaming" Usage: execute as run function ai:api/set_mode/roaming Once this function is ran, the AI will become passive. Alternatively, if there are entities of type #ai:node (by default, it only contains marker) and tag "ai.Node", the AI will randomly pathfind to this entity after random intervals of time.

### Теги
Некоторые особые теги, которые могут быть у сущности с ИИ и изменяют её поведение:

ai.CompletePathBeforeUpdating = Есть вероятность, что ИИ может сменить путь, не дойдя до пункта назначения. Этот тег предотвратит это.

ai.LookOnlyAtPath = Во время движения ИИ будет смотреть только на путь, по которому идёт.

ai.RandomlyLookAnywhere = Во время движения ИИ будет случайно смотреть либо в случайном направлении по рысканью, тангажу, либо на интересную nearby сущность — это сделано для повышения реалистичности и живости.

ai.Node = Любая сущность типа #ai:node с этим тегом будет действовать как узел, к которому сущность может перемещаться во время блуждания. Полезно для фиксированных локаций.

ai.BeingTargetted = Если сущность с этим тегом и с тем же значением в скорборде ai.id, что и у сущности с ИИ, попадёт в конус обзора ИИ, ИИ начнёт её преследовать, ЕСЛИ его ai.Mode установлен в 2 (режим преследования)

</details>



# Примеры
<iframe align="center" width="560" height="315" src="https://www.youtube-nocookie.com/embed/0P-fM50Ya50" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
<p align="center">Воссоздаём игрока Minecraft с помощью манекенов!</p>