3d41d5f2bc
* Make wielding automatically drop the item on your other hand * Fix docs * Remove redundant parameter * Fix not deleting virtuals on fail * Make count freeable hands method * Add popup when dropping item
45 lines
2.0 KiB
C#
45 lines
2.0 KiB
C#
using System.Linq;
|
|
using Content.Shared.Hands.EntitySystems;
|
|
|
|
namespace Content.Shared.Hands.Components;
|
|
|
|
/// <summary>
|
|
/// These helpers exist to make getting basic information out of the hands component more convenient, without
|
|
/// needing to resolve hands system or something like that.
|
|
/// </summary>
|
|
public static class HandHelpers
|
|
{
|
|
/// <summary>
|
|
/// Returns true if any hand is free. This is a LinQ method, not a property, so
|
|
/// cache it instead of accessing this multiple times.
|
|
/// </summary>
|
|
public static bool IsAnyHandFree(this HandsComponent component) => component.Hands.Values.Any(hand => hand.IsEmpty);
|
|
|
|
/// <summary>
|
|
/// Get the number of hands that are not currently holding anything. This is a LinQ method, not a property, so
|
|
/// cache it instead of accessing this multiple times.
|
|
/// </summary>
|
|
public static int CountFreeHands(this HandsComponent component) => component.Hands.Values.Count(hand => hand.IsEmpty);
|
|
|
|
/// <summary>
|
|
/// Get the number of hands that are not currently holding anything. This is a LinQ method, not a property, so
|
|
/// cache it instead of accessing this multiple times.
|
|
/// </summary>
|
|
public static int CountFreeableHands(this Entity<HandsComponent> component, SharedHandsSystem system)
|
|
{
|
|
return system.CountFreeableHands(component);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Get a list of hands that are currently holding nothing. This is a LinQ method, not a property, so cache
|
|
/// it instead of accessing this multiple times.
|
|
/// </summary>
|
|
public static IEnumerable<Hand> GetFreeHands(this HandsComponent component) => component.Hands.Values.Where(hand => !hand.IsEmpty);
|
|
|
|
/// <summary>
|
|
/// Get a list of hands that are currently holding nothing. This is a LinQ method, not a property, so cache
|
|
/// it instead of accessing this multiple times.
|
|
/// </summary>
|
|
public static IEnumerable<string> GetFreeHandNames(this HandsComponent component) => GetFreeHands(component).Select(hand => hand.Name);
|
|
}
|