using System; using System.Collections.Generic; using System.Diagnostics.CodeAnalysis; using System.Linq; using JetBrains.Annotations; using Robust.Shared.GameObjects; using Robust.Shared.IoC; using Robust.Shared.Localization; using Robust.Shared.Log; using Robust.Shared.Maths; using Robust.Shared.Serialization.Manager; using Robust.Shared.Serialization.Manager.Attributes; using Robust.Shared.Utility; using Robust.Shared.ViewVariables; namespace Robust.Shared.Prototypes { /// /// Prototype that represents game entities. /// [Prototype("entity", -1)] public class EntityPrototype : IPrototype { /// /// The "in code name" of the object. Must be unique. /// [ViewVariables] [DataField("id")] public string ID { get; private set; } = default!; /// /// The "in game name" of the object. What is displayed to most players. /// [ViewVariables, CanBeNull] [DataField("name")] public string Name { get => _name; private set { _nameModified = true; _name = Loc.GetString(value); } } private string _name = ""; private bool _nameModified; [DataField("localizationId")] string? _localizationId; /// /// Fluent messageId used to lookup the entity's name and localization attributes. /// [ViewVariables, CanBeNull] public string? LocalizationID { get => _localizationId ??= $"ent-{CaseConversion.PascalToKebab(ID)}"; private set => _localizationId = value; } /// /// Optional suffix to display in development menus like the entity spawn panel, /// to provide additional info without ruining the Name property itself. /// [ViewVariables] [DataField("suffix")] public string? EditorSuffix { get => _editorSuffix; private set => _editorSuffix = value != null ? Loc.GetString(value) : null; } private string? _editorSuffix; /// /// The description of the object that shows upon using examine /// [ViewVariables] [DataField("description")] public string Description { get => _description; private set { _descriptionModified = true; _description = Loc.GetString(value); } } private string _description = ""; private bool _descriptionModified; /// /// If true, this object should not show up in the entity spawn panel. /// [ViewVariables] [NeverPushInheritance] [DataField("abstract")] public bool Abstract { get; private set; } [DataField("placement")] private EntityPlacementProperties PlacementProperties = new(); /// /// The different mounting points on walls. (If any). /// [ViewVariables] public List? MountingPoints => PlacementProperties.MountingPoints; /// /// The Placement mode used for client-initiated placement. This is used for admin and editor placement. The serverside version controls what type the server assigns in normal gameplay. /// [ViewVariables] public string PlacementMode => PlacementProperties.PlacementMode; /// /// The Range this entity can be placed from. This is only used serverside since the server handles normal gameplay. The client uses unlimited range since it handles things like admin spawning and editing. /// [ViewVariables] public int PlacementRange => PlacementProperties.PlacementRange; private const int DEFAULT_RANGE = 200; /// /// Set to hold snapping categories that this object has applied to it such as pipe/wire/wallmount /// private HashSet _snapFlags => PlacementProperties.SnapFlags; private bool _snapOverriden => PlacementProperties.SnapOverriden; /// /// Offset that is added to the position when placing. (if any). Client only. /// [ViewVariables] public Vector2i PlacementOffset => PlacementProperties.PlacementOffset; private bool _placementOverriden => PlacementProperties.PlacementOverriden; /// /// True if this entity will be saved by the map loader. /// [ViewVariables] [DataField("save")] public bool MapSavable { get; protected set; } = true; /// /// The prototype we inherit from. /// [ViewVariables] [DataField("parent")] public string? Parent { get; private set; } /// /// A list of children inheriting from this prototype. /// [ViewVariables] public List Children { get; private set; } = new(); public bool IsRoot => Parent == null; /// /// A dictionary mapping the component type list to the YAML mapping containing their settings. /// [field: DataField("components")] [field: AlwaysPushInheritance] public ComponentRegistry Components { get; } = new(); private readonly HashSet ReferenceTypes = new(); string? CurrentDeserializingComponent; readonly Dictionary> FieldCache = new(); readonly Dictionary DataCache = new(); public EntityPrototype() { // Everybody gets a transform component! Components.Add("Transform", new TransformComponent()); // And a metadata component too! Components.Add("MetaData", new MetaDataComponent()); } public bool TryGetComponent(string name, [NotNullWhen(true)] out T? component) where T : IComponent { if (!Components.TryGetValue(name, out var componentUnCast)) { component = default; return false; } // There are no duplicate component names // TODO Sanity check with names being in an attribute of the type instead component = (T) componentUnCast; return true; } public void UpdateEntity(Entity entity) { if (ID != entity.Prototype?.ID) { Logger.Error($"Reloaded prototype used to update entity did not match entity's existing prototype: Expected '{ID}', got '{entity.Prototype?.ID}'"); return; } var factory = IoCManager.Resolve(); var componentManager = IoCManager.Resolve(); var oldPrototype = entity.Prototype; var oldPrototypeComponents = oldPrototype.Components.Keys .Where(n => n != "Transform" && n != "MetaData") .Select(name => (name, factory.GetRegistration(name).Type)) .ToList(); var newPrototypeComponents = Components.Keys .Where(n => n != "Transform" && n != "MetaData") .Select(name => (name, factory.GetRegistration(name).Type)) .ToList(); var ignoredComponents = new List(); // Find components to be removed, and remove them foreach (var (name, type) in oldPrototypeComponents.Except(newPrototypeComponents)) { if (Components.Keys.Contains(name)) { ignoredComponents.Add(name); continue; } componentManager.RemoveComponent(entity.Uid, type); } componentManager.CullRemovedComponents(); var componentDependencyManager = IoCManager.Resolve(); // Add new components foreach (var (name, type) in newPrototypeComponents.Where(t => !ignoredComponents.Contains(t.name)).Except(oldPrototypeComponents)) { var data = Components[name]; var component = (Component) factory.GetComponent(name); CurrentDeserializingComponent = name; component.Owner = entity; componentDependencyManager.OnComponentAdd(entity, component); entity.AddComponent(component); } // Update entity metadata entity.MetaData.EntityPrototype = this; } internal static void LoadEntity(EntityPrototype? prototype, Entity entity, IComponentFactory factory, IEntityLoadContext? context) //yeah officer this method right here { /*YamlObjectSerializer.Context? defaultContext = null; if (context == null) { defaultContext = new PrototypeSerializationContext(prototype); }*/ if (prototype != null) { foreach (var (name, data) in prototype.Components) { var fullData = data; if (context != null) { fullData = context.GetComponentData(name, data); } EnsureCompExistsAndDeserialize(entity, factory, name, fullData, context as ISerializationContext); } } if (context != null) { foreach (var name in context.GetExtraComponentTypes()) { if (prototype != null && prototype.Components.ContainsKey(name)) { // This component also exists in the prototype. // This means that the previous step already caught both the prototype data AND map data. // Meaning that re-running EnsureCompExistsAndDeserialize would wipe prototype data. continue; } var ser = context.GetComponentData(name, null); EnsureCompExistsAndDeserialize(entity, factory, name, ser, context as ISerializationContext); } } } private static void EnsureCompExistsAndDeserialize(Entity entity, IComponentFactory factory, string compName, IComponent data, ISerializationContext? context) { var compType = factory.GetRegistration(compName).Type; if (!entity.TryGetComponent(compType, out var component)) { var newComponent = (Component) factory.GetComponent(compName); newComponent.Owner = entity; entity.AddComponent(newComponent); component = newComponent; } // TODO use this value to support struct components _ = IoCManager.Resolve().Copy(data, component, context); } public override string ToString() { return $"EntityPrototype({ID})"; } public class ComponentRegistry : Dictionary { public ComponentRegistry() { } public ComponentRegistry(Dictionary components) : base(components) { } } [DataDefinition] public class EntityPlacementProperties { public bool PlacementOverriden { get; private set; } public bool SnapOverriden { get; private set; } private string _placementMode = "PlaceFree"; private Vector2i _placementOffset; [DataField("mode")] public string PlacementMode { get => _placementMode; set { PlacementOverriden = true; _placementMode = value; } } [DataField("offset")] public Vector2i PlacementOffset { get => _placementOffset; set { PlacementOverriden = true; _placementOffset = value; } } [DataField("nodes")] public List? MountingPoints; [DataField("range")] public int PlacementRange = DEFAULT_RANGE; private HashSet _snapFlags = new (); [DataField("snap")] public HashSet SnapFlags { get => _snapFlags; set { SnapOverriden = true; _snapFlags = value; } } } /*private class PrototypeSerializationContext : YamlObjectSerializer.Context { readonly EntityPrototype? prototype; public PrototypeSerializationContext(EntityPrototype? owner) { prototype = owner; } public override void SetCachedField(string field, T value) { if (StackDepth != 0 || prototype?.CurrentDeserializingComponent == null) { base.SetCachedField(field, value); return; } if (!prototype.FieldCache.TryGetValue(prototype.CurrentDeserializingComponent, out var fieldList)) { fieldList = new Dictionary<(string, Type), object?>(); prototype.FieldCache[prototype.CurrentDeserializingComponent] = fieldList; } fieldList[(field, typeof(T))] = value; } public override bool TryGetCachedField(string field, [MaybeNullWhen(false)] out T value) { if (StackDepth != 0 || prototype?.CurrentDeserializingComponent == null) { return base.TryGetCachedField(field, out value); } if (prototype.FieldCache.TryGetValue(prototype.CurrentDeserializingComponent, out var dict)) { if (dict.TryGetValue((field, typeof(T)), out var theValue)) { value = (T) theValue!; return true; } } value = default!; return false; } public override void SetDataCache(string field, object value) { if (StackDepth != 0 || prototype == null) { base.SetDataCache(field, value); return; } prototype.DataCache[field] = value; } public override bool TryGetDataCache(string field, out object? value) { if (StackDepth != 0 || prototype == null) { return base.TryGetDataCache(field, out value); } return prototype.DataCache.TryGetValue(field, out value); } }*/ } }