RagdollParams.cs

using Microsoft.Xna.Framework;
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Xml.Linq;
using System.Linq;
using Barotrauma.IO;
using System.Xml;
using Barotrauma.Extensions;
using FarseerPhysics;
#if CLIENT
using Barotrauma.SpriteDeformations;
#endif
 
namespace Barotrauma
{
    public enum CanEnterSubmarine
    {
        False,
        True,
        Partial
    }
 
    class HumanRagdollParams : RagdollParams
    {
        public static HumanRagdollParams GetDefaultRagdollParams(Character character) => GetDefaultRagdollParams<HumanRagdollParams>(character);
    }
 
    class FishRagdollParams : RagdollParams
    {
        public static FishRagdollParams GetDefaultRagdollParams(Character character) => GetDefaultRagdollParams<FishRagdollParams>(character);
    }
 
    class RagdollParams : EditableParams, IMemorizable<RagdollParams>
    {
        #region Ragdoll
        public const float MIN_SCALE = 0.1f;
        public const float MAX_SCALE = 2;
 
        public Identifier SpeciesName { get; private set; }
 
        [Serialize("", IsPropertySaveable.Yes, description: "Default path for the limb sprite textures. Used only if the limb specific path for the limb is not defined"), Editable]
        public string Texture { get; set; }
        
        [Serialize("1.0,1.0,1.0,1.0", IsPropertySaveable.Yes), Editable()]
        public Color Color { get; set; }
 
        [Serialize(0.0f, IsPropertySaveable.Yes, description: "General orientation of the sprites as drawn on the spritesheet. " +
                                                              "Defines the \"forward direction\" of the sprites. Should be configured as the direction pointing outwards from the main limb. " +
                                                              "Incorrectly defined orientations may lead to limbs being rotated incorrectly when e.g. when the character aims or flips to face a different direction. " +
                                                              "Can be overridden per sprite by setting a value for Limb's 'Sprite Orientation'."), Editable(-360, 360)]
        public float SpritesheetOrientation { get; set; }
 
        public bool IsSpritesheetOrientationHorizontal
        {
            get
            {
                return 
                    (SpritesheetOrientation > 45.0f && SpritesheetOrientation < 135.0f) ||
                    (SpritesheetOrientation > 255.0f && SpritesheetOrientation < 315.0f);
            }
        }
 
        private float limbScale;
        [Serialize(1.0f, IsPropertySaveable.Yes), Editable(MIN_SCALE, MAX_SCALE, DecimalCount = 3)]
        public float LimbScale
        {
            get { return limbScale; }
            set { limbScale = MathHelper.Clamp(value, MIN_SCALE, MAX_SCALE); }
        }
 
        private float jointScale;
        [Serialize(1.0f, IsPropertySaveable.Yes), Editable(MIN_SCALE, MAX_SCALE, DecimalCount = 3)]
        public float JointScale 
        {
            get { return jointScale; } 
            set { jointScale = MathHelper.Clamp(value, MIN_SCALE, MAX_SCALE); }
        }
 
        [Serialize(1f, IsPropertySaveable.No)]
        public float TextureScale { get; set; }
        
        [Serialize(1f, IsPropertySaveable.No)]
        public float SourceRectScale { get; set; }
 
        [Serialize(45f, IsPropertySaveable.Yes, description: "How high from the ground the main collider levitates when the character is standing? Doesn't affect swimming."), Editable(0f, 1000f)]
        public float ColliderHeightFromFloor { get; set; }
 
        [Serialize(50f, IsPropertySaveable.Yes, description: "How much impact is required before the character takes impact damage?"), Editable(MinValueFloat = 0, MaxValueFloat = 1000)]
        public float ImpactTolerance { get; set; }
 
        [Serialize(CanEnterSubmarine.True, IsPropertySaveable.Yes, description: "Can the creature enter submarine. Creatures that cannot enter submarines, always collide with it, even when there is a gap."), Editable()]
        public CanEnterSubmarine CanEnterSubmarine { get; set; }
 
        [Serialize(true, IsPropertySaveable.Yes), Editable]
        public bool CanWalk { get; set; }
        
        [Serialize(true, IsPropertySaveable.Yes, description: "Can the character be dragged around by other creatures?"), Editable()]
        public bool Draggable { get; set; }
 
        [Serialize(LimbType.Torso, IsPropertySaveable.Yes), Editable]
        public LimbType MainLimb { get; set; }
 
        private static readonly Dictionary<Identifier, Dictionary<string, RagdollParams>> allRagdolls = new Dictionary<Identifier, Dictionary<string, RagdollParams>>();
 
        public List<ColliderParams> Colliders { get; private set; } = new List<ColliderParams>();
        public List<LimbParams> Limbs { get; private set; } = new List<LimbParams>();
        public List<JointParams> Joints { get; private set; } = new List<JointParams>();
 
        protected IEnumerable<SubParam> GetAllSubParams() =>
            Colliders
                .Concat<SubParam>(Limbs)
                .Concat(Joints);
 
        public static string GetDefaultFileName(Identifier speciesName) => $"{speciesName.Value.CapitaliseFirstInvariant()}DefaultRagdoll";
        public static string GetDefaultFile(Identifier speciesName, ContentPackage contentPackage = null)
            => IO.Path.Combine(GetFolder(speciesName, contentPackage), $"{GetDefaultFileName(speciesName)}.xml");
 
        public static string GetFolder(Identifier speciesName, ContentPackage contentPackage = null)
        {
            CharacterPrefab prefab = CharacterPrefab.Find(p => p.Identifier == speciesName && (contentPackage == null || p.ContentFile.ContentPackage == contentPackage));
            if (prefab?.ConfigElement == null)
            {
                DebugConsole.ThrowError($"Failed to find config file for '{speciesName}'", contentPackage: contentPackage);
                return string.Empty;
            }
            return GetFolder(prefab.ConfigElement, prefab.ContentFile.Path.Value);
        }
 
        private static string GetFolder(ContentXElement root, string filePath)
        {
            Debug.Assert(filePath != null);
            Debug.Assert(root != null);
            string folder = (root.GetChildElement("ragdolls") ?? root.GetChildElement("ragdoll"))?.GetAttributeContentPath("folder")?.Value;
            if (folder.IsNullOrEmpty() || folder.Equals("default", StringComparison.OrdinalIgnoreCase))
            {
                folder = IO.Path.Combine(IO.Path.GetDirectoryName(filePath), "Ragdolls") + IO.Path.DirectorySeparatorChar;
            }
            return folder.CleanUpPathCrossPlatform(correctFilenameCase: true);
        }
        
        public static T GetDefaultRagdollParams<T>(Character character) where T : RagdollParams, new() => GetDefaultRagdollParams<T>(character.SpeciesName, character.Params, character.Prefab.ContentPackage);
        
        public static T GetDefaultRagdollParams<T>(Identifier speciesName, CharacterParams characterParams, ContentPackage contentPackage) where T : RagdollParams, new()
        {
            XElement mainElement = characterParams.VariantFile?.Root ?? characterParams.MainElement;
            return GetDefaultRagdollParams<T>(speciesName, mainElement, contentPackage);
        }
        
