tbd-station-14/Content.Shared/Lock/LockComponent.cs

using Content.Shared.DoAfter;
using Robust.Shared.Audio;
using Robust.Shared.GameStates;
using Robust.Shared.Serialization;

namespace Content.Shared.Lock;

/// <summary>
/// Allows locking/unlocking, with access determined by AccessReader
/// </summary>
[RegisterComponent, NetworkedComponent]
[Access(typeof(LockSystem))]
[AutoGenerateComponentState]
public sealed partial class LockComponent : Component
{
    /// <summary>
    /// Whether or not the lock is locked.
    /// </summary>
    [DataField("locked"), ViewVariables(VVAccess.ReadWrite)]
    [AutoNetworkedField]
    public bool Locked  = true;

    /// <summary>
    /// If true, will show verbs to lock and unlock the item. Otherwise, it will not.
    /// </summary>
    [DataField, AutoNetworkedField]
    public bool ShowLockVerbs = true;

    /// <summary>
    /// If true will show examine text.
    /// </summary>
    [DataField, AutoNetworkedField]
    public bool ShowExamine = true;

    /// <summary>
    /// Whether or not the lock is locked by simply clicking.
    /// </summary>
    [DataField("lockOnClick"), ViewVariables(VVAccess.ReadWrite)]
    [AutoNetworkedField]
    public bool LockOnClick;

    /// <summary>
    /// Whether or not the lock is unlocked by simply clicking.
    /// </summary>
    [DataField, AutoNetworkedField]
    public bool UnlockOnClick = true;

    /// <summary>
    /// Whether or not the lock is locked when used it hand.
    /// </summary>
    [DataField, AutoNetworkedField]
    public bool LockInHand;

    /// <summary>
    /// Whether or not the lock is unlocked when used in hand.
    /// </summary>
    [DataField, AutoNetworkedField]
    public bool UnlockInHand;

    /// <summary>
    /// Whether access requirements should be checked for this lock.
    /// </summary>
    [DataField, AutoNetworkedField]
    public bool UseAccess = true;

    /// <summary>
    /// What readers should be checked to determine if an entity has access.
    /// If null, all possible readers are checked.
    /// </summary>
    [DataField, AutoNetworkedField]
    public LockTypes? CheckedLocks;

    /// <summary>
    /// Whether any reader needs to be accessed to operate this lock.
    /// By default, all readers need to be able to be accessed.
    /// </summary>
    [DataField, AutoNetworkedField]
    public bool CheckForAnyReaders;

    /// <summary>
    /// The sound played when unlocked.
    /// </summary>
    [DataField("unlockingSound"), ViewVariables(VVAccess.ReadWrite)]
    public SoundSpecifier? UnlockSound = new SoundPathSpecifier("/Audio/Machines/door_lock_off.ogg")
    {
        Params = AudioParams.Default.WithVolume(-5f),
    };

    /// <summary>
    /// The sound played when locked.
    /// </summary>
    [DataField("lockingSound"), ViewVariables(VVAccess.ReadWrite)]
    public SoundSpecifier? LockSound = new SoundPathSpecifier("/Audio/Machines/door_lock_on.ogg")
    {
        Params = AudioParams.Default.WithVolume(-5f)
    };

    /// <summary>
    /// Whether or not an emag disables it.
    /// </summary>
    [DataField]
    [AutoNetworkedField]
    public bool BreakOnAccessBreaker = true;

    /// <summary>
    /// Amount of do-after time needed to lock the entity.
    /// </summary>
    /// <remarks>
    /// If set to zero, no do-after will be used.
    /// </remarks>
    [DataField]
    [AutoNetworkedField]
    public TimeSpan LockTime;

    /// <summary>
    /// Amount of do-after time needed to unlock the entity.
    /// </summary>
    /// <remarks>
    /// If set to zero, no do-after will be used.
    /// </remarks>
    [DataField]
    [AutoNetworkedField]
    public TimeSpan UnlockTime;

    /// <summary>
    /// Whether this lock can be locked again after being unlocked.
    /// </summary>
    [DataField, AutoNetworkedField]
    public bool AllowRepeatedLocking = true;
}

/// <summary>
/// Event raised on the lock when a toggle is attempted.
/// Can be cancelled to prevent it.
/// </summary>
[ByRefEvent]
public record struct LockToggleAttemptEvent(EntityUid User, bool Silent = false, bool Cancelled = false);

/// <summary>
/// Event raised on the user when a toggle is attempted.
/// Can be cancelled to prevent it.
/// </summary>
[ByRefEvent]
public record struct UserLockToggleAttemptEvent(EntityUid Target, bool Silent = false, bool Cancelled = false);

/// <summary>
/// Event raised on a lock after it has been toggled.
/// </summary>
[ByRefEvent]
public readonly record struct LockToggledEvent(bool Locked);

/// <summary>
/// Used to lock a lockable entity that has a lock time configured.
/// </summary>
/// <seealso cref="LockComponent"/>
/// <seealso cref="LockSystem"/>
[Serializable, NetSerializable]
public sealed partial class LockDoAfter : DoAfterEvent
{
    public override DoAfterEvent Clone()
    {
        return this;
    }
}

/// <summary>
/// Used to unlock a lockable entity that has an unlock time configured.
/// </summary>
/// <seealso cref="LockComponent"/>
/// <seealso cref="LockSystem"/>
[Serializable, NetSerializable]
public sealed partial class UnlockDoAfter : DoAfterEvent
{
    public override DoAfterEvent Clone()
    {
        return this;
    }
}

[NetSerializable]
[Serializable]
public enum LockVisuals : byte
{
    Locked
}