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

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. Якби будь-що з цього відбувалося мовчки, клієнт вважав би, що його дію застосовано, і назавжди розійшовся б із сервером.

Обмеження

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

• Максимальна швидкість і прискорення: значення притискають, відмови не буває.
• Максимальний поворот за введення: значення притискають.
• Частота введення на актора: обмеження частоти з терміном.
• Кроки наздоганяння: понад межу кроки відкидають з оголошеним наслідком. Час симуляції помітно відстає, зате не наздоганяє стрибком, у якому всі ніби телепортуються водночас.
• Величина імпульсу: її притискають до оголошеного максимуму.
• Одночасні імпульси на сутність: новий витісняє найстаріший, і це витіснення видно. Мовчазного необмеженого підсумовування немає.
• Час життя заявленої пози: позу, старшу за оголошений період, не розглядають.