        public static T GetDefaultRagdollParams<T>(Identifier speciesName, XElement characterRootElement, ContentPackage contentPackage) where T : RagdollParams, new()
        {
            Debug.Assert(contentPackage != null);
            if (characterRootElement.IsOverride())
            {
                characterRootElement = characterRootElement.FirstElement();
            }
            Identifier ragdollSpecies = speciesName;
            Identifier variantOf = characterRootElement.VariantOf();
            if (characterRootElement != null && (characterRootElement.GetChildElement("ragdolls") ?? characterRootElement.GetChildElement("ragdoll")) is XElement ragdollElement)
            {
                if ((ragdollElement.GetAttributeContentPath("path", contentPackage) ?? ragdollElement.GetAttributeContentPath("file", contentPackage)) is ContentPath path)
                {
                    return GetRagdollParams<T>(speciesName, ragdollSpecies, file: path, contentPackage);
                }
                else if (!variantOf.IsEmpty)
                {
                    string folder = ragdollElement.GetAttributeContentPath("folder", contentPackage)?.Value;
                    if (folder.IsNullOrEmpty() || folder.Equals("default", StringComparison.OrdinalIgnoreCase))
                    {
                        // Folder attribute not defined or set to default -> use the ragdoll defined in the base definition file.
                        if (CharacterPrefab.FindBySpeciesName(variantOf) is CharacterPrefab prefab)
                        {
                            ragdollSpecies = prefab.GetBaseCharacterSpeciesName(variantOf);
                        }
                    }
                }
            }
            else if (!variantOf.IsEmpty && CharacterPrefab.FindBySpeciesName(variantOf) is CharacterPrefab prefab)
            {
                // Ragdoll element not defined -> use the ragdoll defined in the base definition file.
                ragdollSpecies = prefab.GetBaseCharacterSpeciesName(variantOf);
            }
            // Using a null file definition means we use the default animations found in the Ragdolls folder.
            return GetRagdollParams<T>(speciesName, ragdollSpecies, file: null, contentPackage);
        }
        
        public static T GetRagdollParams<T>(Identifier speciesName, Identifier ragdollSpecies, Either<string, ContentPath> file, ContentPackage contentPackage) where T : RagdollParams, new()
        {
            Debug.Assert(!speciesName.IsEmpty);
            Debug.Assert(!ragdollSpecies.IsEmpty);
            ContentPath contentPath = null;
            string fileName = null;
            if (file != null)
            {
                if (!file.TryGet(out fileName))
                {
                    file.TryGet(out contentPath);
                }
                Debug.Assert(!fileName.IsNullOrWhiteSpace() || !contentPath.IsNullOrWhiteSpace());
            }
            Debug.Assert(contentPackage != null);
            if (!allRagdolls.TryGetValue(speciesName, out Dictionary<string, RagdollParams> ragdolls))
            {
                ragdolls = new Dictionary<string, RagdollParams>();
                allRagdolls.Add(speciesName, ragdolls);
            }
            string key = fileName ?? contentPath?.Value ?? GetDefaultFileName(ragdollSpecies);
            if (ragdolls.TryGetValue(key, out RagdollParams ragdoll))
            {
                // Already cached.
                return (T)ragdoll;
            }
            if (!contentPath.IsNullOrEmpty())
            {
                // Load the ragdoll from path.
                T ragdollInstance = new T();
                if (ragdollInstance.Load(contentPath, ragdollSpecies))
                {
                    ragdolls.TryAdd(contentPath.Value, ragdollInstance);
                    return ragdollInstance;
                }
                else
                {
                    DebugConsole.ThrowError($"[AnimationParams] Failed to load an animation {ragdollInstance} from {contentPath.Value} for the character {speciesName}. Using the default ragdoll.", contentPackage: contentPackage);
                }
            }
            // Seek the default ragdoll from the character's ragdoll folder.
            string selectedFile;
            string folder = GetFolder(ragdollSpecies);
            if (Directory.Exists(folder))
            {
                var files = Directory.GetFiles(folder).OrderBy(f => f, StringComparer.OrdinalIgnoreCase);
                if (files.None())
                {
                    DebugConsole.ThrowError($"[RagdollParams] Could not find any ragdoll files from the folder: {folder}. Using the default ragdoll.", contentPackage: contentPackage);
                    selectedFile = GetDefaultFile(ragdollSpecies);
                }
                else
                {
                    if (string.IsNullOrEmpty(fileName))
                    {
                        // Files found, but none specified -> Get a matching ragdoll from the specified folder.
                        // First try to find a file that matches the default file name. If that fails, just take any file.
                        string defaultFileName = GetDefaultFileName(ragdollSpecies);
                        selectedFile = files.FirstOrDefault(f => f.Contains(defaultFileName, StringComparison.OrdinalIgnoreCase)) ?? files.First();
                    }
                    else
                    {
                        selectedFile = files.FirstOrDefault(f => IO.Path.GetFileNameWithoutExtension(f).Equals(fileName, StringComparison.OrdinalIgnoreCase));
                        if (selectedFile == null)
                        {
                            DebugConsole.ThrowError($"[RagdollParams] Could not find a ragdoll file that matches the name {fileName}. Using the default ragdoll.", contentPackage: contentPackage);
                            selectedFile = GetDefaultFile(ragdollSpecies);
                        }
                    }   
                }
            }
            else
            {
                DebugConsole.ThrowError($"[RagdollParams] Invalid directory: {folder}. Using the default ragdoll.", contentPackage: contentPackage);
                selectedFile = GetDefaultFile(ragdollSpecies);
            }
            
            Debug.Assert(selectedFile != null);
            DebugConsole.Log($"[RagdollParams] Loading the ragdoll from {selectedFile}.");
            T r = new T();
            if (r.Load(ContentPath.FromRaw(contentPackage, selectedFile), speciesName))
            {
                ragdolls.TryAdd(key, r);
            }
            else
            {
                // Failing to create a ragdoll causes so many issues that cannot be handled. Dummy ragdoll just seems to make things harder to debug. It's better to fail early.
                throw new Exception($"[RagdollParams] Failed to load ragdoll {r.Name} from {selectedFile} for the character {speciesName}.");
            }
            return r;
        }
 
        public static T CreateDefault<T>(string fullPath, Identifier speciesName, XElement mainElement) where T : RagdollParams, new()
        {
            // Remove the old ragdolls, if found.
            if (allRagdolls.ContainsKey(speciesName))
            {
                DebugConsole.NewMessage($"[RagdollParams] Removing the old ragdolls from {speciesName}.", Color.Red);
                allRagdolls.Remove(speciesName);
            }
            var ragdolls = new Dictionary<string, RagdollParams>();
            allRagdolls.Add(speciesName, ragdolls);
            var instance = new T
            {
                doc = new XDocument(mainElement)
            };
            var characterPrefab = CharacterPrefab.Prefabs[speciesName];
            var contentPath = ContentPath.FromRaw(characterPrefab.ContentPackage, fullPath);
            instance.UpdatePath(contentPath);
            instance.IsLoaded = instance.Deserialize(mainElement);
            instance.Save();
            instance.Load(contentPath, speciesName);
            ragdolls.Add(instance.FileNameWithoutExtension, instance);
            DebugConsole.NewMessage("[RagdollParams] New default ragdoll params successfully created at " + fullPath, Color.NavajoWhite);
            return instance;
        }
 
