RobustToolbox/Robust.Client/Player/IPlayerManager.cs

using System;
using System.Collections.Generic;
using Robust.Shared.GameObjects;
using Robust.Shared.GameStates;
using Robust.Shared.Network;
using Robust.Shared.Player;

namespace Robust.Client.Player;

[NotContentImplementable]
public interface IPlayerManager : ISharedPlayerManager
{
    /// <summary>
    /// Invoked when the list of sessions/players gets updated.
    /// </summary>
    event Action? PlayerListUpdated;

    /// <summary>
    /// Invoked when <see cref="ISharedPlayerManager.LocalSession"/> gets attached to a new entity, or when the local
    /// session gets updated. See also <see cref="LocalPlayerAttachedEvent"/>
    /// </summary>
    event Action<EntityUid>? LocalPlayerAttached;

    /// <summary>
    /// Invoked when <see cref="ISharedPlayerManager.LocalSession"/> gets detached from an entity, or when the local
    /// session gets updated. See also <see cref="LocalPlayerDetachedEvent"/>
    /// </summary>
    event Action<EntityUid>? LocalPlayerDetached;

    /// <summary>
    /// Invoked whenever <see cref="ISharedPlayerManager.LocalSession"/> changes.
    /// </summary>
    event Action<(ICommonSession? Old, ICommonSession? New)>? LocalSessionChanged;

    void ApplyPlayerStates(IReadOnlyCollection<SessionState> list);

    /// <summary>
    /// Sets up a single player game. This creates a dummy <see cref="ISharedPlayerManager.LocalSession"/>  without an
    /// <see cref="INetChannel"/>.
    /// </summary>
    void SetupSinglePlayer(string name);

    /// <summary>
    /// Sets up the manager for a multiplayer game. This creates a <see cref="ISharedPlayerManager.LocalSession"/>
    /// using the given <see cref="INetChannel"/>.
    /// </summary>
    void SetupMultiplayer(INetChannel channel);

    void SetLocalSession(ICommonSession session);

    [Obsolete("Use LocalSession instead")]
    LocalPlayer? LocalPlayer { get;}
}