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

Locomotion

Вы объявляете, как объект движется, и никто не пишет интегратор. Модель движения превращает пронумерованный ввод в авторитетное движение. Она работает вместе со столкновениями, записывает историю для предсказания и учитывает баффы, дебаффы и рельеф.

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

• Сущности (entity) двигаются по вводу игрока — танки, персонажи, техника, — и решать, где они находятся, должен сервер.
• Вместо того чтобы писать интегратор, вы хотите объявить ограничения скорости, ускорения и поворота.
• Геймплей толкает тела: отбрасывание через Impulse, Teleport и модификаторы вроде грязи, действующие заданное время.
• Движение должно ощущаться мгновенным: по одной и той же объявленной модели шаги считаются и на сервере, и в цикле предсказания.
• Не нужен, если позиции меняются только дискретными шагами. Для этого хватит синхронизируемого поля на сущности.

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

Коротко

[Entity("tank")]
public class Tank
{
    [Sync] public Vector3 Position;
    [Motion(Model.Tank, MaxSpeed = 8f, Acceleration = 14f, TurnRateDeg = 120f)]
    public Motion Motion;
}

@Entity('tank')
export class Tank {
  @Sync() position!: Vector3;
  @Motion({ model: 'tank', maxSpeed: 8, acceleration: 14, turnRateDeg: 120 }) motion: Motion;
}

@entity("tank")
class Tank:
    position: Vector3 = sync()
    motion = locomotion.motion(model="tank", max_speed=8.0, acceleration=14.0, turn_rate_deg=120.0)

UCLASS(PSEntity = "tank")
class UTank : public UObject
{
    GENERATED_BODY()

    UPROPERTY(PSSync) FVector3f Position;

    UPROPERTY(PSMotion = (Model = "Tank", MaxSpeed = "8.0", Acceleration = "14.0", TurnRateDeg = 120))
    FPSMotion Motion;
};
// declarations compile into the same pushed model — playserv push from the UE project or CI

[Entity("tank")]
public class Tank
{
    [Sync] public Vector3 Position;
    [Motion(Model.Tank, MaxSpeed = 8f, Acceleration = 14f, TurnRateDeg = 120f)]
    public Motion Motion;
}

Клиент присылает не результат, а пронумерованное намерение. Само движение шаг за шагом считает платформа:

room.My<Tank>().Motion.Drive(throttle: 1f, steer: -0.4f);   // cl — sent at input rate

room.my<Tank>().motion.drive({ throttle: 1, steer: -0.4 });   // cl — sent at input rate

room.my(Tank).motion.drive(throttle=1.0, steer=-0.4)   # cl — a bot brain drives the same way

Room->Entities->Of<UTank>()->Select().GetMine().Then(
    TPSOnResult<UTank*>::CreateWeakLambda(this, [this](const TPSResult<UTank*>& Result)
    {
        if (!Result.HasValue()) { return; }
        // client — sent at input rate, numbered so the platform can acknowledge
        Result.Value()->Motion->SubmitInput(FPSMoveInput{ .Throttle = 1.f, .Steer = -0.4f }, InputSequence);
    }));
// co_await support ships later: a built-in SDK coroutine wrapper that respects Unreal's GC and threading.

room.My<Tank>().Motion.Drive(throttle: 1f, steer: -0.4f);   // cl — sent at input rate

Команды на стороне сервера:

tank.Motion.Impulse(knockback);
tank.Motion.Modify("mud", speedMultiplier: 0.6f, duration: 3.Seconds());
tank.Motion.Teleport(spawn);

tank.motion.impulse(knockback);
tank.motion.modify('mud', { speedMultiplier: 0.6, duration: seconds(3) });
tank.motion.teleport(spawn);

tank.motion.impulse(knockback)
tank.motion.modify("mud", speed_multiplier=0.6, duration=seconds(3))
tank.motion.teleport(spawn)

// on a dedicated server / master-client host
Tank->Motion->Impulse(EPSImpulseKind::Impulse, KnockbackVelocity);
Tank->Motion->Modify({ .Modifier = TEXT("mud"), .SpeedMultiplier = 0.6f, .For = FPSDuration::Seconds(3.f) });
Tank->Motion->Teleport(SpawnPosition, SpawnFacing);
// co_await support ships later: a built-in SDK coroutine wrapper that respects Unreal's GC and threading.

tank.Motion.Impulse(knockback);
tank.Motion.Modify("mud", speedMultiplier: 0.6f, duration: 3.Seconds());
tank.Motion.Teleport(spawn);

Модель

Что объявляет сущность, чтобы двигаться.

Что верно для любого шага.

Ошибки

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

Ограничения

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

• Максимальная скорость и ускорение: значение прижимается, отказа не бывает.
• Максимальный поворот за ввод: значение прижимается.
• Частота ввода на актора: ограничение частоты со сроком.
• Шаги догона: сверх предела шаги отбрасываются с объявленными последствиями. Время симуляции заметно отстаёт — зато не догоняет рывком, при котором кажется, будто все разом телепортировались.
• Величина импульса: прижимается к объявленному максимуму.
• Одновременные импульсы на сущность: новый вытесняет самый старый, и это вытеснение наблюдаемо. Молчаливого неограниченного сложения нет.
• Время жизни заявленной позы: поза старше объявленного периода не рассматривается.