        public static void ClearCache() => allRagdolls.Clear();
 
        protected override void UpdatePath(ContentPath fullPath)
        {
            if (SpeciesName == null)
            {
                base.UpdatePath(fullPath);
            }
            else
            {
                // Update the key by removing and re-adding the ragdoll.
                string fileName = FileNameWithoutExtension;
                if (allRagdolls.TryGetValue(SpeciesName, out Dictionary<string, RagdollParams> ragdolls))
                {
                    ragdolls.Remove(fileName);
                }
                base.UpdatePath(fullPath);
                if (ragdolls != null)
                {
                    if (!ragdolls.ContainsKey(fileName))
                    {
                        ragdolls.Add(fileName, this);
                    }
                }
            }
        }
 
        public bool Save(string fileNameWithoutExtension = null)
        {
            OriginalElement = MainElement;
            GetAllSubParams().ForEach(p => p.SetCurrentElementAsOriginalElement());
            Serialize();
            return base.Save(fileNameWithoutExtension, new XmlWriterSettings
            {
                Indent = true,
                OmitXmlDeclaration = true,
                NewLineOnAttributes = false
            });
        }
 
        protected bool Load(ContentPath file, Identifier speciesName)
        {
            if (Load(file))
            {
                isVariantScaleApplied = false;
                SpeciesName = speciesName;
                CreateColliders();
                CreateLimbs();
                CreateJoints();
                return true;
            }
            return false;
        }
 
        public void Apply()
        {
            Serialize();
        }
 
        public override bool Reset(bool forceReload = false)
        {
            if (forceReload)
            {
                return Load(Path, SpeciesName);
            }
            // Don't use recursion, because the reset method might be overriden
            Deserialize(OriginalElement, alsoChildren: false, recursive: false);
            GetAllSubParams().ForEach(sp => sp.Reset());
            return true;
        }
 
        protected void CreateColliders()
        {
            Colliders.Clear();
            if (MainElement?.GetChildElements("collider") is { } colliderElements)
            {
                for (int i = 0; i < colliderElements.Count(); i++)
                {
                    var element = colliderElements.ElementAt(i);
                    string name = i > 0 ? "Secondary Collider" : "Main Collider";
                    Colliders.Add(new ColliderParams(element, this, name));
                }
            }
        }
 
        protected void CreateLimbs()
        {
            Limbs.Clear();
            if (MainElement?.GetChildElements("limb") is { } childElements)
            {
                foreach (var element in childElements)
                {
                    Limbs.Add(new LimbParams(element, this));
                }
            }
            Limbs = Limbs.OrderBy(l => l.ID).ToList();
        }
 
        protected void CreateJoints()
        {
            Joints.Clear();
            foreach (var element in MainElement.GetChildElements("joint"))
            {
                Joints.Add(new JointParams(element, this));
            }
        }
 
        public bool Deserialize(XElement element = null, bool alsoChildren = true, bool recursive = true)
        {
            if (base.Deserialize(element))
            {
                if (alsoChildren)
                {
                    GetAllSubParams().ForEach(p => p.Deserialize(recursive: recursive));
                }
                return true;
            }
            return false;
        }
 
        public bool Serialize(XElement element = null, bool alsoChildren = true, bool recursive = true)
        {
            if (base.Serialize(element))
            {
                if (alsoChildren)
                {
                    GetAllSubParams().ForEach(p => p.Serialize(recursive: recursive));
                }
                return true;
            }
            return false;
        }
 
#if CLIENT
        public void AddToEditor(ParamsEditor editor, bool alsoChildren = true, int space = 0)
        {
            base.AddToEditor(editor);
            if (alsoChildren)
            {
                var subParams = GetAllSubParams();
                foreach (var subParam in subParams)
                {
                    subParam.AddToEditor(editor, true, space);
                }
            }
            if (space > 0)
            {
                new GUIFrame(new RectTransform(new Point(editor.EditorBox.Rect.Width, space), editor.EditorBox.Content.RectTransform), style: null, color: ParamsEditor.Color)
                {
                    CanBeFocused = false
                };
            }
        }
#endif
 
        private bool isVariantScaleApplied;
        public void TryApplyVariantScale(XDocument variantFile)
        {
            if (isVariantScaleApplied) { return; }
            if (variantFile == null) { return; }
            if (variantFile.GetRootExcludingOverride() is XElement root)
            {
                if ((root.GetChildElement("ragdoll") ?? root.GetChildElement("ragdolls")) is XElement ragdollElement)
                {
                    float scaleMultiplier = ragdollElement.GetAttributeFloat("scalemultiplier", 1f);
                    JointScale *= scaleMultiplier;
                    LimbScale *= scaleMultiplier;
                    float textureScale = ragdollElement.GetAttributeFloat(nameof(TextureScale), 0f);
                    if (textureScale > 0)
                    {
                        // Override, if defined.
                        TextureScale = textureScale;
                    }
                    float sourceRectScale = ragdollElement.GetAttributeFloat(nameof(SourceRectScale), 0f);
                    if (sourceRectScale > 0)
                    {
                        // Override, if defined.
                        SourceRectScale = sourceRectScale;
                    }
                }
            }
            isVariantScaleApplied = true;
        }
 
        #endregion
 
        #region Memento
        public Memento<RagdollParams> Memento { get; protected set; } = new Memento<RagdollParams>();
        public void StoreSnapshot()
        {
            Serialize();
            if (doc == null)
            {
                DebugConsole.ThrowError("[RagdollParams] The source XML Document is null!");
                return;
            }
            var copy = new RagdollParams
            {
                SpeciesName = SpeciesName,
                IsLoaded = true,
                doc = new XDocument(doc),
                Path = Path
            };
            copy.CreateColliders();
            copy.CreateLimbs();
            copy.CreateJoints();
            copy.Deserialize();
            copy.Serialize();
            Memento.Store(copy);
        }
        public void Undo() => RevertTo(Memento.Undo());
        public void Redo() => RevertTo(Memento.Redo());
        public void ClearHistory() => Memento.Clear();
 
