320135347f
* First clumsy implementation of guidebook protodata * Support for Properties, format strings * Better null * Rename file * Documentation and some cleanup * Handle errors better * Added note about client-side components * A couple of examples * DataFields * Use attributes like a sane person * Outdated doc * string.Empty * No IComponent? * No casting * Use EntityManager.ComponentFactory * Use FrozenDictionary * Cache tagged component fields * Iterate components and check if they're tagged
46 lines
1.4 KiB
C#
46 lines
1.4 KiB
C#
using Content.Shared.Guidebook;
|
|
|
|
namespace Content.Client.Guidebook;
|
|
|
|
/// <summary>
|
|
/// Client system for storing and retrieving values extracted from entity prototypes
|
|
/// for display in the guidebook (<see cref="RichText.ProtodataTag"/>).
|
|
/// Requests data from the server on <see cref="Initialize"/>.
|
|
/// Can also be pushed new data when the server reloads prototypes.
|
|
/// </summary>
|
|
public sealed class GuidebookDataSystem : EntitySystem
|
|
{
|
|
private GuidebookData? _data;
|
|
|
|
public override void Initialize()
|
|
{
|
|
base.Initialize();
|
|
|
|
SubscribeNetworkEvent<UpdateGuidebookDataEvent>(OnServerUpdated);
|
|
|
|
// Request data from the server
|
|
RaiseNetworkEvent(new RequestGuidebookDataEvent());
|
|
}
|
|
|
|
private void OnServerUpdated(UpdateGuidebookDataEvent args)
|
|
{
|
|
// Got new data from the server, either in response to our request, or because prototypes reloaded on the server
|
|
_data = args.Data;
|
|
_data.Freeze();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Attempts to retrieve a value using the given identifiers.
|
|
/// See <see cref="GuidebookData.TryGetValue"/> for more information.
|
|
/// </summary>
|
|
public bool TryGetValue(string prototype, string component, string field, out object? value)
|
|
{
|
|
if (_data == null)
|
|
{
|
|
value = null;
|
|
return false;
|
|
}
|
|
return _data.TryGetValue(prototype, component, field, out value);
|
|
}
|
|
}
|