Эта страница ещё не переведена — показана английская версия.

Collision

Привяжите трансформ к карте препятствий и объявите, что происходит при контакте. Модуль Collision работает внутри симуляции платформы. Вы объявляете тела, слои и реакции, а на контакты подписываетесь.

Когда это нужно

• Движущиеся сущности (entity) должны разрешать контакты на сервере — скользить, останавливаться, отскакивать, — и писать для этого свою процедуру отклонения не хочется.
• Геймплей реагирует на касание: предметы подбираются при пересечении, а зоны-триггеры запускают машину состояний сущности.
• Модулю Locomotion и снарядам нужна непрерывная (swept) проверка столкновений по набору препятствий карты.
• Для превью размещения или прицеливания нужно спрашивать «поместится ли это здесь?» и искать пересечения объёмов.
• Не нужен, если в игре ничего физически не сталкивается. Для геймплея по схеме «запрос — ответ» над записями хватит обычного модуля Data & Subscriptions.

Кто что делает

Коротко

Форма, слой и реакция на контакт объявляются прямо на теле. Отдельного объявления пар слоёв где-то в стороне нет:

[Entity("tank")]
public class Tank
{
    [Sync] public Vector3 Position;

    [Body(Shape.Capsule, Radius = 0.6f, Layer = "vehicles")]
    [CollidesWith("walls", Response.Slide)]
    [CollidesWith("pickups", Response.Pass)]        // reported, motion passes through
    public Body Body;
}

@Entity('tank')
export class Tank {
  @Sync() position!: Vector3;

  @Body({ shape: 'capsule', radius: 0.6, layer: 'vehicles' })
  @CollidesWith('walls', Response.Slide)
  @CollidesWith('pickups', Response.Pass)        // reported, motion passes through
  body: Body;
}

@entity("tank")
class Tank:
    position: Vector3 = sync()

    body = collision.body(shape="capsule", radius=0.6, layer="vehicles",
                           collides_with=[
                               ("walls", Response.SLIDE),
                               ("pickups", Response.PASS),   # reported, motion passes through
                           ])

// the declaration rides inside the engine's own reflection macros, in the specifier position —
// UHT reads it from the header text, and the member is a reflected property at the same time
UCLASS(PSEntity = "tank")
class UTank : public UObject
{
    GENERATED_BODY()

    UPROPERTY(PSSync)
    FVector3f Position;

    // walls slide, pickups report the contact and let motion pass through —
    // multi-entry values are one quoted list (a specifier value is a single token)
    UPROPERTY(PSBody = (Shape = "Capsule", Radius = "0.6", Layer = "vehicles"),
              PSCollidesWith = "walls:Slide, pickups:Pass")
    FPSBody Body;
};
// declarations compile into the same pushed model — playserv push from the UE project or CI

[Entity("tank")]
public class Tank
{
    [Sync] public Vector3 Position;

    [Body(Shape.Capsule, Radius = 0.6f, Layer = "vehicles")]
    [CollidesWith("walls", Response.Slide)]
    [CollidesWith("pickups", Response.Pass)]        // reported, motion passes through
    public Body Body;
}

Контакт — это событие (event), и модули на него подписываются. Хука на контакт нет: к моменту, когда контакт возник, шаг его уже разрешил, и отклонять больше нечего. Если студии нужны другие правила, она переопределяет реализацию проверок допустимости и пути (см. Extensibility), а реакция по-прежнему задаётся объявлением.

Модель

Что объявляет тело.

Реакция объявляется на пару «вид проходимости препятствия × тип тела» и выбирается из закрытого набора:

Коэффициенты — это объявленные значения, а не результат расчёта по массам и материалам: ни масс, ни материалов в этом контракте нет.

Что верно для любой проверки.

Ошибки

• «Недопустимо» — это ответ, а не ошибка, и в нём указано, какая из трёх причин сработала: позиция за границами, занята статическим препятствием или занята телом другой сущности. Клиент реагирует на них по-разному: развернуться, объехать или подождать.
• Ошибки объявления всплывают при деплое, а не на первом контакте. Тело формы вне закрытого набора, тело на аспекте без трансформа и пара без объявленной реакции отклоняются при деплое.
• Если сущность или место не найдены, ответ — not found, и повторять запрос бессмысленно.
• Если превышена частота проверок, ответ приходит в категории ограничения частоты со сроком, до которого повторять бессмысленно.

Ограничения

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

• Тела в комнате: объявление ещё одного тела отклоняется как конфликт. Чтобы освободить место, существующие тела никогда не удаляются.
• Контакты за шаг: лишние никогда не отбрасываются молча. Либо шаг отклоняется, либо порядок отсечения объявлен.
• Размер тела относительно шага сетки карты: отклоняется при деплое, потому что тело меньше шага карты высот проваливается сквозь рельеф.
• Области, в которых одновременно может находиться тело: превышение отклоняется при деплое.
• Частота проверок на актора: ограничение частоты со сроком.
• Тела в ответе на вопрос «кто в этой области»: список обрезается в объявленном порядке, и флаг обрезки обязателен.