        private void RevertTo(RagdollParams source)
        {
            if (source.MainElement == null)
            {
                DebugConsole.ThrowError("[RagdollParams] The source XML Element of the given RagdollParams is null!",
                    contentPackage: source.MainElement?.ContentPackage);
                return;
            }
            Deserialize(source.MainElement, alsoChildren: false);
            var sourceSubParams = source.GetAllSubParams().ToList();
            var subParams = GetAllSubParams().ToList();
            // TODO: cannot currently undo joint/limb deletion.
            if (sourceSubParams.Count != subParams.Count)
            {
                DebugConsole.ThrowError("[RagdollParams] The count of the sub params differs! Failed to revert to the previous snapshot! Please reset the ragdoll to undo the changes.",
                    contentPackage: source.MainElement?.ContentPackage);
                return;
            }
            for (int i = 0; i < subParams.Count; i++)
            {
                var subSubParams = subParams[i].SubParams;
                if (subSubParams.Count != sourceSubParams[i].SubParams.Count)
                {
                    DebugConsole.ThrowError("[RagdollParams] The count of the sub sub params differs! Failed to revert to the previous snapshot! Please reset the ragdoll to undo the changes.",
                        contentPackage: source.MainElement?.ContentPackage);
                    return;
                }
                subParams[i].Deserialize(sourceSubParams[i].Element, recursive: false);
                for (int j = 0; j < subSubParams.Count; j++)
                {
                    subSubParams[j].Deserialize(sourceSubParams[i].SubParams[j].Element, recursive: false);
                    // Since we cannot use recursion here, we have to go deeper manually, if necessary.
                }
            }
        }
        #endregion
 
        #region Subparams
        public class JointParams : SubParam
        {
            private string name;
            [Serialize("", IsPropertySaveable.Yes), Editable]
            public override string Name
            {
                get
                {
                    if (string.IsNullOrWhiteSpace(name))
                    {
                        name = GenerateName();
                    }
                    return name;
                }
                set
                {
                    name = value;
                }
            }
 
            public override string GenerateName() => $"Joint {Limb1} - {Limb2}";
 
            [Serialize(-1, IsPropertySaveable.Yes), Editable]
            public int Limb1 { get; set; }
 
            [Serialize(-1, IsPropertySaveable.Yes), Editable]
            public int Limb2 { get; set; }
 
            [Serialize("1.0, 1.0", IsPropertySaveable.Yes, description: "Local position of the joint in the Limb1."), Editable()]
            public Vector2 Limb1Anchor { get; set; }
 
            [Serialize("1.0, 1.0", IsPropertySaveable.Yes, description: "Local position of the joint in the Limb2."), Editable()]
            public Vector2 Limb2Anchor { get; set; }
 
            [Serialize(true, IsPropertySaveable.Yes), Editable]
            public bool CanBeSevered { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes, description:"Default 0 (Can't be severed when the creature is alive). Modifies the severance probability (defined per item/attack) when the character is alive. Currently only affects non-humanoid ragdolls. Also note that if CanBeSevered is false, this property doesn't have any effect."), Editable(MinValueFloat = 0, MaxValueFloat = 10, ValueStep = 0.1f, DecimalCount = 2)]
            public float SeveranceProbabilityModifier { get; set; }
 
            [Serialize("gore", IsPropertySaveable.Yes), Editable]
            public string BreakSound { get; set; }
 
            [Serialize(true, IsPropertySaveable.Yes), Editable]
            public bool LimitEnabled { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable]
            public float UpperLimit { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable]
            public float LowerLimit { get; set; }
 
            [Serialize(0.25f, IsPropertySaveable.Yes), Editable]
            public float Stiffness { get; set; }
 
            [Serialize(1f, IsPropertySaveable.Yes, description: "CAUTION: Not fully implemented. Only use for limb joints that connect non-animated limbs!"), Editable(DecimalCount = 2)]
            public float Scale { get; set; }
 
            [Serialize(false, IsPropertySaveable.No), Editable(ReadOnly = true)]
            public bool WeldJoint { get; set; }
 
            [Serialize(false, IsPropertySaveable.Yes), Editable]
            public bool ClockWiseRotation { get; set; }
 
