5a0a984aa8
* fix: make IdentityComp.IdentityEntitySlot optional * Revert "fix: make IdentityComp.IdentityEntitySlot optional" This reverts commit fa25263be916ed142bf2cff9871fca3e64c6da2b. * fix conflicts --------- Co-authored-by: slarticodefast <161409025+slarticodefast@users.noreply.github.com>
81 lines
3.1 KiB
C#
81 lines
3.1 KiB
C#
using Content.Shared.Ghost;
|
|
using Content.Shared.IdentityManagement.Components;
|
|
|
|
namespace Content.Shared.IdentityManagement;
|
|
|
|
/// <summary>
|
|
/// Static content API for getting the identity entities/names for a given entity.
|
|
/// This should almost always be used in favor of metadata name, if the entity in question is a human player that
|
|
/// can have identity.
|
|
/// </summary>
|
|
public static class Identity
|
|
{
|
|
/// <summary>
|
|
/// Returns the name that should be used for this entity for identity purposes.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This will return the true identity of the entity if called before the
|
|
/// identity component has been initialized — this may occur for example if
|
|
/// the client raises an event in response to an entity entering PVS for
|
|
/// the first time.
|
|
/// </remarks>
|
|
public static string Name(EntityUid uid, IEntityManager ent, EntityUid? viewer = null)
|
|
{
|
|
if (!uid.IsValid())
|
|
return string.Empty;
|
|
|
|
var meta = ent.GetComponent<MetaDataComponent>(uid);
|
|
if (meta.EntityLifeStage <= EntityLifeStage.Initializing)
|
|
return meta.EntityName; // Identity component and such will not yet have initialized and may throw NREs
|
|
|
|
var uidName = meta.EntityName;
|
|
|
|
if (!ent.TryGetComponent<IdentityComponent>(uid, out var identity))
|
|
return uidName;
|
|
|
|
var ident = identity.IdentityEntitySlot?.ContainedEntity;
|
|
if (ident is null)
|
|
return uidName;
|
|
|
|
var identName = ent.GetComponent<MetaDataComponent>(ident.Value).EntityName;
|
|
if (viewer == null || !CanSeeThroughIdentity(uid, viewer.Value, ent))
|
|
{
|
|
return identName;
|
|
}
|
|
if (uidName == identName)
|
|
{
|
|
return uidName;
|
|
}
|
|
|
|
return $"{uidName} ({identName})";
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns the entity that should be used for identity purposes, for example to pass into localization.
|
|
/// This is an extension method because of its simplicity, and if it was any harder to call it might not
|
|
/// be used enough for loc.
|
|
/// </summary>
|
|
/// <param name="viewer">
|
|
/// If this entity can see through identities, this method will always return the actual target entity.
|
|
/// </param>
|
|
/// <inheritdoc cref="Name" path="remarks" />
|
|
public static EntityUid Entity(EntityUid uid, IEntityManager ent, EntityUid? viewer = null)
|
|
{
|
|
if (!ent.TryGetComponent<IdentityComponent>(uid, out var identity))
|
|
return uid;
|
|
|
|
if (viewer != null && CanSeeThroughIdentity(uid, viewer.Value, ent))
|
|
return uid;
|
|
|
|
return identity.IdentityEntitySlot?.ContainedEntity ?? uid;
|
|
}
|
|
|
|
public static bool CanSeeThroughIdentity(EntityUid uid, EntityUid viewer, IEntityManager ent)
|
|
{
|
|
// Would check for uid == viewer here but I think it's better for you to see yourself
|
|
// how everyone else will see you, otherwise people will probably get confused and think they aren't disguised
|
|
return ent.HasComponent<GhostComponent>(viewer);
|
|
}
|
|
|
|
}
|