Цю сторінку ще не перекладено — показано англійську версію.

Collision

Прив’яжіть трансформ до мапи перешкод і оголосіть, що відбувається під час контакту. Модуль Collision працює всередині симуляції платформи. Ви оголошуєте тіла, шари й реакції, а на контакти підписуєтеся.

Коли це потрібно

• Сутності (entity), що рухаються, мають обробляти контакти на сервері — ковзати, зупинятися, відскакувати, — а писати для цього власну процедуру відбиття не хочеться.
• Геймплей реагує на дотик: предмет підбирається, щойно з ним перетнулися, а зони-тригери запускають машину станів (state machine) сутності.
• Модулю 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, і повторювати запит марно.
• Якщо перевищено частоту перевірок, відповідь приходить у категорії обмеження частоти разом із терміном, до якого повторювати марно.

Обмеження

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

• Тіла в кімнаті: оголошення ще одного тіла відхиляють як конфлікт. Наявні тіла ніколи не видаляють, щоб звільнити місце.
• Контакти за крок: зайві ніколи не відкидають мовчки. Або крок відхиляють, або порядок відсікання оголошено.
• Розмір тіла відносно кроку сітки мапи: невідповідність відхиляють під час деплою, бо тіло, менше за крок поля висот, провалюється крізь рельєф.
• Області, у яких тіло може перебувати одночасно: надлишок відхиляють під час деплою.
• Частота перевірок на актора: обмеження частоти з терміном.
• Тіла у відповіді на запит «хто в цій області»: список обрізають в оголошеному порядку, і прапорець обрізання обов’язковий.