            public JointParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll) { }
        }
 
        public class LimbParams : SubParam
        {
            public readonly SpriteParams normalSpriteParams;
            public readonly SpriteParams damagedSpriteParams;
            public readonly DeformSpriteParams deformSpriteParams;
            public readonly List<DecorativeSpriteParams> decorativeSpriteParams = new List<DecorativeSpriteParams>();
 
            public AttackParams Attack { get; private set; }
            public SoundParams Sound { get; private set; }
            public LightSourceParams LightSource { get; private set; }
            public List<DamageModifierParams> DamageModifiers { get; private set; } = new List<DamageModifierParams>();
 
            private string name;
            [Serialize("", IsPropertySaveable.Yes), Editable]
            public override string Name
            {
                get
                {
                    if (string.IsNullOrWhiteSpace(name))
                    {
                        name = GenerateName();
                    }
                    return name;
                }
                set
                {
                    name = value;
                }
            }
 
            public override string GenerateName() => Type != LimbType.None ? $"{Type} ({ID})" : $"Limb {ID}";
 
            public SpriteParams GetSprite() => deformSpriteParams ?? normalSpriteParams;
 
            [Serialize(-1, IsPropertySaveable.Yes), Editable(ReadOnly = true)]
            public int ID { get; set; }
 
            [Serialize(LimbType.None, IsPropertySaveable.Yes, description: "The limb type affects many things, like the animations. Torso or Head are considered as the main limbs. Every character should have at least one Torso or Head."), Editable()]
            public LimbType Type { get; set; }
            
            [Serialize(LimbType.None, IsPropertySaveable.Yes, description: "Secondary limb type to be used for generic purposes. Currently only used in climbing animations."), Editable()]
            public LimbType SecondaryType { get; set; }
 
            public float GetSpriteOrientation() => MathHelper.ToRadians(GetSpriteOrientationInDegrees());
 
            public float GetSpriteOrientationInDegrees() => float.IsNaN(SpriteOrientation) ? Ragdoll.SpritesheetOrientation : SpriteOrientation;
 
            [Serialize("", IsPropertySaveable.Yes), Editable]
            public string Notes { get; set; }
 
            [Serialize(1f, IsPropertySaveable.Yes), Editable(DecimalCount = 2)]
            public float Scale { get; set; }
 
            [Serialize(true, IsPropertySaveable.Yes, description: "Does the limb flip when the character flips?"), Editable()]
            public bool Flip { get; set; }
 
            [Serialize(false, IsPropertySaveable.Yes, description: "Currently only works with non-deformable (normal) sprites."), Editable()]
            public bool MirrorVertically { get; set; }
 
            [Serialize(false, IsPropertySaveable.Yes), Editable]
            public bool MirrorHorizontally { get; set; }
 
            [Serialize(false, IsPropertySaveable.Yes, description: "Disable drawing for this limb."), Editable()]
            public bool Hide { get; set; }
            
            [Serialize(float.NaN, IsPropertySaveable.Yes, description: "Orientation of the sprite as drawn on the spritesheet. " +
                                                                       "Defines the \"forward direction\" of the sprite. Should be configured as the direction pointing outwards from the main limb." +
                                                                       "Incorrectly defined orientations may lead to limbs being rotated incorrectly when e.g. when the character aims or flips to face a different direction. " +
                                                                       "Overrides the value of 'Spritesheet Orientation' for this limb."), Editable(-360, 360, ValueStep = 90, DecimalCount = 0)]
            public float SpriteOrientation { get; set; }
 
            [Serialize(LimbType.None, IsPropertySaveable.Yes, description: "If set, the limb sprite will use the same sprite depth as the specified limb. Generally only useful for limbs that get added on the ragdoll on the fly (e.g. extra limbs added via gene splicing).")]
            public LimbType InheritLimbDepth { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable(MinValueFloat = 0, MaxValueFloat = 500)]
            public float SteerForce { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes, description: "Radius of the collider."), Editable(MinValueFloat = 0, MaxValueFloat = 2048)]
            public float Radius { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes, description: "Height of the collider."), Editable(MinValueFloat = 0, MaxValueFloat = 2048)]
            public float Height { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes, description: "Width of the collider."), Editable(MinValueFloat = 0, MaxValueFloat = 2048)]
            public float Width { get; set; }
 
            [Serialize(10f, IsPropertySaveable.Yes, description: "The more the density the heavier the limb is."), Editable(MinValueFloat = 0.01f, MaxValueFloat = 100, DecimalCount = 2)]
            public float Density { get; set; }
 
            [Serialize(false, IsPropertySaveable.Yes), Editable]
            public bool IgnoreCollisions { get; set; }
 
            [Serialize(7f, IsPropertySaveable.Yes, description: "Increasing the damping makes the limb stop rotating more quickly."), Editable]
            public float AngularDamping { get; set; }
 
            [Serialize(1f, IsPropertySaveable.Yes, description: "Higher values make AI characters prefer attacking this limb."), Editable(MinValueFloat = 0.1f, MaxValueFloat = 10)]
            public float AttackPriority { get; set; }
 
            [Serialize("0, 0", IsPropertySaveable.Yes, description: "The position which is used to lead the IK chain to the IK goal. Only applicable if the limb is hand or foot."), Editable()]
            public Vector2 PullPos { get; set; }
 
            [Serialize("0, 0", IsPropertySaveable.Yes, description: "Only applicable if this limb is a foot. Determines the \"neutral position\" of the foot relative to a joint determined by the \"RefJoint\" parameter. For example, a value of {-100, 0} would mean that the foot is positioned on the floor, 100 units behind the reference joint."), Editable()]
            public Vector2 StepOffset { get; set; }
 
            [Serialize(-1, IsPropertySaveable.Yes, description: "The id of the refecence joint. Determines which joint is used as the \"neutral x-position\" for the foot movement. For example in the case of a humanoid-shaped characters this would usually be the waist. The position can be offset using the StepOffset parameter. Only applicable if this limb is a foot."), Editable()]
            public int RefJoint { get; set; }
 
            [Serialize("0, 0", IsPropertySaveable.Yes, description: "Relative offset for the mouth position (starting from the center). Only applicable for LimbType.Head. Used for eating."), Editable(DecimalCount = 2, MinValueFloat = -10f, MaxValueFloat = 10f)]
            public Vector2 MouthPos { get; set; }
            
            [Serialize(50f, IsPropertySaveable.Yes, description: "How much torque is applied on the head while updating the eating animations?"), Editable]
            public float EatTorque { get; set; }
            
            [Serialize(2f, IsPropertySaveable.Yes, description: "How strong a linear impulse is applied on the head while updating the eating animations?"), Editable]
            public float EatImpulse { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable]
            public float ConstantTorque { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable]
            public float ConstantAngle { get; set; }
 
            [Serialize(1f, IsPropertySaveable.Yes), Editable(DecimalCount = 2, MinValueFloat = 0, MaxValueFloat = 10)]
            public float AttackForceMultiplier { get; set; }
 
            [Serialize(1f, IsPropertySaveable.Yes, description:"How much damage must be done by the attack in order to be able to cut off the limb. Note that it's evaluated after the damage modifiers."), Editable(DecimalCount = 0, MinValueFloat = 0, MaxValueFloat = 1000)]
            public float MinSeveranceDamage { get; set; }
 
            [Serialize(true, IsPropertySaveable.Yes, description: "Disable if you don't want to allow severing this joint while the creature is alive. Note: Does nothing if the 'Severance Probability Modifier' in the joint settings is 0 (default). Also note that the setting doesn't override certain limitations, e.g. severing the main limb, or legs of a walking creature is not allowed."), Editable]
            public bool CanBeSeveredAlive { get; set; }
 
            //how long it takes for severed limbs to fade out
            [Serialize(10f, IsPropertySaveable.Yes, "How long it takes for the severed limb to fade out"), Editable(MinValueFloat = 0, MaxValueFloat = 100, ValueStep = 1)]
            public float SeveredFadeOutTime { get; set; } = 10.0f;
 
            [Serialize(false, IsPropertySaveable.Yes, description: "Should the tail angle be applied on this limb? If none of the limbs have been defined to use the angle and an angle is defined in the animation parameters, the first tail limb is used."), Editable]
            public bool ApplyTailAngle { get; set; }
            
            [Serialize(false, IsPropertySaveable.Yes, description: "Should this limb be moved like a tail when swimming? Always true for tail limbs. On tails, disable by setting SineFrequencyMultiplier to 0."), Editable]
            public bool ApplySineMovement { get; set; }
 
            [Serialize(1f, IsPropertySaveable.Yes), Editable(ValueStep = 0.1f, DecimalCount = 2)]
            public float SineFrequencyMultiplier { get; set; }
 
            [Serialize(1f, IsPropertySaveable.Yes), Editable(ValueStep = 0.1f, DecimalCount = 2)]
            public float SineAmplitudeMultiplier { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable(0, 100, ValueStep = 1, DecimalCount = 1)]
            public float BlinkFrequency { get; set; }
 
            [Serialize(0.2f, IsPropertySaveable.Yes), Editable(0.01f, 10, ValueStep = 1, DecimalCount = 2)]
            public float BlinkDurationIn { get; set; }
 
            [Serialize(0.5f, IsPropertySaveable.Yes), Editable(0.01f, 10, ValueStep = 1, DecimalCount = 2)]
            public float BlinkDurationOut { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable(0, 10, ValueStep = 1, DecimalCount = 2)]
            public float BlinkHoldTime { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable(-360, 360, ValueStep = 1, DecimalCount = 0)]
            public float BlinkRotationIn { get; set; }
 
            [Serialize(45f, IsPropertySaveable.Yes), Editable(-360, 360, ValueStep = 1, DecimalCount = 0)]
            public float BlinkRotationOut { get; set; }
 
            [Serialize(50f, IsPropertySaveable.Yes), Editable]
            public float BlinkForce { get; set; }
 
            [Serialize(false, IsPropertySaveable.Yes), Editable]
            public bool OnlyBlinkInWater { get; set; }
 
            [Serialize(false, IsPropertySaveable.Yes), Editable]
            public bool UseTextureOffsetForBlinking { get; set; }
 
            [Serialize("0.5, 0.5", IsPropertySaveable.Yes), Editable(DecimalCount = 2, MinValueFloat = 0f, MaxValueFloat = 1f)]
            public Vector2 BlinkTextureOffsetIn { get; set; }
 
            [Serialize("0.5, 0.5", IsPropertySaveable.Yes), Editable(DecimalCount = 2, MinValueFloat = 0f, MaxValueFloat = 1f)]
            public Vector2 BlinkTextureOffsetOut { get; set; }
 
            [Serialize(TransitionMode.Linear, IsPropertySaveable.Yes), Editable]
            public TransitionMode BlinkTransitionIn { get; private set; }
 
            [Serialize(TransitionMode.Linear, IsPropertySaveable.Yes), Editable]
            public TransitionMode BlinkTransitionOut { get; private set; }
 
            // Non-editable ->
            // TODO: make read-only
            [Serialize(0, IsPropertySaveable.Yes)]
            public int HealthIndex { get; set; }
 
            [Serialize(0.3f, IsPropertySaveable.Yes)]
            public float Friction { get; set; }
 
            [Serialize(0.05f, IsPropertySaveable.Yes)]
            public float Restitution { get; set; }
 
            [Serialize(true, IsPropertySaveable.Yes, description: "Can the limb enter submarines? Only valid if the ragdoll's CanEnterSubmarine is set to Partial, otherwise the limb can enter if the ragdoll can."), Editable]
            public bool CanEnterSubmarine { get; private set; }
 
            public LimbParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll)
            {
                var spriteElement = element.GetChildElement("sprite");
                if (spriteElement != null)
                {
                    normalSpriteParams = new SpriteParams(spriteElement, ragdoll);
                    SubParams.Add(normalSpriteParams);
                }
                var damagedSpriteElement = element.GetChildElement("damagedsprite");
                if (damagedSpriteElement != null)
                {
                    damagedSpriteParams = new SpriteParams(damagedSpriteElement, ragdoll);
                    // Hide the damaged sprite params in the editor for now.
                    //SubParams.Add(damagedSpriteParams);
                }
                var deformSpriteElement = element.GetChildElement("deformablesprite");
                if (deformSpriteElement != null)
                {
                    deformSpriteParams = new DeformSpriteParams(deformSpriteElement, ragdoll);
                    SubParams.Add(deformSpriteParams);
                }
                foreach (var decorativeSpriteElement in element.GetChildElements("decorativesprite"))
                {
                    var decorativeParams = new DecorativeSpriteParams(decorativeSpriteElement, ragdoll);
                    decorativeSpriteParams.Add(decorativeParams);
                    SubParams.Add(decorativeParams);
                }
                var attackElement = element.GetChildElement("attack");
                if (attackElement != null)
                {
                    Attack = new AttackParams(attackElement, ragdoll);
                    SubParams.Add(Attack);
                }
                foreach (var damageElement in element.GetChildElements("damagemodifier"))
                {
                    var damageModifier = new DamageModifierParams(damageElement, ragdoll);
                    DamageModifiers.Add(damageModifier);
                    SubParams.Add(damageModifier);
                }
                var soundElement = element.GetChildElement("sound");
                if (soundElement != null)
                {
                    Sound = new SoundParams(soundElement, ragdoll);
                    SubParams.Add(Sound);
                }
                var lightElement = element.GetChildElement("lightsource");
                if (lightElement != null)
                {
                    LightSource = new LightSourceParams(lightElement, ragdoll);
                    SubParams.Add(LightSource);
                }
            }
 
            public bool AddAttack()
            {
                if (Attack != null) { return false; }
                TryAddSubParam(CreateElement("attack"), (e, c) => new AttackParams(e, c), out AttackParams newAttack);
                Attack = newAttack;
                return Attack != null;
            }
 
 
            public bool AddSound()
            {
                if (Sound != null) { return false; }
                TryAddSubParam(CreateElement("sound"), (e, c) => new SoundParams(e, c), out SoundParams newSound);
                Sound = newSound;
                return Sound != null;
            }
 
            public bool AddLight()
            {
                if (LightSource != null) { return false; }
                var lightSourceElement = CreateElement("lightsource",
                    new XElement("lighttexture", new XAttribute("texture", "Content/Lights/pointlight_bright.png")));
                TryAddSubParam(lightSourceElement, (e, c) => new LightSourceParams(e, c), out LightSourceParams newLightSource);
                LightSource = newLightSource;
                return LightSource != null;
            }
 
            public bool AddDamageModifier() => TryAddSubParam(CreateElement("damagemodifier"), (e, c) => new DamageModifierParams(e, c), out _, DamageModifiers);
 
            public bool RemoveAttack()
            {
                if (RemoveSubParam(Attack))
                {
                    Attack = null;
                    return true;
                }
                return false;
            }
 
            public bool RemoveSound()
            {
                if (RemoveSubParam(Sound))
                {
                    Sound = null;
                    return true;
                }
                return false;
            }
 
            public bool RemoveLight()
            {
                if (RemoveSubParam(LightSource))
                {
                    LightSource = null;
                    return true;
                }
                return false;
            }
 
            public bool RemoveDamageModifier(DamageModifierParams damageModifier) => RemoveSubParam(damageModifier, DamageModifiers);
 
            protected bool TryAddSubParam<T>(ContentXElement element, Func<ContentXElement, RagdollParams, T> constructor, out T subParam, IList<T> collection = null, Func<IList<T>, bool> filter = null) where T : SubParam
            {
                subParam = constructor(element, Ragdoll);
                if (collection != null && filter != null)
                {
                    if (filter(collection)) { return false; }
                }
                Element.Add(element);
                SubParams.Add(subParam);
                collection?.Add(subParam);
                return subParam != null;
            }
 
            protected bool RemoveSubParam<T>(T subParam, IList<T> collection = null) where T : SubParam
            {
                if (subParam == null || subParam.Element == null || subParam.Element.Parent == null) { return false; }
                if (collection != null && !collection.Contains(subParam)) { return false; }
                if (!SubParams.Contains(subParam)) { return false; }
                collection?.Remove(subParam);
                SubParams.Remove(subParam);
                subParam.Element.Remove();
                return true;
            }
        }
 
        public class DecorativeSpriteParams : SpriteParams
        {
            public DecorativeSpriteParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll)
            {
#if CLIENT
                DecorativeSprite = new DecorativeSprite(element);
#endif
            }
 
