CatStation/Content.Shared/Movement/Events/UpdateCanMoveEvent.cs

using Content.Shared.ActionBlocker;
using Content.Shared.Movement.Components;

namespace Content.Shared.Movement.Events;

/// <summary>
///     Raised whenever <see cref="InputMoverComponent.CanMove"/> needs to be updated.
///     Cancel this event to prevent a mover from moving.
/// </summary>
/// <remarks>
///     This is not an attempt event and the result is cached.
///     If you subscribe to this you must also call <see cref="ActionBlockerSystem.UpdateCanMove(EntityUid,InputMoverComponent?)"/>
///     both when you want to prevent a mob from moving, and when you want to allow them to move again!
/// </remarks>
public sealed class UpdateCanMoveEvent : CancellableEntityEventArgs
{
    public UpdateCanMoveEvent(EntityUid uid)
    {
        Uid = uid;
    }

    public EntityUid Uid { get; }
}

/// <summary>
/// Event raised on an entity when their value of <see cref="InputMoverComponent.CanMove"/> is updated.
/// </summary>
[ByRefEvent]
public readonly record struct CanMoveUpdatedEvent(bool CanMove);

/// <summary>
/// Raised on a source entity when its effective movement entity changes.
/// </summary>
[ByRefEvent]
public readonly record struct EffectiveMoverChangedEvent(EntityUid OldMover, EntityUid NewMover);