#if CLIENT
            public DecorativeSprite DecorativeSprite { get; private set; }
 
            public override bool Deserialize(ContentXElement element = null, bool recursive = true)
            {
                base.Deserialize(element, recursive);
                DecorativeSprite.SerializableProperties = SerializableProperty.DeserializeProperties(DecorativeSprite, element ?? Element);
                return SerializableProperties != null;
            }
 
            public override bool Serialize(ContentXElement element = null, bool recursive = true)
            {
                base.Serialize(element, recursive);
                SerializableProperty.SerializeProperties(DecorativeSprite, element ?? Element);
                return true;
            }
 
            public override void Reset()
            {
                base.Reset();
                DecorativeSprite.SerializableProperties = SerializableProperty.DeserializeProperties(DecorativeSprite, OriginalElement);
            }
#endif
        }
 
        public class DeformSpriteParams : SpriteParams
        {
            public DeformationParams Deformation { get; private set; }
 
            public DeformSpriteParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll)
            {
                Deformation = new DeformationParams(element, ragdoll);
                SubParams.Add(Deformation);
            }
        }
 
        public class SpriteParams : SubParam
        {
            [Serialize("0, 0, 0, 0", IsPropertySaveable.Yes), Editable]
            public Rectangle SourceRect { get; set; }
 
            [Serialize("0.5, 0.5", IsPropertySaveable.Yes, description: "The origin of the sprite relative to the collider."), Editable(DecimalCount = 3)]
            public Vector2 Origin { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes, description: "The Z-depth of the limb relative to other limbs of the same character. 1 is front, 0 is behind."), Editable(MinValueFloat = 0, MaxValueFloat = 1, DecimalCount = 3)]
            public float Depth { get; set; }
 
            [Serialize("", IsPropertySaveable.Yes), Editable()]
            public string Texture { get; set; }
 
            [Serialize(false, IsPropertySaveable.Yes), Editable()]
            public bool IgnoreTint { get; set; }
 
            [Serialize("1.0,1.0,1.0,1.0", IsPropertySaveable.Yes), Editable()]
            public Color Color { get; set; }
 
            [Serialize("1.0,1.0,1.0,1.0", IsPropertySaveable.Yes, description: "Target color when the character is dead."), Editable()]
            public Color DeadColor { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes, "How long it takes to fade into the dead color? 0 = Not applied."), Editable(DecimalCount = 1, MinValueFloat = 0, MaxValueFloat = 10)]
            public float DeadColorTime { get; set; }
 
            public override string Name => "Sprite";
 
            public SpriteParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll) { }
 
            public string GetTexturePath() => string.IsNullOrWhiteSpace(Texture) ? Ragdoll.Texture : Texture;
        }
 
        public class DeformationParams : SubParam
        {
            public DeformationParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll)
            {
#if CLIENT
                Deformations = new Dictionary<SpriteDeformationParams, XElement>();
                foreach (var deformationElement in element.GetChildElements("spritedeformation"))
                {
                    string typeName = deformationElement.GetAttributeString("type", null) ?? deformationElement.GetAttributeString("typename", string.Empty);
                    SpriteDeformationParams deformation = null;
                    switch (typeName.ToLowerInvariant())
                    {
                        case "inflate":
                            deformation = new InflateParams(deformationElement);
                            break;
                        case "custom":
                            deformation = new CustomDeformationParams(deformationElement);
                            break;
                        case "noise":
                            deformation = new NoiseDeformationParams(deformationElement);
                            break;
                        case "jointbend":
                        case "bendjoint":
                            deformation = new JointBendDeformationParams(deformationElement);
                            break;
                        case "reacttotriggerers":
                            deformation = new PositionalDeformationParams(deformationElement);
                            break;
                        default:
                            DebugConsole.ThrowError($"SpriteDeformationParams not implemented: '{typeName}'", 
                                contentPackage: element.ContentPackage);
                            break;
                    }
                    if (deformation != null)
                    {
                        deformation.Type = typeName;
                    }
                    Deformations.Add(deformation, deformationElement);
                }
#endif
            }
 
#if CLIENT
            public Dictionary<SpriteDeformationParams, XElement> Deformations { get; private set; }
 
            public override bool Deserialize(ContentXElement element = null, bool recursive = true)
            {
                base.Deserialize(element, recursive);
                Deformations.ForEach(d => d.Key.SerializableProperties = SerializableProperty.DeserializeProperties(d.Key, d.Value));
                return SerializableProperties != null;
            }
 
            public override bool Serialize(ContentXElement element = null, bool recursive = true)
            {
                base.Serialize(element, recursive);
                Deformations.ForEach(d => SerializableProperty.SerializeProperties(d.Key, d.Value));
                return true;
            }
 
            public override void Reset()
            {
                base.Reset();
                Deformations.ForEach(d => d.Key.SerializableProperties = SerializableProperty.DeserializeProperties(d.Key, d.Value));
            }
#endif
        }
 
        public class ColliderParams : SubParam
        {
            private string name;
            [Serialize("", IsPropertySaveable.Yes), Editable]
            public override string Name
            {
                get
                {
                    if (string.IsNullOrWhiteSpace(name))
                    {
                        name = GenerateName();
                    }
                    return name;
                }
                set
                {
                    name = value;
                }
            }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable(MinValueFloat = 0, MaxValueFloat = 2048)]
            public float Radius { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable(MinValueFloat = 0, MaxValueFloat = 2048)]
            public float Height { get; set; }
 
            [Serialize(0f, IsPropertySaveable.Yes), Editable(MinValueFloat = 0, MaxValueFloat = 2048)]
            public float Width { get; set; }
 
            [Serialize(BodyType.Dynamic, IsPropertySaveable.Yes), Editable]
            public BodyType BodyType { get; set; }
 
            public ColliderParams(ContentXElement element, RagdollParams ragdoll, string name = null) : base(element, ragdoll)
            {
                Name = name;
            }
        }
 
        public class LightSourceParams : SubParam
        {
            public class LightTexture : SubParam
            {
                public override string Name => "Light Texture";
 
                [Serialize("Content/Lights/pointlight_bright.png", IsPropertySaveable.Yes), Editable]
                public string Texture { get; private set; }
 
                [Serialize("0.5, 0.5", IsPropertySaveable.Yes), Editable(DecimalCount = 2)]
                public Vector2 Origin { get; set; }
 
                [Serialize("1.0, 1.0", IsPropertySaveable.Yes), Editable(DecimalCount = 2)]
                public Vector2 Size { get; set; }
 
                public LightTexture(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll) { }
            }
 
            public LightTexture Texture { get; private set; }
 
#if CLIENT
            public Lights.LightSourceParams LightSource { get; private set; }
#endif
 
            public LightSourceParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll)
            {
#if CLIENT
                LightSource = new Lights.LightSourceParams(element);
#endif
                var lightTextureElement = element.GetChildElement("lighttexture");
                if (lightTextureElement != null)
                {
                    Texture = new LightTexture(lightTextureElement, ragdoll);
                    SubParams.Add(Texture);
                }
            }
 
#if CLIENT
            public override bool Deserialize(ContentXElement element = null, bool recursive = true)
            {
                base.Deserialize(element, recursive);
                LightSource.Deserialize(element ?? Element);
                return SerializableProperties != null;
            }
 
            public override bool Serialize(ContentXElement element = null, bool recursive = true)
            {
                base.Serialize(element, recursive);
                LightSource.Serialize(element ?? Element);
                return true;
            }
 
            public override void Reset()
            {
                base.Reset();
                LightSource.Serialize(OriginalElement);
            }
#endif
        }
 
        // TODO: conditionals?
        public class AttackParams : SubParam
        {
            public Attack Attack { get; private set; }
 
            public AttackParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll)
            {
                Attack = new Attack(element, ragdoll.SpeciesName.Value);
            }
 
            public override bool Deserialize(ContentXElement element = null, bool recursive = true)
            {
                base.Deserialize(element, recursive);
                Attack.Deserialize(element ?? Element, parentDebugName: Ragdoll?.SpeciesName.ToString() ?? "null");
                return SerializableProperties != null;
            }
 
            public override bool Serialize(ContentXElement element = null, bool recursive = true)
            {
                base.Serialize(element, recursive);
                Attack.Serialize(element ?? Element);
                return true;
            }
 
            public override void Reset()
            {
                base.Reset();
                Attack.Deserialize(OriginalElement, parentDebugName: Ragdoll?.SpeciesName.ToString() ?? "null");
                Attack.ReloadAfflictions(OriginalElement, parentDebugName: Ragdoll?.SpeciesName.ToString() ?? "null");
            }
 
            public bool AddNewAffliction()
            {
                Serialize();
                var subElement = CreateElement("affliction",
                    new XAttribute("identifier", "internaldamage"),
                    new XAttribute("strength", 0f),
                    new XAttribute("probability", 1.0f));
                Element.Add(subElement);
                Attack.ReloadAfflictions(Element, parentDebugName: Ragdoll?.SpeciesName.ToString() ?? "null");
                Serialize();
                return true;
            }
 
            public bool RemoveAffliction(XElement affliction)
            {
                Serialize();
                affliction.Remove();
                Attack.ReloadAfflictions(Element, parentDebugName: Ragdoll?.SpeciesName.ToString() ?? "null");
                return Serialize();
            }
        }
 
        public class DamageModifierParams : SubParam
        {
            public DamageModifier DamageModifier { get; private set; }
 
            public DamageModifierParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll)
            {
                DamageModifier = new DamageModifier(element, ragdoll.SpeciesName.Value);
            }
 
            public override bool Deserialize(ContentXElement element = null, bool recursive = true)
            {
                base.Deserialize(element, recursive);
                DamageModifier.Deserialize(element ?? Element);
                return SerializableProperties != null;
            }
 
            public override bool Serialize(ContentXElement element = null, bool recursive = true)
            {
                base.Serialize(element, recursive);
                DamageModifier.Serialize(element ?? Element);
                return true;
            }
 
            public override void Reset()
            {
                base.Reset();
                DamageModifier.Deserialize(OriginalElement);
            }
        }
 
        public class SoundParams : SubParam
        {
            public override string Name => "Sound";
 
            [Serialize("", IsPropertySaveable.Yes), Editable]
            public string Tag { get; private set; }
 
            public SoundParams(ContentXElement element, RagdollParams ragdoll) : base(element, ragdoll) { }
        }
 
        public abstract class SubParam : ISerializableEntity
        {
            public virtual string Name { get; set; }
            public Dictionary<Identifier, SerializableProperty> SerializableProperties { get; private set; }
            public ContentXElement Element { get; set; }
            public ContentXElement OriginalElement { get; protected set; }
            public List<SubParam> SubParams { get; set; } = new List<SubParam>();
            public RagdollParams Ragdoll { get; private set; }
 
            public virtual string GenerateName() => Element.Name.ToString();
 
            protected ContentXElement CreateElement(string name, params object[] attrs)
                => new XElement(name, attrs).FromPackage(Element.ContentPackage);
            
            public SubParam(ContentXElement element, RagdollParams ragdoll)
            {
                Element = element;
                OriginalElement = new ContentXElement(element.ContentPackage, element);
                Ragdoll = ragdoll;
                SerializableProperties = SerializableProperty.DeserializeProperties(this, element);
            }
 
            public virtual bool Deserialize(ContentXElement element = null, bool recursive = true)
            {
                element ??= Element;
                SerializableProperties = SerializableProperty.DeserializeProperties(this, element);
                if (recursive)
                {
                    SubParams.ForEach(sp => sp.Deserialize(recursive: true));
                }
                return SerializableProperties != null;
            }
 
            public virtual bool Serialize(ContentXElement element = null, bool recursive = true)
            {
                element ??= Element;
                SerializableProperty.SerializeProperties(this, element, true);
                if (recursive)
                {
                    SubParams.ForEach(sp => sp.Serialize(recursive: true));
                }
                return true;
            }
 
            public virtual void SetCurrentElementAsOriginalElement()
            {
                OriginalElement = Element;
                SubParams.ForEach(sp => sp.SetCurrentElementAsOriginalElement());
            }
 
            public virtual void Reset()
            {
                // Don't use recursion, because the reset method might be overriden
                Deserialize(OriginalElement, recursive: false);
                SubParams.ForEach(sp => sp.Reset());
            }
 
#if CLIENT
            public SerializableEntityEditor SerializableEntityEditor { get; protected set; }
            public Dictionary<Affliction, SerializableEntityEditor> AfflictionEditors { get; private set; }
            public virtual void AddToEditor(ParamsEditor editor, bool recursive = true, int space = 0)
            {
                SerializableEntityEditor = new SerializableEntityEditor(editor.EditorBox.Content.RectTransform, this, inGame: false, showName: true, titleFont: GUIStyle.LargeFont);
                if (this is DecorativeSpriteParams decSpriteParams)
                {
                    new SerializableEntityEditor(editor.EditorBox.Content.RectTransform, decSpriteParams.DecorativeSprite, inGame: false, showName: true, titleFont: GUIStyle.LargeFont);
                }
                else if (this is DeformSpriteParams deformSpriteParams)
                {
                    foreach (var deformation in deformSpriteParams.Deformation.Deformations.Keys)
                    {
                        new SerializableEntityEditor(editor.EditorBox.Content.RectTransform, deformation, inGame: false, showName: true, titleFont: GUIStyle.LargeFont);
                    }
                }
                else if (this is AttackParams attackParams)
                {
                    SerializableEntityEditor = new SerializableEntityEditor(editor.EditorBox.Content.RectTransform, attackParams.Attack, inGame: false, showName: true, titleFont: GUIStyle.LargeFont);
                    if (AfflictionEditors == null)
                    {
                        AfflictionEditors = new Dictionary<Affliction, SerializableEntityEditor>();
                    }
                    else
                    {
                        AfflictionEditors.Clear();
                    }
                    foreach (var affliction in attackParams.Attack.Afflictions.Keys)
                    {
                        var afflictionEditor = new SerializableEntityEditor(SerializableEntityEditor.RectTransform, affliction, inGame: false, showName: true);
                        AfflictionEditors.Add(affliction, afflictionEditor);
                        SerializableEntityEditor.AddCustomContent(afflictionEditor, SerializableEntityEditor.ContentCount);
                    }
                }
                else if (this is LightSourceParams lightParams)
                {
                    SerializableEntityEditor = new SerializableEntityEditor(editor.EditorBox.Content.RectTransform, lightParams.LightSource, inGame: false, showName: true, titleFont: GUIStyle.LargeFont);
                }
                else if (this is DamageModifierParams damageModifierParams)
                {
                    SerializableEntityEditor = new SerializableEntityEditor(editor.EditorBox.Content.RectTransform, damageModifierParams.DamageModifier, inGame: false, showName: true, titleFont: GUIStyle.LargeFont);
                }
                if (recursive)
                {
                    SubParams.ForEach(sp => sp.AddToEditor(editor, true));
                }
                if (space > 0)
                {
                    new GUIFrame(new RectTransform(new Point(editor.EditorBox.Rect.Width, space), editor.EditorBox.Content.RectTransform), style: null, color: new Color(20, 20, 20, 255))
                    {
                        CanBeFocused = false
                    };
                }
            }
#endif
        }
        #endregion
    }
}