📝 Add docstrings to buffs-3

Maple2.Database/Context/MetadataContext.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Extensions;
+using Maple2.Database.Extensions;
 using Maple2.Database.Model.Metadata;
 using Maple2.Model.Game.Field;
 using Maple2.Model.Metadata;
@@ -59,6 +59,9 @@ protected override void OnModelCreating(ModelBuilder modelBuilder) {
  modelBuilder.Entity<FunctionCubeMetadata>(ConfigureFunctionCubeMetadata);
  }
 
+ /// <summary>
+ /// Configures the Entity Framework Core mapping for the AdditionalEffectMetadata entity, including table name, composite primary key, and JSON conversion for complex properties.
+ /// </summary>
  private static void ConfigureAdditionalEffectMetadata(EntityTypeBuilder<AdditionalEffectMetadata> builder) {
  builder.ToTable("additional-effect");
  builder.HasKey(effect => new { effect.Id, effect.Level });

Maple2.File.Ingest/Mapper/AdditionalEffectMapper.cs

@@ -1,4 +1,4 @@
-using Maple2.File.IO;
+using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.AdditionalEffect;
 using Maple2.Model.Enum;
@@ -16,6 +16,10 @@ public AdditionalEffectMapper(M2dReader xmlReader) {
  parser = new AdditionalEffectParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed additional effect data into strongly typed <see cref="AdditionalEffectMetadata"/> objects.
+ /// </summary>
+ /// <returns>An enumerable of <see cref="AdditionalEffectMetadata"/> representing all parsed additional effects.</returns>
  protected override IEnumerable<AdditionalEffectMetadata> Map() {
  foreach ((int id, IList<AdditionalEffectData> datas) in parser.Parse()) {
  foreach (AdditionalEffectData data in datas) {
@@ -231,6 +235,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  NotKill: dotDamage.notKill);
  }
 
+ /// <summary>
+ /// Converts a <see cref="DotBuffProperty"/> to a <see cref="AdditionalEffectMetadataDot.DotBuff"/> if the buff ID is positive; otherwise returns null.
+ /// </summary>
+ /// <param name="dotBuff">The DOT buff property to convert.</param>
+ /// <returns>A <see cref="AdditionalEffectMetadataDot.DotBuff"/> instance if valid; otherwise, null.</returns>
  private static AdditionalEffectMetadataDot.DotBuff? Convert(DotBuffProperty? dotBuff) {
  if (dotBuff is not { buffID: > 0 }) {
  return null;
@@ -239,6 +248,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  return new AdditionalEffectMetadataDot.DotBuff(Target: (SkillTargetType) dotBuff.target, Id: dotBuff.buffID, Level: dotBuff.buffLevel);
  }
 
+ /// <summary>
+ /// Converts a <see cref="ShieldProperty"/> to an <see cref="AdditionalEffectMetadataShield"/> if shield values are positive; otherwise returns null.
+ /// </summary>
+ /// <param name="shield">The shield property to convert.</param>
+ /// <returns>An <see cref="AdditionalEffectMetadataShield"/> if applicable; otherwise, null.</returns>
  private static AdditionalEffectMetadataShield? Convert(ShieldProperty shield) {
  if (shield is { hpValue: <= 0, hpByTargetMaxHP: <= 0 }) {
  return null;

Maple2.File.Ingest/Mapper/SkillMapper.cs

@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.Skill;
@@ -14,6 +14,10 @@ public SkillMapper(M2dReader xmlReader) {
  parser = new SkillParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed skill XML data into structured <see cref="StoredSkillMetadata"/> objects, transforming raw skill definitions into strongly typed metadata for further processing.
+ /// </summary>
+ /// <returns>An enumerable sequence of <see cref="StoredSkillMetadata"/> representing all valid skills parsed from the source data.</returns>
  protected override IEnumerable<StoredSkillMetadata> Map() {
  foreach ((int id, string name, SkillData data) in parser.Parse()) {
  if (data.basic == null) continue; // Old_JobChange_01
@@ -133,6 +137,11 @@ protected override IEnumerable<StoredSkillMetadata> Map() {
  }
  }
 
+ /// <summary>
+ /// Converts a <see cref="RegionSkill"/> object into a <see cref="SkillMetadataRange"/>, mapping region type strings to <see cref="SkillRegion"/> values and transferring relevant range properties.
+ /// </summary>
+ /// <param name="region">The region skill data to convert.</param>
+ /// <returns>A <see cref="SkillMetadataRange"/> representing the region's metadata.</returns>
  private static SkillMetadataRange Convert(RegionSkill region) {
  return new SkillMetadataRange(
  Type: region.rangeType switch {

Maple2.File.Ingest/MapperExtensions.cs

@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 using System.Diagnostics;
 using System.Reflection;
 using Maple2.File.Ingest.Utils;
@@ -227,6 +227,11 @@ public static byte OptionIndex(this SpecialAttribute attribute) {
  };
  }
 
+ /// <summary>
+ /// Converts a <see cref="TriggerSkill"/> instance into a <see cref="SkillEffectMetadata"/>, mapping its properties to either a splash or condition effect and assembling the associated skills.
+ /// </summary>
+ /// <param name="trigger">The trigger skill data to convert.</param>
+ /// <returns>A <see cref="SkillEffectMetadata"/> representing the trigger's effect, including splash or condition details and linked skills.</returns>
  public static SkillEffectMetadata Convert(this TriggerSkill trigger) {
  SkillEffectMetadataCondition? condition = null;
  SkillEffectMetadataSplash? splash = null;
@@ -316,6 +321,11 @@ public static SkillMetadataAutoTargeting Convert(this AutoTargeting autoTargetin
  UseMove: autoTargeting.autoTargetUseMove);
  }
 
+ /// <summary>
+ /// Converts a parsed XML skill begin condition into a strongly typed <see cref="BeginCondition"/> metadata object for use in Maple2 game logic.
+ /// </summary>
+ /// <param name="beginCondition">The XML-parsed skill begin condition to convert.</param>
+ /// <returns>A <see cref="BeginCondition"/> instance containing mapped level, gender, mesos, stats, map and skill requirements, job codes, probability, cooldowns, durations, state flags, dungeon group types, weapon requirements, and subconditions for target, owner, and caster.</returns>
  public static BeginCondition Convert(this Maple2.File.Parser.Xml.Skill.BeginCondition beginCondition) {
  return new BeginCondition(
  Level: beginCondition.level,

Maple2.Server.Core/Packets/RequestPacket.cs

@@ -1,4 +1,4 @@
-using Maple2.PacketLib.Tools;
+using Maple2.PacketLib.Tools;
 using Maple2.Server.Core.Constants;
 
 namespace Maple2.Server.Core.Packets;
@@ -8,10 +8,18 @@ public static ByteWriter Login() {
  return Packet.Of(SendOp.RequestLogin);
  }
 
+ /// <summary>
+ /// Creates a packet for requesting a session key from the server.
+ /// </summary>
+ /// <returns>A <see cref="ByteWriter"/> containing the key request packet.</returns>
  public static ByteWriter Key() {
  return Packet.Of(SendOp.RequestKey);
  }
 
+ /// <summary>
+ /// Creates a heartbeat request packet containing the current system tick count.
+ /// </summary>
+ /// <returns>A ByteWriter representing the heartbeat request packet.</returns>
  public static ByteWriter Heartbeat() {
  var pWriter = Packet.Of(SendOp.RequestHeartbeat);
  pWriter.WriteInt(Environment.TickCount);

Maple2.Server.Game/Commands/BuffCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using Maple2.Database.Storage;
@@ -40,6 +40,17 @@ public BuffCommand(GameSession session, SkillMetadataStorage skillStorage) : bas
  this.SetHandler<InvocationContext, int, int, int, int, bool, string, bool>(Handle, id, level, stack, duration, all, target, remove);
  }
 
+ /// <summary>
+ /// Processes the "buff" command to add or remove a specified buff on one or more players in the current field.
+ /// </summary>
+ /// <param name="ctx">The command invocation context.</param>
+ /// <param name="buffId">The ID of the buff to add or remove.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="stack">The number of buff stacks to apply.</param>
+ /// <param name="duration">The duration of the buff in seconds, or -1 for default duration.</param>
+ /// <param name="all">If true, applies the operation to all players in the field.</param>
+ /// <param name="target">The name of the target player to affect, or empty to target the command issuer.</param>
+ /// <param name="remove">If true, removes the buff instead of adding it.</param>
  private void Handle(InvocationContext ctx, int buffId, int level, int stack, int duration, bool all, string target, bool remove) {
  try {
  if (!skillStorage.TryGetEffect(buffId, (short) level, out AdditionalEffectMetadata? _)) {

Maple2.Server.Game/Commands/KillCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.Numerics;
@@ -141,6 +141,12 @@ private void Handle(InvocationContext ctx, string name) {
  }
  }
 
+ /// <summary>
+ /// Instantly kills the specified NPC by applying damage equal to its current health and broadcasts the resulting updates to the field.
+ /// </summary>
+ /// <param name="session">The game session performing the kill action.</param>
+ /// <param name="npc">The NPC to be killed.</param>
+ /// <param name="skill">The skill metadata used to generate the damage record.</param>
  private static void Kill(GameSession session, FieldNpc npc, SkillMetadata skill) {
  var damageRecord = new DamageRecord(skill, skill.Data.Motions[0].Attacks[0]) {
  CasterId = session.Player.ObjectId,

Maple2.Server.Game/Manager/AnimationManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Model.Enum;
+using Maple2.Model.Enum;
 using Maple2.Model.Metadata;
 using Maple2.Server.Core.Packets;
 using Maple2.Server.Game.Model;
@@ -199,7 +199,10 @@ public void CancelSequence() {
  /// <summary>
  /// Updates the animation state based on the current tick count.
  /// </summary>
- /// <param name="tickCount">The current server tick count</param>
+ /// <summary>
+ /// Updates the animation state for the actor based on the current server tick, processing keyframe events, handling looping, and resetting sequences as needed.
+ /// </summary>
+ /// <param name="tickCount">The current server tick count.</param>
  public void Update(long tickCount) {
  // Skip update if no animation metadata is available
  if (RigMetadata is null) {
@@ -349,7 +352,12 @@ public float GetSequenceSegmentTime(string keyframe1, string keyframe2) {
  /// </summary>
  /// <param name="sequenceTime">The current sequence time</param>
  /// <param name="key">The keyframe that was hit</param>
- /// <param name="speed">The current animation speed</param>
+ /// <summary>
+ /// Handles a keyframe event during an animation sequence, triggering actor callbacks and updating loop or end timing based on the keyframe type.
+ /// </summary>
+ /// <param name="sequenceTime">The current normalized time within the animation sequence.</param>
+ /// <param name="key">The animation keyframe being processed.</param>
+ /// <param name="speed">The current animation speed.</param>
  private void HitKeyframe(float sequenceTime, AnimationKey key, float speed) {
  isHandlingKeyframe = true;
 

Maple2.Server.Game/Manager/Config/BuffManager.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Numerics;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
@@ -61,6 +61,9 @@ public void Clear() {
  }
  }
 
+ /// <summary>
+ /// Applies entrance buffs and refreshes premium club buffs for the actor when entering a field.
+ /// </summary>
  public void LoadFieldBuffs() {
  // Lapenshards
  // Game Events
@@ -71,6 +74,18 @@ public void LoadFieldBuffs() {
  }
  }
 
+ /// <summary>
+ /// Adds a buff to the specified owner, handling stacking, duration, cooldowns, group conflicts, and effect application.
+ /// </summary>
+ /// <param name="caster">The actor applying the buff.</param>
+ /// <param name="owner">The actor receiving the buff.</param>
+ /// <param name="id">The buff's skill or effect ID.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="startTick">The tick count when the buff starts.</param>
+ /// <param name="stacks">The number of stacks to apply (clamped to the buff's maximum).</param>
+ /// <param name="durationMs">The duration of the buff in milliseconds. If negative, uses the default duration.</param>
+ /// <param name="notifyField">Whether to broadcast the buff addition to the field.</param>
+ /// <param name="type">The event condition type triggering the buff application.</param>
  public void AddBuff(IActor caster, IActor owner, int id, short level, long startTick, int stacks = 0, int durationMs = -1, bool notifyField = true, EventConditionType type = EventConditionType.Activate) {
  if (!owner.Field.SkillMetadata.TryGetEffect(id, level, out AdditionalEffectMetadata? additionalEffect)) {
  logger.Error("Invalid buff: {SkillId},{Level}", id, level);
@@ -310,6 +325,11 @@ public float TotalCompulsionRate(CompulsionEventType type, int skillId = 0) {
  nestedCompulsionDic.Values.Where(compulsion => compulsion.SkillIds.Contains(skillId)).Sum(compulsion => compulsion.Rate);
  }
 
+ /// <summary>
+ /// Returns the resistance value for the specified attribute, or 0 if not present.
+ /// </summary>
+ /// <param name="attribute">The attribute for which to retrieve resistance.</param>
+ /// <returns>The resistance value for the given attribute, or 0 if none is set.</returns>
  public float GetResistance(BasicAttribute attribute) {
  if (Resistances.TryGetValue(attribute, out float value)) {
  return value;
@@ -318,6 +338,13 @@ public float GetResistance(BasicAttribute attribute) {
  return 0;
  }
 
+ /// <summary>
+ /// Calculates the total invoke value and rate for a specified invoke effect type, filtered by skill ID or skill group.
+ /// </summary>
+ /// <param name="invokeType">The type of invoke effect to aggregate.</param>
+ /// <param name="skillId">The skill ID to match against invoke effects.</param>
+ /// <param name="skillGroup">Optional skill group IDs to match against invoke effects.</param>
+ /// <returns>A tuple containing the total invoke value (as an integer) and the total invoke rate (as a float).</returns>
  public (int, float) GetInvokeValues(InvokeEffectType invokeType, int skillId, params int[] skillGroup) {
  if (!Invokes.TryGetValue(invokeType, out var nestedInvokeDic))
  return (0, 0f);
@@ -335,6 +362,9 @@ public float GetResistance(BasicAttribute attribute) {
  return ((int) value, rate);
  }
 
+ /// <summary>
+ /// Sets the shield health for a buff based on its metadata, using either a fixed value or a percentage of the actor's maximum health.
+ /// </summary>
  private void SetShield(Buff buff) {
  if (buff.Metadata.Shield == null) {
  return;
@@ -369,6 +399,9 @@ private void SetMount(Buff buff) {
  }
  }
 
+ /// <summary>
+ /// Applies update effects from the buff, including canceling specified buffs and resetting skill cooldowns for the actor.
+ /// </summary>
  private void SetUpdates(Buff buff) {
  if (buff.Metadata.Update.Cancel != null) {
  CancelBuffs(buff, buff.Metadata.Update.Cancel);
@@ -381,6 +414,15 @@ private void SetUpdates(Buff buff) {
  }
  }
  }
+ /// <summary>
+ /// Triggers an event for all enabled buffs, causing the owner to apply each buff's effects for the specified event type.
+ /// </summary>
+ /// <param name="caster">The actor who initiated the event.</param>
+ /// <param name="owner">The actor who owns the buffs.</param>
+ /// <param name="target">The target actor affected by the event.</param>
+ /// <param name="type">The event condition type that determines which effects to apply.</param>
+ /// <param name="skillId">Optional skill ID associated with the event.</param>
+ /// <param name="buffId">Optional buff ID associated with the event.</param>
  public void TriggerEvent(IActor caster, IActor owner, IActor target, EventConditionType type, int skillId = 0, int buffId = 0) {
  foreach (Buff buff in EnumerateBuffs()) {
  if (!buff.Enabled) {
@@ -520,6 +562,12 @@ public void Remove(params (int id, int casterId)[] buffIds) {
  }
  }
 
+ /// <summary>
+ /// Removes all buffs with the specified ID and caster ID from the actor, updates resistances, handles related effects, and refreshes stats if necessary.
+ /// </summary>
+ /// <param name="id">The buff ID to remove.</param>
+ /// <param name="casterId">The object ID of the caster whose buffs should be removed.</param>
+ /// <returns>True if the removal process completes.</returns>
  public bool Remove(int id, int casterId) {
  //TODO: Check if buff is removable/should be removed
  bool refreshStats = false;

Maple2.Server.Game/Manager/Config/SkillManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Storage;
+using Maple2.Database.Storage;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
 using Maple2.Model.Metadata;
@@ -30,6 +30,9 @@ public void LoadSkillBook() {
  session.Send(SkillBookPacket.Load(SkillBook));
  }
 
+ /// <summary>
+ /// Applies all passive skill effects that target the player, updating active buffs based on the player's learned passive skills.
+ /// </summary>
  public void UpdatePassiveBuffs(bool notifyField = true) {
  // TODO: Only remove buffs that have been unlearned.
  /*foreach (Buff buff in session.Player.Buffs.Buffs.Values) {

Maple2.Server.Game/Manager/Field/FieldManager/FieldManager.State.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Numerics;
@@ -437,6 +437,10 @@ public void AddSkill(IActor caster, SkillEffectMetadata effect, Vector3[] points
  }
  }
 
+ /// <summary>
+ /// Adds splash skill effects from a skill record, calculating effect positions based on cube magic paths if applicable.
+ /// </summary>
+ /// <param name="record">The skill record containing caster, position, rotation, and attack metadata.</param>
  public void AddSkill(SkillRecord record) {
  SkillMetadataAttack attack = record.Attack;
  if (!TableMetadata.MagicPathTable.Entries.TryGetValue(attack.CubeMagicPathId, out IReadOnlyList<MagicPath>? cubeMagicPaths)) {
@@ -474,6 +478,14 @@ public void AddSkill(SkillRecord record) {
  }
  }
 
+ /// <summary>
+ /// Returns a filtered collection of actors within the specified prisms, based on the target type and limit.
+ /// </summary>
+ /// <param name="prisms">The prisms used to filter actors by location or area.</param>
+ /// <param name="targetType">The type of targets to select (e.g., friendly players, hostile mobs, or hungry mobs).</param>
+ /// <param name="limit">The maximum number of actors to return.</param>
+ /// <param name="ignore">An optional collection of actors to exclude from the results.</param>
+ /// <returns>An enumerable of actors matching the criteria, or an empty collection if the target type is unhandled.</returns>
  public IEnumerable<IActor> GetTargets(Prism[] prisms, ApplyTargetType targetType, int limit, ICollection<IActor>? ignore = null) {
  switch (targetType) {
  case ApplyTargetType.Friendly:

Maple2.Database/Context/MetadataContext.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Extensions;
+using Maple2.Database.Extensions;
 using Maple2.Database.Model.Metadata;
 using Maple2.Model.Game.Field;
 using Maple2.Model.Metadata;
@@ -59,6 +59,9 @@ protected override void OnModelCreating(ModelBuilder modelBuilder) {
  modelBuilder.Entity<FunctionCubeMetadata>(ConfigureFunctionCubeMetadata);
  }
 
+ /// <summary>
+ /// Configures the Entity Framework Core mapping for the AdditionalEffectMetadata entity, including table name, composite primary key, and JSON conversion for complex properties.
+ /// </summary>
  private static void ConfigureAdditionalEffectMetadata(EntityTypeBuilder<AdditionalEffectMetadata> builder) {
  builder.ToTable("additional-effect");
  builder.HasKey(effect => new { effect.Id, effect.Level });

Maple2.File.Ingest/Mapper/AdditionalEffectMapper.cs

@@ -1,4 +1,4 @@
-using Maple2.File.IO;
+using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.AdditionalEffect;
 using Maple2.Model.Enum;
@@ -16,6 +16,10 @@ public AdditionalEffectMapper(M2dReader xmlReader) {
  parser = new AdditionalEffectParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed additional effect data into strongly typed <see cref="AdditionalEffectMetadata"/> objects.
+ /// </summary>
+ /// <returns>An enumerable of <see cref="AdditionalEffectMetadata"/> representing all parsed additional effects.</returns>
  protected override IEnumerable<AdditionalEffectMetadata> Map() {
  foreach ((int id, IList<AdditionalEffectData> datas) in parser.Parse()) {
  foreach (AdditionalEffectData data in datas) {
@@ -231,6 +235,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  NotKill: dotDamage.notKill);
  }
 
+ /// <summary>
+ /// Converts a <see cref="DotBuffProperty"/> to a <see cref="AdditionalEffectMetadataDot.DotBuff"/> if the buff ID is positive; otherwise returns null.
+ /// </summary>
+ /// <param name="dotBuff">The DOT buff property to convert.</param>
+ /// <returns>A <see cref="AdditionalEffectMetadataDot.DotBuff"/> instance if valid; otherwise, null.</returns>
  private static AdditionalEffectMetadataDot.DotBuff? Convert(DotBuffProperty? dotBuff) {
  if (dotBuff is not { buffID: > 0 }) {
  return null;
@@ -239,6 +248,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  return new AdditionalEffectMetadataDot.DotBuff(Target: (SkillTargetType) dotBuff.target, Id: dotBuff.buffID, Level: dotBuff.buffLevel);
  }
 
+ /// <summary>
+ /// Converts a <see cref="ShieldProperty"/> to an <see cref="AdditionalEffectMetadataShield"/> if shield values are positive; otherwise returns null.
+ /// </summary>
+ /// <param name="shield">The shield property to convert.</param>
+ /// <returns>An <see cref="AdditionalEffectMetadataShield"/> if applicable; otherwise, null.</returns>
  private static AdditionalEffectMetadataShield? Convert(ShieldProperty shield) {
  if (shield is { hpValue: <= 0, hpByTargetMaxHP: <= 0 }) {
  return null;

Maple2.File.Ingest/Mapper/SkillMapper.cs

@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.Skill;
@@ -14,6 +14,10 @@ public SkillMapper(M2dReader xmlReader) {
  parser = new SkillParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed skill XML data into structured <see cref="StoredSkillMetadata"/> objects, transforming raw skill definitions into strongly typed metadata for further processing.
+ /// </summary>
+ /// <returns>An enumerable sequence of <see cref="StoredSkillMetadata"/> representing all valid skills parsed from the source data.</returns>
  protected override IEnumerable<StoredSkillMetadata> Map() {
  foreach ((int id, string name, SkillData data) in parser.Parse()) {
  if (data.basic == null) continue; // Old_JobChange_01
@@ -133,6 +137,11 @@ protected override IEnumerable<StoredSkillMetadata> Map() {
  }
  }
 
+ /// <summary>
+ /// Converts a <see cref="RegionSkill"/> object into a <see cref="SkillMetadataRange"/>, mapping region type strings to <see cref="SkillRegion"/> values and transferring relevant range properties.
+ /// </summary>
+ /// <param name="region">The region skill data to convert.</param>
+ /// <returns>A <see cref="SkillMetadataRange"/> representing the region's metadata.</returns>
  private static SkillMetadataRange Convert(RegionSkill region) {
  return new SkillMetadataRange(
  Type: region.rangeType switch {

Maple2.File.Ingest/MapperExtensions.cs

@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 using System.Diagnostics;
 using System.Reflection;
 using Maple2.File.Ingest.Utils;
@@ -227,6 +227,11 @@ public static byte OptionIndex(this SpecialAttribute attribute) {
  };
  }
 
+ /// <summary>
+ /// Converts a <see cref="TriggerSkill"/> instance into a <see cref="SkillEffectMetadata"/>, mapping its properties to either a splash or condition effect and assembling the associated skills.
+ /// </summary>
+ /// <param name="trigger">The trigger skill data to convert.</param>
+ /// <returns>A <see cref="SkillEffectMetadata"/> representing the trigger's effect, including splash or condition details and linked skills.</returns>
  public static SkillEffectMetadata Convert(this TriggerSkill trigger) {
  SkillEffectMetadataCondition? condition = null;
  SkillEffectMetadataSplash? splash = null;
@@ -316,6 +321,11 @@ public static SkillMetadataAutoTargeting Convert(this AutoTargeting autoTargetin
  UseMove: autoTargeting.autoTargetUseMove);
  }
 
+ /// <summary>
+ /// Converts a parsed XML skill begin condition into a strongly typed <see cref="BeginCondition"/> metadata object for use in Maple2 game logic.
+ /// </summary>
+ /// <param name="beginCondition">The XML-parsed skill begin condition to convert.</param>
+ /// <returns>A <see cref="BeginCondition"/> instance containing mapped level, gender, mesos, stats, map and skill requirements, job codes, probability, cooldowns, durations, state flags, dungeon group types, weapon requirements, and subconditions for target, owner, and caster.</returns>
  public static BeginCondition Convert(this Maple2.File.Parser.Xml.Skill.BeginCondition beginCondition) {
  return new BeginCondition(
  Level: beginCondition.level,

Maple2.Server.Core/Packets/RequestPacket.cs

@@ -1,4 +1,4 @@
-using Maple2.PacketLib.Tools;
+using Maple2.PacketLib.Tools;
 using Maple2.Server.Core.Constants;
 
 namespace Maple2.Server.Core.Packets;
@@ -8,10 +8,18 @@ public static ByteWriter Login() {
  return Packet.Of(SendOp.RequestLogin);
  }
 
+ /// <summary>
+ /// Creates a packet for requesting a session key from the server.
+ /// </summary>
+ /// <returns>A <see cref="ByteWriter"/> containing the key request packet.</returns>
  public static ByteWriter Key() {
  return Packet.Of(SendOp.RequestKey);
  }
 
+ /// <summary>
+ /// Creates a heartbeat request packet containing the current system tick count.
+ /// </summary>
+ /// <returns>A ByteWriter representing the heartbeat request packet.</returns>
  public static ByteWriter Heartbeat() {
  var pWriter = Packet.Of(SendOp.RequestHeartbeat);
  pWriter.WriteInt(Environment.TickCount);

Maple2.Server.Game/Commands/BuffCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using Maple2.Database.Storage;
@@ -40,6 +40,17 @@ public BuffCommand(GameSession session, SkillMetadataStorage skillStorage) : bas
  this.SetHandler<InvocationContext, int, int, int, int, bool, string, bool>(Handle, id, level, stack, duration, all, target, remove);
  }
 
+ /// <summary>
+ /// Processes the "buff" command to add or remove a specified buff on one or more players in the current field.
+ /// </summary>
+ /// <param name="ctx">The command invocation context.</param>
+ /// <param name="buffId">The ID of the buff to add or remove.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="stack">The number of buff stacks to apply.</param>
+ /// <param name="duration">The duration of the buff in seconds, or -1 for default duration.</param>
+ /// <param name="all">If true, applies the operation to all players in the field.</param>
+ /// <param name="target">The name of the target player to affect, or empty to target the command issuer.</param>
+ /// <param name="remove">If true, removes the buff instead of adding it.</param>
  private void Handle(InvocationContext ctx, int buffId, int level, int stack, int duration, bool all, string target, bool remove) {
  try {
  if (!skillStorage.TryGetEffect(buffId, (short) level, out AdditionalEffectMetadata? _)) {

Maple2.Server.Game/Commands/KillCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.Numerics;
@@ -141,6 +141,12 @@ private void Handle(InvocationContext ctx, string name) {
  }
  }
 
+ /// <summary>
+ /// Instantly kills the specified NPC by applying damage equal to its current health and broadcasts the resulting updates to the field.
+ /// </summary>
+ /// <param name="session">The game session performing the kill action.</param>
+ /// <param name="npc">The NPC to be killed.</param>
+ /// <param name="skill">The skill metadata used to generate the damage record.</param>
  private static void Kill(GameSession session, FieldNpc npc, SkillMetadata skill) {
  var damageRecord = new DamageRecord(skill, skill.Data.Motions[0].Attacks[0]) {
  CasterId = session.Player.ObjectId,

Maple2.Server.Game/Manager/AnimationManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Model.Enum;
+using Maple2.Model.Enum;
 using Maple2.Model.Metadata;
 using Maple2.Server.Core.Packets;
 using Maple2.Server.Game.Model;
@@ -199,7 +199,10 @@ public void CancelSequence() {
  /// <summary>
  /// Updates the animation state based on the current tick count.
  /// </summary>
- /// <param name="tickCount">The current server tick count</param>
+ /// <summary>
+ /// Updates the animation state for the actor based on the current server tick, processing keyframe events, handling looping, and resetting sequences as needed.
+ /// </summary>
+ /// <param name="tickCount">The current server tick count.</param>
  public void Update(long tickCount) {
  // Skip update if no animation metadata is available
  if (RigMetadata is null) {
@@ -349,7 +352,12 @@ public float GetSequenceSegmentTime(string keyframe1, string keyframe2) {
  /// </summary>
  /// <param name="sequenceTime">The current sequence time</param>
  /// <param name="key">The keyframe that was hit</param>
- /// <param name="speed">The current animation speed</param>
+ /// <summary>
+ /// Handles a keyframe event during an animation sequence, triggering actor callbacks and updating loop or end timing based on the keyframe type.
+ /// </summary>
+ /// <param name="sequenceTime">The current normalized time within the animation sequence.</param>
+ /// <param name="key">The animation keyframe being processed.</param>
+ /// <param name="speed">The current animation speed.</param>
  private void HitKeyframe(float sequenceTime, AnimationKey key, float speed) {
  isHandlingKeyframe = true;
 

Maple2.Server.Game/Manager/Config/BuffManager.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Numerics;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
@@ -61,6 +61,9 @@ public void Clear() {
  }
  }
 
+ /// <summary>
+ /// Applies entrance buffs and refreshes premium club buffs for the actor when entering a field.
+ /// </summary>
  public void LoadFieldBuffs() {
  // Lapenshards
  // Game Events
@@ -71,6 +74,18 @@ public void LoadFieldBuffs() {
  }
  }
 
+ /// <summary>
+ /// Adds a buff to the specified owner, handling stacking, duration, cooldowns, group conflicts, and effect application.
+ /// </summary>
+ /// <param name="caster">The actor applying the buff.</param>
+ /// <param name="owner">The actor receiving the buff.</param>
+ /// <param name="id">The buff's skill or effect ID.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="startTick">The tick count when the buff starts.</param>
+ /// <param name="stacks">The number of stacks to apply (clamped to the buff's maximum).</param>
+ /// <param name="durationMs">The duration of the buff in milliseconds. If negative, uses the default duration.</param>
+ /// <param name="notifyField">Whether to broadcast the buff addition to the field.</param>
+ /// <param name="type">The event condition type triggering the buff application.</param>
  public void AddBuff(IActor caster, IActor owner, int id, short level, long startTick, int stacks = 0, int durationMs = -1, bool notifyField = true, EventConditionType type = EventConditionType.Activate) {
  if (!owner.Field.SkillMetadata.TryGetEffect(id, level, out AdditionalEffectMetadata? additionalEffect)) {
  logger.Error("Invalid buff: {SkillId},{Level}", id, level);
@@ -310,6 +325,11 @@ public float TotalCompulsionRate(CompulsionEventType type, int skillId = 0) {
  nestedCompulsionDic.Values.Where(compulsion => compulsion.SkillIds.Contains(skillId)).Sum(compulsion => compulsion.Rate);
  }
 
+ /// <summary>
+ /// Returns the resistance value for the specified attribute, or 0 if not present.
+ /// </summary>
+ /// <param name="attribute">The attribute for which to retrieve resistance.</param>
+ /// <returns>The resistance value for the given attribute, or 0 if none is set.</returns>
  public float GetResistance(BasicAttribute attribute) {
  if (Resistances.TryGetValue(attribute, out float value)) {
  return value;
@@ -318,6 +338,13 @@ public float GetResistance(BasicAttribute attribute) {
  return 0;
  }
 
+ /// <summary>
+ /// Calculates the total invoke value and rate for a specified invoke effect type, filtered by skill ID or skill group.
+ /// </summary>
+ /// <param name="invokeType">The type of invoke effect to aggregate.</param>
+ /// <param name="skillId">The skill ID to match against invoke effects.</param>
+ /// <param name="skillGroup">Optional skill group IDs to match against invoke effects.</param>
+ /// <returns>A tuple containing the total invoke value (as an integer) and the total invoke rate (as a float).</returns>
  public (int, float) GetInvokeValues(InvokeEffectType invokeType, int skillId, params int[] skillGroup) {
  if (!Invokes.TryGetValue(invokeType, out var nestedInvokeDic))
  return (0, 0f);
@@ -335,6 +362,9 @@ public float GetResistance(BasicAttribute attribute) {
  return ((int) value, rate);
  }
 
+ /// <summary>
+ /// Sets the shield health for a buff based on its metadata, using either a fixed value or a percentage of the actor's maximum health.
+ /// </summary>
  private void SetShield(Buff buff) {
  if (buff.Metadata.Shield == null) {
  return;
@@ -369,6 +399,9 @@ private void SetMount(Buff buff) {
  }
  }
 
+ /// <summary>
+ /// Applies update effects from the buff, including canceling specified buffs and resetting skill cooldowns for the actor.
+ /// </summary>
  private void SetUpdates(Buff buff) {
  if (buff.Metadata.Update.Cancel != null) {
  CancelBuffs(buff, buff.Metadata.Update.Cancel);
@@ -381,6 +414,15 @@ private void SetUpdates(Buff buff) {
  }
  }
  }
+ /// <summary>
+ /// Triggers an event for all enabled buffs, causing the owner to apply each buff's effects for the specified event type.
+ /// </summary>
+ /// <param name="caster">The actor who initiated the event.</param>
+ /// <param name="owner">The actor who owns the buffs.</param>
+ /// <param name="target">The target actor affected by the event.</param>
+ /// <param name="type">The event condition type that determines which effects to apply.</param>
+ /// <param name="skillId">Optional skill ID associated with the event.</param>
+ /// <param name="buffId">Optional buff ID associated with the event.</param>
  public void TriggerEvent(IActor caster, IActor owner, IActor target, EventConditionType type, int skillId = 0, int buffId = 0) {
  foreach (Buff buff in EnumerateBuffs()) {
  if (!buff.Enabled) {
@@ -520,6 +562,12 @@ public void Remove(params (int id, int casterId)[] buffIds) {
  }
  }
 
+ /// <summary>
+ /// Removes all buffs with the specified ID and caster ID from the actor, updates resistances, handles related effects, and refreshes stats if necessary.
+ /// </summary>
+ /// <param name="id">The buff ID to remove.</param>
+ /// <param name="casterId">The object ID of the caster whose buffs should be removed.</param>
+ /// <returns>True if the removal process completes.</returns>
  public bool Remove(int id, int casterId) {
  //TODO: Check if buff is removable/should be removed
  bool refreshStats = false;

Maple2.Server.Game/Manager/Config/SkillManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Storage;
+using Maple2.Database.Storage;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
 using Maple2.Model.Metadata;
@@ -30,6 +30,9 @@ public void LoadSkillBook() {
  session.Send(SkillBookPacket.Load(SkillBook));
  }
 
+ /// <summary>
+ /// Applies all passive skill effects that target the player, updating active buffs based on the player's learned passive skills.
+ /// </summary>
  public void UpdatePassiveBuffs(bool notifyField = true) {
  // TODO: Only remove buffs that have been unlearned.
  /*foreach (Buff buff in session.Player.Buffs.Buffs.Values) {

Maple2.Server.Game/Manager/Field/FieldManager/FieldManager.State.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Numerics;
@@ -437,6 +437,10 @@ public void AddSkill(IActor caster, SkillEffectMetadata effect, Vector3[] points
  }
  }
 
+ /// <summary>
+ /// Adds splash skill effects from a skill record, calculating effect positions based on cube magic paths if applicable.
+ /// </summary>
+ /// <param name="record">The skill record containing caster, position, rotation, and attack metadata.</param>
  public void AddSkill(SkillRecord record) {
  SkillMetadataAttack attack = record.Attack;
  if (!TableMetadata.MagicPathTable.Entries.TryGetValue(attack.CubeMagicPathId, out IReadOnlyList<MagicPath>? cubeMagicPaths)) {
@@ -474,6 +478,14 @@ public void AddSkill(SkillRecord record) {
  }
  }
 
+ /// <summary>
+ /// Returns a filtered collection of actors within the specified prisms, based on the target type and limit.
+ /// </summary>
+ /// <param name="prisms">The prisms used to filter actors by location or area.</param>
+ /// <param name="targetType">The type of targets to select (e.g., friendly players, hostile mobs, or hungry mobs).</param>
+ /// <param name="limit">The maximum number of actors to return.</param>
+ /// <param name="ignore">An optional collection of actors to exclude from the results.</param>
+ /// <returns>An enumerable of actors matching the criteria, or an empty collection if the target type is unhandled.</returns>
  public IEnumerable<IActor> GetTargets(Prism[] prisms, ApplyTargetType targetType, int limit, ICollection<IActor>? ignore = null) {
  switch (targetType) {
  case ApplyTargetType.Friendly:

Maple2.Database/Context/MetadataContext.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Extensions;
+using Maple2.Database.Extensions;
 using Maple2.Database.Model.Metadata;
 using Maple2.Model.Game.Field;
 using Maple2.Model.Metadata;
@@ -59,6 +59,9 @@ protected override void OnModelCreating(ModelBuilder modelBuilder) {
  modelBuilder.Entity<FunctionCubeMetadata>(ConfigureFunctionCubeMetadata);
  }
 
+ /// <summary>
+ /// Configures the Entity Framework Core mapping for the AdditionalEffectMetadata entity, including table name, composite primary key, and JSON conversion for complex properties.
+ /// </summary>
  private static void ConfigureAdditionalEffectMetadata(EntityTypeBuilder<AdditionalEffectMetadata> builder) {
  builder.ToTable("additional-effect");
  builder.HasKey(effect => new { effect.Id, effect.Level });

Maple2.File.Ingest/Mapper/AdditionalEffectMapper.cs

@@ -1,4 +1,4 @@
-using Maple2.File.IO;
+using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.AdditionalEffect;
 using Maple2.Model.Enum;
@@ -16,6 +16,10 @@ public AdditionalEffectMapper(M2dReader xmlReader) {
  parser = new AdditionalEffectParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed additional effect data into strongly typed <see cref="AdditionalEffectMetadata"/> objects.
+ /// </summary>
+ /// <returns>An enumerable of <see cref="AdditionalEffectMetadata"/> representing all parsed additional effects.</returns>
  protected override IEnumerable<AdditionalEffectMetadata> Map() {
  foreach ((int id, IList<AdditionalEffectData> datas) in parser.Parse()) {
  foreach (AdditionalEffectData data in datas) {
@@ -231,6 +235,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  NotKill: dotDamage.notKill);
  }
 
+ /// <summary>
+ /// Converts a <see cref="DotBuffProperty"/> to a <see cref="AdditionalEffectMetadataDot.DotBuff"/> if the buff ID is positive; otherwise returns null.
+ /// </summary>
+ /// <param name="dotBuff">The DOT buff property to convert.</param>
+ /// <returns>A <see cref="AdditionalEffectMetadataDot.DotBuff"/> instance if valid; otherwise, null.</returns>
  private static AdditionalEffectMetadataDot.DotBuff? Convert(DotBuffProperty? dotBuff) {
  if (dotBuff is not { buffID: > 0 }) {
  return null;
@@ -239,6 +248,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  return new AdditionalEffectMetadataDot.DotBuff(Target: (SkillTargetType) dotBuff.target, Id: dotBuff.buffID, Level: dotBuff.buffLevel);
  }
 
+ /// <summary>
+ /// Converts a <see cref="ShieldProperty"/> to an <see cref="AdditionalEffectMetadataShield"/> if shield values are positive; otherwise returns null.
+ /// </summary>
+ /// <param name="shield">The shield property to convert.</param>
+ /// <returns>An <see cref="AdditionalEffectMetadataShield"/> if applicable; otherwise, null.</returns>
  private static AdditionalEffectMetadataShield? Convert(ShieldProperty shield) {
  if (shield is { hpValue: <= 0, hpByTargetMaxHP: <= 0 }) {
  return null;

Maple2.File.Ingest/Mapper/SkillMapper.cs

@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.Skill;
@@ -14,6 +14,10 @@ public SkillMapper(M2dReader xmlReader) {
  parser = new SkillParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed skill XML data into structured <see cref="StoredSkillMetadata"/> objects, transforming raw skill definitions into strongly typed metadata for further processing.
+ /// </summary>
+ /// <returns>An enumerable sequence of <see cref="StoredSkillMetadata"/> representing all valid skills parsed from the source data.</returns>
  protected override IEnumerable<StoredSkillMetadata> Map() {
  foreach ((int id, string name, SkillData data) in parser.Parse()) {
  if (data.basic == null) continue; // Old_JobChange_01
@@ -133,6 +137,11 @@ protected override IEnumerable<StoredSkillMetadata> Map() {
  }
  }
 
+ /// <summary>
+ /// Converts a <see cref="RegionSkill"/> object into a <see cref="SkillMetadataRange"/>, mapping region type strings to <see cref="SkillRegion"/> values and transferring relevant range properties.
+ /// </summary>
+ /// <param name="region">The region skill data to convert.</param>
+ /// <returns>A <see cref="SkillMetadataRange"/> representing the region's metadata.</returns>
  private static SkillMetadataRange Convert(RegionSkill region) {
  return new SkillMetadataRange(
  Type: region.rangeType switch {

Maple2.File.Ingest/MapperExtensions.cs

@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 using System.Diagnostics;
 using System.Reflection;
 using Maple2.File.Ingest.Utils;
@@ -227,6 +227,11 @@ public static byte OptionIndex(this SpecialAttribute attribute) {
  };
  }
 
+ /// <summary>
+ /// Converts a <see cref="TriggerSkill"/> instance into a <see cref="SkillEffectMetadata"/>, mapping its properties to either a splash or condition effect and assembling the associated skills.
+ /// </summary>
+ /// <param name="trigger">The trigger skill data to convert.</param>
+ /// <returns>A <see cref="SkillEffectMetadata"/> representing the trigger's effect, including splash or condition details and linked skills.</returns>
  public static SkillEffectMetadata Convert(this TriggerSkill trigger) {
  SkillEffectMetadataCondition? condition = null;
  SkillEffectMetadataSplash? splash = null;
@@ -316,6 +321,11 @@ public static SkillMetadataAutoTargeting Convert(this AutoTargeting autoTargetin
  UseMove: autoTargeting.autoTargetUseMove);
  }
 
+ /// <summary>
+ /// Converts a parsed XML skill begin condition into a strongly typed <see cref="BeginCondition"/> metadata object for use in Maple2 game logic.
+ /// </summary>
+ /// <param name="beginCondition">The XML-parsed skill begin condition to convert.</param>
+ /// <returns>A <see cref="BeginCondition"/> instance containing mapped level, gender, mesos, stats, map and skill requirements, job codes, probability, cooldowns, durations, state flags, dungeon group types, weapon requirements, and subconditions for target, owner, and caster.</returns>
  public static BeginCondition Convert(this Maple2.File.Parser.Xml.Skill.BeginCondition beginCondition) {
  return new BeginCondition(
  Level: beginCondition.level,

Maple2.Server.Core/Packets/RequestPacket.cs

@@ -1,4 +1,4 @@
-using Maple2.PacketLib.Tools;
+using Maple2.PacketLib.Tools;
 using Maple2.Server.Core.Constants;
 
 namespace Maple2.Server.Core.Packets;
@@ -8,10 +8,18 @@ public static ByteWriter Login() {
  return Packet.Of(SendOp.RequestLogin);
  }
 
+ /// <summary>
+ /// Creates a packet for requesting a session key from the server.
+ /// </summary>
+ /// <returns>A <see cref="ByteWriter"/> containing the key request packet.</returns>
  public static ByteWriter Key() {
  return Packet.Of(SendOp.RequestKey);
  }
 
+ /// <summary>
+ /// Creates a heartbeat request packet containing the current system tick count.
+ /// </summary>
+ /// <returns>A ByteWriter representing the heartbeat request packet.</returns>
  public static ByteWriter Heartbeat() {
  var pWriter = Packet.Of(SendOp.RequestHeartbeat);
  pWriter.WriteInt(Environment.TickCount);

Maple2.Server.Game/Commands/BuffCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using Maple2.Database.Storage;
@@ -40,6 +40,17 @@ public BuffCommand(GameSession session, SkillMetadataStorage skillStorage) : bas
  this.SetHandler<InvocationContext, int, int, int, int, bool, string, bool>(Handle, id, level, stack, duration, all, target, remove);
  }
 
+ /// <summary>
+ /// Processes the "buff" command to add or remove a specified buff on one or more players in the current field.
+ /// </summary>
+ /// <param name="ctx">The command invocation context.</param>
+ /// <param name="buffId">The ID of the buff to add or remove.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="stack">The number of buff stacks to apply.</param>
+ /// <param name="duration">The duration of the buff in seconds, or -1 for default duration.</param>
+ /// <param name="all">If true, applies the operation to all players in the field.</param>
+ /// <param name="target">The name of the target player to affect, or empty to target the command issuer.</param>
+ /// <param name="remove">If true, removes the buff instead of adding it.</param>
  private void Handle(InvocationContext ctx, int buffId, int level, int stack, int duration, bool all, string target, bool remove) {
  try {
  if (!skillStorage.TryGetEffect(buffId, (short) level, out AdditionalEffectMetadata? _)) {

Maple2.Server.Game/Commands/KillCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.Numerics;
@@ -141,6 +141,12 @@ private void Handle(InvocationContext ctx, string name) {
  }
  }
 
+ /// <summary>
+ /// Instantly kills the specified NPC by applying damage equal to its current health and broadcasts the resulting updates to the field.
+ /// </summary>
+ /// <param name="session">The game session performing the kill action.</param>
+ /// <param name="npc">The NPC to be killed.</param>
+ /// <param name="skill">The skill metadata used to generate the damage record.</param>
  private static void Kill(GameSession session, FieldNpc npc, SkillMetadata skill) {
  var damageRecord = new DamageRecord(skill, skill.Data.Motions[0].Attacks[0]) {
  CasterId = session.Player.ObjectId,

Maple2.Server.Game/Manager/AnimationManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Model.Enum;
+using Maple2.Model.Enum;
 using Maple2.Model.Metadata;
 using Maple2.Server.Core.Packets;
 using Maple2.Server.Game.Model;
@@ -199,7 +199,10 @@ public void CancelSequence() {
  /// <summary>
  /// Updates the animation state based on the current tick count.
  /// </summary>
- /// <param name="tickCount">The current server tick count</param>
+ /// <summary>
+ /// Updates the animation state for the actor based on the current server tick, processing keyframe events, handling looping, and resetting sequences as needed.
+ /// </summary>
+ /// <param name="tickCount">The current server tick count.</param>
  public void Update(long tickCount) {
  // Skip update if no animation metadata is available
  if (RigMetadata is null) {
@@ -349,7 +352,12 @@ public float GetSequenceSegmentTime(string keyframe1, string keyframe2) {
  /// </summary>
  /// <param name="sequenceTime">The current sequence time</param>
  /// <param name="key">The keyframe that was hit</param>
- /// <param name="speed">The current animation speed</param>
+ /// <summary>
+ /// Handles a keyframe event during an animation sequence, triggering actor callbacks and updating loop or end timing based on the keyframe type.
+ /// </summary>
+ /// <param name="sequenceTime">The current normalized time within the animation sequence.</param>
+ /// <param name="key">The animation keyframe being processed.</param>
+ /// <param name="speed">The current animation speed.</param>
  private void HitKeyframe(float sequenceTime, AnimationKey key, float speed) {
  isHandlingKeyframe = true;
 

Maple2.Server.Game/Manager/Config/BuffManager.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Numerics;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
@@ -61,6 +61,9 @@ public void Clear() {
  }
  }
 
+ /// <summary>
+ /// Applies entrance buffs and refreshes premium club buffs for the actor when entering a field.
+ /// </summary>
  public void LoadFieldBuffs() {
  // Lapenshards
  // Game Events
@@ -71,6 +74,18 @@ public void LoadFieldBuffs() {
  }
  }
 
+ /// <summary>
+ /// Adds a buff to the specified owner, handling stacking, duration, cooldowns, group conflicts, and effect application.
+ /// </summary>
+ /// <param name="caster">The actor applying the buff.</param>
+ /// <param name="owner">The actor receiving the buff.</param>
+ /// <param name="id">The buff's skill or effect ID.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="startTick">The tick count when the buff starts.</param>
+ /// <param name="stacks">The number of stacks to apply (clamped to the buff's maximum).</param>
+ /// <param name="durationMs">The duration of the buff in milliseconds. If negative, uses the default duration.</param>
+ /// <param name="notifyField">Whether to broadcast the buff addition to the field.</param>
+ /// <param name="type">The event condition type triggering the buff application.</param>
  public void AddBuff(IActor caster, IActor owner, int id, short level, long startTick, int stacks = 0, int durationMs = -1, bool notifyField = true, EventConditionType type = EventConditionType.Activate) {
  if (!owner.Field.SkillMetadata.TryGetEffect(id, level, out AdditionalEffectMetadata? additionalEffect)) {
  logger.Error("Invalid buff: {SkillId},{Level}", id, level);
@@ -310,6 +325,11 @@ public float TotalCompulsionRate(CompulsionEventType type, int skillId = 0) {
  nestedCompulsionDic.Values.Where(compulsion => compulsion.SkillIds.Contains(skillId)).Sum(compulsion => compulsion.Rate);
  }
 
+ /// <summary>
+ /// Returns the resistance value for the specified attribute, or 0 if not present.
+ /// </summary>
+ /// <param name="attribute">The attribute for which to retrieve resistance.</param>
+ /// <returns>The resistance value for the given attribute, or 0 if none is set.</returns>
  public float GetResistance(BasicAttribute attribute) {
  if (Resistances.TryGetValue(attribute, out float value)) {
  return value;
@@ -318,6 +338,13 @@ public float GetResistance(BasicAttribute attribute) {
  return 0;
  }
 
+ /// <summary>
+ /// Calculates the total invoke value and rate for a specified invoke effect type, filtered by skill ID or skill group.
+ /// </summary>
+ /// <param name="invokeType">The type of invoke effect to aggregate.</param>
+ /// <param name="skillId">The skill ID to match against invoke effects.</param>
+ /// <param name="skillGroup">Optional skill group IDs to match against invoke effects.</param>
+ /// <returns>A tuple containing the total invoke value (as an integer) and the total invoke rate (as a float).</returns>
  public (int, float) GetInvokeValues(InvokeEffectType invokeType, int skillId, params int[] skillGroup) {
  if (!Invokes.TryGetValue(invokeType, out var nestedInvokeDic))
  return (0, 0f);
@@ -335,6 +362,9 @@ public float GetResistance(BasicAttribute attribute) {
  return ((int) value, rate);
  }
 
+ /// <summary>
+ /// Sets the shield health for a buff based on its metadata, using either a fixed value or a percentage of the actor's maximum health.
+ /// </summary>
  private void SetShield(Buff buff) {
  if (buff.Metadata.Shield == null) {
  return;
@@ -369,6 +399,9 @@ private void SetMount(Buff buff) {
  }
  }
 
+ /// <summary>
+ /// Applies update effects from the buff, including canceling specified buffs and resetting skill cooldowns for the actor.
+ /// </summary>
  private void SetUpdates(Buff buff) {
  if (buff.Metadata.Update.Cancel != null) {
  CancelBuffs(buff, buff.Metadata.Update.Cancel);
@@ -381,6 +414,15 @@ private void SetUpdates(Buff buff) {
  }
  }
  }
+ /// <summary>
+ /// Triggers an event for all enabled buffs, causing the owner to apply each buff's effects for the specified event type.
+ /// </summary>
+ /// <param name="caster">The actor who initiated the event.</param>
+ /// <param name="owner">The actor who owns the buffs.</param>
+ /// <param name="target">The target actor affected by the event.</param>
+ /// <param name="type">The event condition type that determines which effects to apply.</param>
+ /// <param name="skillId">Optional skill ID associated with the event.</param>
+ /// <param name="buffId">Optional buff ID associated with the event.</param>
  public void TriggerEvent(IActor caster, IActor owner, IActor target, EventConditionType type, int skillId = 0, int buffId = 0) {
  foreach (Buff buff in EnumerateBuffs()) {
  if (!buff.Enabled) {
@@ -520,6 +562,12 @@ public void Remove(params (int id, int casterId)[] buffIds) {
  }
  }
 
+ /// <summary>
+ /// Removes all buffs with the specified ID and caster ID from the actor, updates resistances, handles related effects, and refreshes stats if necessary.
+ /// </summary>
+ /// <param name="id">The buff ID to remove.</param>
+ /// <param name="casterId">The object ID of the caster whose buffs should be removed.</param>
+ /// <returns>True if the removal process completes.</returns>
  public bool Remove(int id, int casterId) {
  //TODO: Check if buff is removable/should be removed
  bool refreshStats = false;

Maple2.Server.Game/Manager/Config/SkillManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Storage;
+using Maple2.Database.Storage;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
 using Maple2.Model.Metadata;
@@ -30,6 +30,9 @@ public void LoadSkillBook() {
  session.Send(SkillBookPacket.Load(SkillBook));
  }
 
+ /// <summary>
+ /// Applies all passive skill effects that target the player, updating active buffs based on the player's learned passive skills.
+ /// </summary>
  public void UpdatePassiveBuffs(bool notifyField = true) {
  // TODO: Only remove buffs that have been unlearned.
  /*foreach (Buff buff in session.Player.Buffs.Buffs.Values) {

Maple2.Server.Game/Manager/Field/FieldManager/FieldManager.State.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Numerics;
@@ -437,6 +437,10 @@ public void AddSkill(IActor caster, SkillEffectMetadata effect, Vector3[] points
  }
  }
 
+ /// <summary>
+ /// Adds splash skill effects from a skill record, calculating effect positions based on cube magic paths if applicable.
+ /// </summary>
+ /// <param name="record">The skill record containing caster, position, rotation, and attack metadata.</param>
  public void AddSkill(SkillRecord record) {
  SkillMetadataAttack attack = record.Attack;
  if (!TableMetadata.MagicPathTable.Entries.TryGetValue(attack.CubeMagicPathId, out IReadOnlyList<MagicPath>? cubeMagicPaths)) {
@@ -474,6 +478,14 @@ public void AddSkill(SkillRecord record) {
  }
  }
 
+ /// <summary>
+ /// Returns a filtered collection of actors within the specified prisms, based on the target type and limit.
+ /// </summary>
+ /// <param name="prisms">The prisms used to filter actors by location or area.</param>
+ /// <param name="targetType">The type of targets to select (e.g., friendly players, hostile mobs, or hungry mobs).</param>
+ /// <param name="limit">The maximum number of actors to return.</param>
+ /// <param name="ignore">An optional collection of actors to exclude from the results.</param>
+ /// <returns>An enumerable of actors matching the criteria, or an empty collection if the target type is unhandled.</returns>
  public IEnumerable<IActor> GetTargets(Prism[] prisms, ApplyTargetType targetType, int limit, ICollection<IActor>? ignore = null) {
  switch (targetType) {
  case ApplyTargetType.Friendly:

Maple2.Database/Context/MetadataContext.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Extensions;
+using Maple2.Database.Extensions;
 using Maple2.Database.Model.Metadata;
 using Maple2.Model.Game.Field;
 using Maple2.Model.Metadata;
@@ -59,6 +59,9 @@ protected override void OnModelCreating(ModelBuilder modelBuilder) {
  modelBuilder.Entity<FunctionCubeMetadata>(ConfigureFunctionCubeMetadata);
  }
 
+ /// <summary>
+ /// Configures the Entity Framework Core mapping for the AdditionalEffectMetadata entity, including table name, composite primary key, and JSON conversion for complex properties.
+ /// </summary>
  private static void ConfigureAdditionalEffectMetadata(EntityTypeBuilder<AdditionalEffectMetadata> builder) {
  builder.ToTable("additional-effect");
  builder.HasKey(effect => new { effect.Id, effect.Level });

Maple2.File.Ingest/Mapper/AdditionalEffectMapper.cs

@@ -1,4 +1,4 @@
-using Maple2.File.IO;
+using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.AdditionalEffect;
 using Maple2.Model.Enum;
@@ -16,6 +16,10 @@ public AdditionalEffectMapper(M2dReader xmlReader) {
  parser = new AdditionalEffectParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed additional effect data into strongly typed <see cref="AdditionalEffectMetadata"/> objects.
+ /// </summary>
+ /// <returns>An enumerable of <see cref="AdditionalEffectMetadata"/> representing all parsed additional effects.</returns>
  protected override IEnumerable<AdditionalEffectMetadata> Map() {
  foreach ((int id, IList<AdditionalEffectData> datas) in parser.Parse()) {
  foreach (AdditionalEffectData data in datas) {
@@ -231,6 +235,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  NotKill: dotDamage.notKill);
  }
 
+ /// <summary>
+ /// Converts a <see cref="DotBuffProperty"/> to a <see cref="AdditionalEffectMetadataDot.DotBuff"/> if the buff ID is positive; otherwise returns null.
+ /// </summary>
+ /// <param name="dotBuff">The DOT buff property to convert.</param>
+ /// <returns>A <see cref="AdditionalEffectMetadataDot.DotBuff"/> instance if valid; otherwise, null.</returns>
  private static AdditionalEffectMetadataDot.DotBuff? Convert(DotBuffProperty? dotBuff) {
  if (dotBuff is not { buffID: > 0 }) {
  return null;
@@ -239,6 +248,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  return new AdditionalEffectMetadataDot.DotBuff(Target: (SkillTargetType) dotBuff.target, Id: dotBuff.buffID, Level: dotBuff.buffLevel);
  }
 
+ /// <summary>
+ /// Converts a <see cref="ShieldProperty"/> to an <see cref="AdditionalEffectMetadataShield"/> if shield values are positive; otherwise returns null.
+ /// </summary>
+ /// <param name="shield">The shield property to convert.</param>
+ /// <returns>An <see cref="AdditionalEffectMetadataShield"/> if applicable; otherwise, null.</returns>
  private static AdditionalEffectMetadataShield? Convert(ShieldProperty shield) {
  if (shield is { hpValue: <= 0, hpByTargetMaxHP: <= 0 }) {
  return null;

Maple2.File.Ingest/Mapper/SkillMapper.cs

@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.Skill;
@@ -14,6 +14,10 @@ public SkillMapper(M2dReader xmlReader) {
  parser = new SkillParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed skill XML data into structured <see cref="StoredSkillMetadata"/> objects, transforming raw skill definitions into strongly typed metadata for further processing.
+ /// </summary>
+ /// <returns>An enumerable sequence of <see cref="StoredSkillMetadata"/> representing all valid skills parsed from the source data.</returns>
  protected override IEnumerable<StoredSkillMetadata> Map() {
  foreach ((int id, string name, SkillData data) in parser.Parse()) {
  if (data.basic == null) continue; // Old_JobChange_01
@@ -133,6 +137,11 @@ protected override IEnumerable<StoredSkillMetadata> Map() {
  }
  }
 
+ /// <summary>
+ /// Converts a <see cref="RegionSkill"/> object into a <see cref="SkillMetadataRange"/>, mapping region type strings to <see cref="SkillRegion"/> values and transferring relevant range properties.
+ /// </summary>
+ /// <param name="region">The region skill data to convert.</param>
+ /// <returns>A <see cref="SkillMetadataRange"/> representing the region's metadata.</returns>
  private static SkillMetadataRange Convert(RegionSkill region) {
  return new SkillMetadataRange(
  Type: region.rangeType switch {

Maple2.File.Ingest/MapperExtensions.cs

@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 using System.Diagnostics;
 using System.Reflection;
 using Maple2.File.Ingest.Utils;
@@ -227,6 +227,11 @@ public static byte OptionIndex(this SpecialAttribute attribute) {
  };
  }
 
+ /// <summary>
+ /// Converts a <see cref="TriggerSkill"/> instance into a <see cref="SkillEffectMetadata"/>, mapping its properties to either a splash or condition effect and assembling the associated skills.
+ /// </summary>
+ /// <param name="trigger">The trigger skill data to convert.</param>
+ /// <returns>A <see cref="SkillEffectMetadata"/> representing the trigger's effect, including splash or condition details and linked skills.</returns>
  public static SkillEffectMetadata Convert(this TriggerSkill trigger) {
  SkillEffectMetadataCondition? condition = null;
  SkillEffectMetadataSplash? splash = null;
@@ -316,6 +321,11 @@ public static SkillMetadataAutoTargeting Convert(this AutoTargeting autoTargetin
  UseMove: autoTargeting.autoTargetUseMove);
  }
 
+ /// <summary>
+ /// Converts a parsed XML skill begin condition into a strongly typed <see cref="BeginCondition"/> metadata object for use in Maple2 game logic.
+ /// </summary>
+ /// <param name="beginCondition">The XML-parsed skill begin condition to convert.</param>
+ /// <returns>A <see cref="BeginCondition"/> instance containing mapped level, gender, mesos, stats, map and skill requirements, job codes, probability, cooldowns, durations, state flags, dungeon group types, weapon requirements, and subconditions for target, owner, and caster.</returns>
  public static BeginCondition Convert(this Maple2.File.Parser.Xml.Skill.BeginCondition beginCondition) {
  return new BeginCondition(
  Level: beginCondition.level,

Maple2.Server.Core/Packets/RequestPacket.cs

@@ -1,4 +1,4 @@
-using Maple2.PacketLib.Tools;
+using Maple2.PacketLib.Tools;
 using Maple2.Server.Core.Constants;
 
 namespace Maple2.Server.Core.Packets;
@@ -8,10 +8,18 @@ public static ByteWriter Login() {
  return Packet.Of(SendOp.RequestLogin);
  }
 
+ /// <summary>
+ /// Creates a packet for requesting a session key from the server.
+ /// </summary>
+ /// <returns>A <see cref="ByteWriter"/> containing the key request packet.</returns>
  public static ByteWriter Key() {
  return Packet.Of(SendOp.RequestKey);
  }
 
+ /// <summary>
+ /// Creates a heartbeat request packet containing the current system tick count.
+ /// </summary>
+ /// <returns>A ByteWriter representing the heartbeat request packet.</returns>
  public static ByteWriter Heartbeat() {
  var pWriter = Packet.Of(SendOp.RequestHeartbeat);
  pWriter.WriteInt(Environment.TickCount);

Maple2.Server.Game/Commands/BuffCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using Maple2.Database.Storage;
@@ -40,6 +40,17 @@ public BuffCommand(GameSession session, SkillMetadataStorage skillStorage) : bas
  this.SetHandler<InvocationContext, int, int, int, int, bool, string, bool>(Handle, id, level, stack, duration, all, target, remove);
  }
 
+ /// <summary>
+ /// Processes the "buff" command to add or remove a specified buff on one or more players in the current field.
+ /// </summary>
+ /// <param name="ctx">The command invocation context.</param>
+ /// <param name="buffId">The ID of the buff to add or remove.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="stack">The number of buff stacks to apply.</param>
+ /// <param name="duration">The duration of the buff in seconds, or -1 for default duration.</param>
+ /// <param name="all">If true, applies the operation to all players in the field.</param>
+ /// <param name="target">The name of the target player to affect, or empty to target the command issuer.</param>
+ /// <param name="remove">If true, removes the buff instead of adding it.</param>
  private void Handle(InvocationContext ctx, int buffId, int level, int stack, int duration, bool all, string target, bool remove) {
  try {
  if (!skillStorage.TryGetEffect(buffId, (short) level, out AdditionalEffectMetadata? _)) {

Maple2.Server.Game/Commands/KillCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.Numerics;
@@ -141,6 +141,12 @@ private void Handle(InvocationContext ctx, string name) {
  }
  }
 
+ /// <summary>
+ /// Instantly kills the specified NPC by applying damage equal to its current health and broadcasts the resulting updates to the field.
+ /// </summary>
+ /// <param name="session">The game session performing the kill action.</param>
+ /// <param name="npc">The NPC to be killed.</param>
+ /// <param name="skill">The skill metadata used to generate the damage record.</param>
  private static void Kill(GameSession session, FieldNpc npc, SkillMetadata skill) {
  var damageRecord = new DamageRecord(skill, skill.Data.Motions[0].Attacks[0]) {
  CasterId = session.Player.ObjectId,

Maple2.Server.Game/Manager/AnimationManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Model.Enum;
+using Maple2.Model.Enum;
 using Maple2.Model.Metadata;
 using Maple2.Server.Core.Packets;
 using Maple2.Server.Game.Model;
@@ -199,7 +199,10 @@ public void CancelSequence() {
  /// <summary>
  /// Updates the animation state based on the current tick count.
  /// </summary>
- /// <param name="tickCount">The current server tick count</param>
+ /// <summary>
+ /// Updates the animation state for the actor based on the current server tick, processing keyframe events, handling looping, and resetting sequences as needed.
+ /// </summary>
+ /// <param name="tickCount">The current server tick count.</param>
  public void Update(long tickCount) {
  // Skip update if no animation metadata is available
  if (RigMetadata is null) {
@@ -349,7 +352,12 @@ public float GetSequenceSegmentTime(string keyframe1, string keyframe2) {
  /// </summary>
  /// <param name="sequenceTime">The current sequence time</param>
  /// <param name="key">The keyframe that was hit</param>
- /// <param name="speed">The current animation speed</param>
+ /// <summary>
+ /// Handles a keyframe event during an animation sequence, triggering actor callbacks and updating loop or end timing based on the keyframe type.
+ /// </summary>
+ /// <param name="sequenceTime">The current normalized time within the animation sequence.</param>
+ /// <param name="key">The animation keyframe being processed.</param>
+ /// <param name="speed">The current animation speed.</param>
  private void HitKeyframe(float sequenceTime, AnimationKey key, float speed) {
  isHandlingKeyframe = true;
 

Maple2.Server.Game/Manager/Config/BuffManager.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Numerics;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
@@ -61,6 +61,9 @@ public void Clear() {
  }
  }
 
+ /// <summary>
+ /// Applies entrance buffs and refreshes premium club buffs for the actor when entering a field.
+ /// </summary>
  public void LoadFieldBuffs() {
  // Lapenshards
  // Game Events
@@ -71,6 +74,18 @@ public void LoadFieldBuffs() {
  }
  }
 
+ /// <summary>
+ /// Adds a buff to the specified owner, handling stacking, duration, cooldowns, group conflicts, and effect application.
+ /// </summary>
+ /// <param name="caster">The actor applying the buff.</param>
+ /// <param name="owner">The actor receiving the buff.</param>
+ /// <param name="id">The buff's skill or effect ID.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="startTick">The tick count when the buff starts.</param>
+ /// <param name="stacks">The number of stacks to apply (clamped to the buff's maximum).</param>
+ /// <param name="durationMs">The duration of the buff in milliseconds. If negative, uses the default duration.</param>
+ /// <param name="notifyField">Whether to broadcast the buff addition to the field.</param>
+ /// <param name="type">The event condition type triggering the buff application.</param>
  public void AddBuff(IActor caster, IActor owner, int id, short level, long startTick, int stacks = 0, int durationMs = -1, bool notifyField = true, EventConditionType type = EventConditionType.Activate) {
  if (!owner.Field.SkillMetadata.TryGetEffect(id, level, out AdditionalEffectMetadata? additionalEffect)) {
  logger.Error("Invalid buff: {SkillId},{Level}", id, level);
@@ -310,6 +325,11 @@ public float TotalCompulsionRate(CompulsionEventType type, int skillId = 0) {
  nestedCompulsionDic.Values.Where(compulsion => compulsion.SkillIds.Contains(skillId)).Sum(compulsion => compulsion.Rate);
  }
 
+ /// <summary>
+ /// Returns the resistance value for the specified attribute, or 0 if not present.
+ /// </summary>
+ /// <param name="attribute">The attribute for which to retrieve resistance.</param>
+ /// <returns>The resistance value for the given attribute, or 0 if none is set.</returns>
  public float GetResistance(BasicAttribute attribute) {
  if (Resistances.TryGetValue(attribute, out float value)) {
  return value;
@@ -318,6 +338,13 @@ public float GetResistance(BasicAttribute attribute) {
  return 0;
  }
 
+ /// <summary>
+ /// Calculates the total invoke value and rate for a specified invoke effect type, filtered by skill ID or skill group.
+ /// </summary>
+ /// <param name="invokeType">The type of invoke effect to aggregate.</param>
+ /// <param name="skillId">The skill ID to match against invoke effects.</param>
+ /// <param name="skillGroup">Optional skill group IDs to match against invoke effects.</param>
+ /// <returns>A tuple containing the total invoke value (as an integer) and the total invoke rate (as a float).</returns>
  public (int, float) GetInvokeValues(InvokeEffectType invokeType, int skillId, params int[] skillGroup) {
  if (!Invokes.TryGetValue(invokeType, out var nestedInvokeDic))
  return (0, 0f);
@@ -335,6 +362,9 @@ public float GetResistance(BasicAttribute attribute) {
  return ((int) value, rate);
  }
 
+ /// <summary>
+ /// Sets the shield health for a buff based on its metadata, using either a fixed value or a percentage of the actor's maximum health.
+ /// </summary>
  private void SetShield(Buff buff) {
  if (buff.Metadata.Shield == null) {
  return;
@@ -369,6 +399,9 @@ private void SetMount(Buff buff) {
  }
  }
 
+ /// <summary>
+ /// Applies update effects from the buff, including canceling specified buffs and resetting skill cooldowns for the actor.
+ /// </summary>
  private void SetUpdates(Buff buff) {
  if (buff.Metadata.Update.Cancel != null) {
  CancelBuffs(buff, buff.Metadata.Update.Cancel);
@@ -381,6 +414,15 @@ private void SetUpdates(Buff buff) {
  }
  }
  }
+ /// <summary>
+ /// Triggers an event for all enabled buffs, causing the owner to apply each buff's effects for the specified event type.
+ /// </summary>
+ /// <param name="caster">The actor who initiated the event.</param>
+ /// <param name="owner">The actor who owns the buffs.</param>
+ /// <param name="target">The target actor affected by the event.</param>
+ /// <param name="type">The event condition type that determines which effects to apply.</param>
+ /// <param name="skillId">Optional skill ID associated with the event.</param>
+ /// <param name="buffId">Optional buff ID associated with the event.</param>
  public void TriggerEvent(IActor caster, IActor owner, IActor target, EventConditionType type, int skillId = 0, int buffId = 0) {
  foreach (Buff buff in EnumerateBuffs()) {
  if (!buff.Enabled) {
@@ -520,6 +562,12 @@ public void Remove(params (int id, int casterId)[] buffIds) {
  }
  }
 
+ /// <summary>
+ /// Removes all buffs with the specified ID and caster ID from the actor, updates resistances, handles related effects, and refreshes stats if necessary.
+ /// </summary>
+ /// <param name="id">The buff ID to remove.</param>
+ /// <param name="casterId">The object ID of the caster whose buffs should be removed.</param>
+ /// <returns>True if the removal process completes.</returns>
  public bool Remove(int id, int casterId) {
  //TODO: Check if buff is removable/should be removed
  bool refreshStats = false;

Maple2.Server.Game/Manager/Config/SkillManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Storage;
+using Maple2.Database.Storage;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
 using Maple2.Model.Metadata;
@@ -30,6 +30,9 @@ public void LoadSkillBook() {
  session.Send(SkillBookPacket.Load(SkillBook));
  }
 
+ /// <summary>
+ /// Applies all passive skill effects that target the player, updating active buffs based on the player's learned passive skills.
+ /// </summary>
  public void UpdatePassiveBuffs(bool notifyField = true) {
  // TODO: Only remove buffs that have been unlearned.
  /*foreach (Buff buff in session.Player.Buffs.Buffs.Values) {

Maple2.Server.Game/Manager/Field/FieldManager/FieldManager.State.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Numerics;
@@ -437,6 +437,10 @@ public void AddSkill(IActor caster, SkillEffectMetadata effect, Vector3[] points
  }
  }
 
+ /// <summary>
+ /// Adds splash skill effects from a skill record, calculating effect positions based on cube magic paths if applicable.
+ /// </summary>
+ /// <param name="record">The skill record containing caster, position, rotation, and attack metadata.</param>
  public void AddSkill(SkillRecord record) {
  SkillMetadataAttack attack = record.Attack;
  if (!TableMetadata.MagicPathTable.Entries.TryGetValue(attack.CubeMagicPathId, out IReadOnlyList<MagicPath>? cubeMagicPaths)) {
@@ -474,6 +478,14 @@ public void AddSkill(SkillRecord record) {
  }
  }
 
+ /// <summary>
+ /// Returns a filtered collection of actors within the specified prisms, based on the target type and limit.
+ /// </summary>
+ /// <param name="prisms">The prisms used to filter actors by location or area.</param>
+ /// <param name="targetType">The type of targets to select (e.g., friendly players, hostile mobs, or hungry mobs).</param>
+ /// <param name="limit">The maximum number of actors to return.</param>
+ /// <param name="ignore">An optional collection of actors to exclude from the results.</param>
+ /// <returns>An enumerable of actors matching the criteria, or an empty collection if the target type is unhandled.</returns>
  public IEnumerable<IActor> GetTargets(Prism[] prisms, ApplyTargetType targetType, int limit, ICollection<IActor>? ignore = null) {
  switch (targetType) {
  case ApplyTargetType.Friendly:

Maple2.Database/Context/MetadataContext.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Extensions;
+using Maple2.Database.Extensions;
 using Maple2.Database.Model.Metadata;
 using Maple2.Model.Game.Field;
 using Maple2.Model.Metadata;
@@ -59,6 +59,9 @@ protected override void OnModelCreating(ModelBuilder modelBuilder) {
  modelBuilder.Entity<FunctionCubeMetadata>(ConfigureFunctionCubeMetadata);
  }
 
+ /// <summary>
+ /// Configures the Entity Framework Core mapping for the AdditionalEffectMetadata entity, including table name, composite primary key, and JSON conversion for complex properties.
+ /// </summary>
  private static void ConfigureAdditionalEffectMetadata(EntityTypeBuilder<AdditionalEffectMetadata> builder) {
  builder.ToTable("additional-effect");
  builder.HasKey(effect => new { effect.Id, effect.Level });

Maple2.File.Ingest/Mapper/AdditionalEffectMapper.cs

@@ -1,4 +1,4 @@
-using Maple2.File.IO;
+using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.AdditionalEffect;
 using Maple2.Model.Enum;
@@ -16,6 +16,10 @@ public AdditionalEffectMapper(M2dReader xmlReader) {
  parser = new AdditionalEffectParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed additional effect data into strongly typed <see cref="AdditionalEffectMetadata"/> objects.
+ /// </summary>
+ /// <returns>An enumerable of <see cref="AdditionalEffectMetadata"/> representing all parsed additional effects.</returns>
  protected override IEnumerable<AdditionalEffectMetadata> Map() {
  foreach ((int id, IList<AdditionalEffectData> datas) in parser.Parse()) {
  foreach (AdditionalEffectData data in datas) {
@@ -231,6 +235,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  NotKill: dotDamage.notKill);
  }
 
+ /// <summary>
+ /// Converts a <see cref="DotBuffProperty"/> to a <see cref="AdditionalEffectMetadataDot.DotBuff"/> if the buff ID is positive; otherwise returns null.
+ /// </summary>
+ /// <param name="dotBuff">The DOT buff property to convert.</param>
+ /// <returns>A <see cref="AdditionalEffectMetadataDot.DotBuff"/> instance if valid; otherwise, null.</returns>
  private static AdditionalEffectMetadataDot.DotBuff? Convert(DotBuffProperty? dotBuff) {
  if (dotBuff is not { buffID: > 0 }) {
  return null;
@@ -239,6 +248,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  return new AdditionalEffectMetadataDot.DotBuff(Target: (SkillTargetType) dotBuff.target, Id: dotBuff.buffID, Level: dotBuff.buffLevel);
  }
 
+ /// <summary>
+ /// Converts a <see cref="ShieldProperty"/> to an <see cref="AdditionalEffectMetadataShield"/> if shield values are positive; otherwise returns null.
+ /// </summary>
+ /// <param name="shield">The shield property to convert.</param>
+ /// <returns>An <see cref="AdditionalEffectMetadataShield"/> if applicable; otherwise, null.</returns>
  private static AdditionalEffectMetadataShield? Convert(ShieldProperty shield) {
  if (shield is { hpValue: <= 0, hpByTargetMaxHP: <= 0 }) {
  return null;

Maple2.File.Ingest/Mapper/SkillMapper.cs

@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.Skill;
@@ -14,6 +14,10 @@ public SkillMapper(M2dReader xmlReader) {
  parser = new SkillParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed skill XML data into structured <see cref="StoredSkillMetadata"/> objects, transforming raw skill definitions into strongly typed metadata for further processing.
+ /// </summary>
+ /// <returns>An enumerable sequence of <see cref="StoredSkillMetadata"/> representing all valid skills parsed from the source data.</returns>
  protected override IEnumerable<StoredSkillMetadata> Map() {
  foreach ((int id, string name, SkillData data) in parser.Parse()) {
  if (data.basic == null) continue; // Old_JobChange_01
@@ -133,6 +137,11 @@ protected override IEnumerable<StoredSkillMetadata> Map() {
  }
  }
 
+ /// <summary>
+ /// Converts a <see cref="RegionSkill"/> object into a <see cref="SkillMetadataRange"/>, mapping region type strings to <see cref="SkillRegion"/> values and transferring relevant range properties.
+ /// </summary>
+ /// <param name="region">The region skill data to convert.</param>
+ /// <returns>A <see cref="SkillMetadataRange"/> representing the region's metadata.</returns>
  private static SkillMetadataRange Convert(RegionSkill region) {
  return new SkillMetadataRange(
  Type: region.rangeType switch {

Maple2.File.Ingest/MapperExtensions.cs

@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 using System.Diagnostics;
 using System.Reflection;
 using Maple2.File.Ingest.Utils;
@@ -227,6 +227,11 @@ public static byte OptionIndex(this SpecialAttribute attribute) {
  };
  }
 
+ /// <summary>
+ /// Converts a <see cref="TriggerSkill"/> instance into a <see cref="SkillEffectMetadata"/>, mapping its properties to either a splash or condition effect and assembling the associated skills.
+ /// </summary>
+ /// <param name="trigger">The trigger skill data to convert.</param>
+ /// <returns>A <see cref="SkillEffectMetadata"/> representing the trigger's effect, including splash or condition details and linked skills.</returns>
  public static SkillEffectMetadata Convert(this TriggerSkill trigger) {
  SkillEffectMetadataCondition? condition = null;
  SkillEffectMetadataSplash? splash = null;
@@ -316,6 +321,11 @@ public static SkillMetadataAutoTargeting Convert(this AutoTargeting autoTargetin
  UseMove: autoTargeting.autoTargetUseMove);
  }
 
+ /// <summary>
+ /// Converts a parsed XML skill begin condition into a strongly typed <see cref="BeginCondition"/> metadata object for use in Maple2 game logic.
+ /// </summary>
+ /// <param name="beginCondition">The XML-parsed skill begin condition to convert.</param>
+ /// <returns>A <see cref="BeginCondition"/> instance containing mapped level, gender, mesos, stats, map and skill requirements, job codes, probability, cooldowns, durations, state flags, dungeon group types, weapon requirements, and subconditions for target, owner, and caster.</returns>
  public static BeginCondition Convert(this Maple2.File.Parser.Xml.Skill.BeginCondition beginCondition) {
  return new BeginCondition(
  Level: beginCondition.level,

Maple2.Server.Core/Packets/RequestPacket.cs

@@ -1,4 +1,4 @@
-using Maple2.PacketLib.Tools;
+using Maple2.PacketLib.Tools;
 using Maple2.Server.Core.Constants;
 
 namespace Maple2.Server.Core.Packets;
@@ -8,10 +8,18 @@ public static ByteWriter Login() {
  return Packet.Of(SendOp.RequestLogin);
  }
 
+ /// <summary>
+ /// Creates a packet for requesting a session key from the server.
+ /// </summary>
+ /// <returns>A <see cref="ByteWriter"/> containing the key request packet.</returns>
  public static ByteWriter Key() {
  return Packet.Of(SendOp.RequestKey);
  }
 
+ /// <summary>
+ /// Creates a heartbeat request packet containing the current system tick count.
+ /// </summary>
+ /// <returns>A ByteWriter representing the heartbeat request packet.</returns>
  public static ByteWriter Heartbeat() {
  var pWriter = Packet.Of(SendOp.RequestHeartbeat);
  pWriter.WriteInt(Environment.TickCount);

Maple2.Server.Game/Commands/BuffCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using Maple2.Database.Storage;
@@ -40,6 +40,17 @@ public BuffCommand(GameSession session, SkillMetadataStorage skillStorage) : bas
  this.SetHandler<InvocationContext, int, int, int, int, bool, string, bool>(Handle, id, level, stack, duration, all, target, remove);
  }
 
+ /// <summary>
+ /// Processes the "buff" command to add or remove a specified buff on one or more players in the current field.
+ /// </summary>
+ /// <param name="ctx">The command invocation context.</param>
+ /// <param name="buffId">The ID of the buff to add or remove.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="stack">The number of buff stacks to apply.</param>
+ /// <param name="duration">The duration of the buff in seconds, or -1 for default duration.</param>
+ /// <param name="all">If true, applies the operation to all players in the field.</param>
+ /// <param name="target">The name of the target player to affect, or empty to target the command issuer.</param>
+ /// <param name="remove">If true, removes the buff instead of adding it.</param>
  private void Handle(InvocationContext ctx, int buffId, int level, int stack, int duration, bool all, string target, bool remove) {
  try {
  if (!skillStorage.TryGetEffect(buffId, (short) level, out AdditionalEffectMetadata? _)) {

Maple2.Server.Game/Commands/KillCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.Numerics;
@@ -141,6 +141,12 @@ private void Handle(InvocationContext ctx, string name) {
  }
  }
 
+ /// <summary>
+ /// Instantly kills the specified NPC by applying damage equal to its current health and broadcasts the resulting updates to the field.
+ /// </summary>
+ /// <param name="session">The game session performing the kill action.</param>
+ /// <param name="npc">The NPC to be killed.</param>
+ /// <param name="skill">The skill metadata used to generate the damage record.</param>
  private static void Kill(GameSession session, FieldNpc npc, SkillMetadata skill) {
  var damageRecord = new DamageRecord(skill, skill.Data.Motions[0].Attacks[0]) {
  CasterId = session.Player.ObjectId,

Maple2.Server.Game/Manager/AnimationManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Model.Enum;
+using Maple2.Model.Enum;
 using Maple2.Model.Metadata;
 using Maple2.Server.Core.Packets;
 using Maple2.Server.Game.Model;
@@ -199,7 +199,10 @@ public void CancelSequence() {
  /// <summary>
  /// Updates the animation state based on the current tick count.
  /// </summary>
- /// <param name="tickCount">The current server tick count</param>
+ /// <summary>
+ /// Updates the animation state for the actor based on the current server tick, processing keyframe events, handling looping, and resetting sequences as needed.
+ /// </summary>
+ /// <param name="tickCount">The current server tick count.</param>
  public void Update(long tickCount) {
  // Skip update if no animation metadata is available
  if (RigMetadata is null) {
@@ -349,7 +352,12 @@ public float GetSequenceSegmentTime(string keyframe1, string keyframe2) {
  /// </summary>
  /// <param name="sequenceTime">The current sequence time</param>
  /// <param name="key">The keyframe that was hit</param>
- /// <param name="speed">The current animation speed</param>
+ /// <summary>
+ /// Handles a keyframe event during an animation sequence, triggering actor callbacks and updating loop or end timing based on the keyframe type.
+ /// </summary>
+ /// <param name="sequenceTime">The current normalized time within the animation sequence.</param>
+ /// <param name="key">The animation keyframe being processed.</param>
+ /// <param name="speed">The current animation speed.</param>
  private void HitKeyframe(float sequenceTime, AnimationKey key, float speed) {
  isHandlingKeyframe = true;
 

Maple2.Server.Game/Manager/Config/BuffManager.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Numerics;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
@@ -61,6 +61,9 @@ public void Clear() {
  }
  }
 
+ /// <summary>
+ /// Applies entrance buffs and refreshes premium club buffs for the actor when entering a field.
+ /// </summary>
  public void LoadFieldBuffs() {
  // Lapenshards
  // Game Events
@@ -71,6 +74,18 @@ public void LoadFieldBuffs() {
  }
  }
 
+ /// <summary>
+ /// Adds a buff to the specified owner, handling stacking, duration, cooldowns, group conflicts, and effect application.
+ /// </summary>
+ /// <param name="caster">The actor applying the buff.</param>
+ /// <param name="owner">The actor receiving the buff.</param>
+ /// <param name="id">The buff's skill or effect ID.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="startTick">The tick count when the buff starts.</param>
+ /// <param name="stacks">The number of stacks to apply (clamped to the buff's maximum).</param>
+ /// <param name="durationMs">The duration of the buff in milliseconds. If negative, uses the default duration.</param>
+ /// <param name="notifyField">Whether to broadcast the buff addition to the field.</param>
+ /// <param name="type">The event condition type triggering the buff application.</param>
  public void AddBuff(IActor caster, IActor owner, int id, short level, long startTick, int stacks = 0, int durationMs = -1, bool notifyField = true, EventConditionType type = EventConditionType.Activate) {
  if (!owner.Field.SkillMetadata.TryGetEffect(id, level, out AdditionalEffectMetadata? additionalEffect)) {
  logger.Error("Invalid buff: {SkillId},{Level}", id, level);
@@ -310,6 +325,11 @@ public float TotalCompulsionRate(CompulsionEventType type, int skillId = 0) {
  nestedCompulsionDic.Values.Where(compulsion => compulsion.SkillIds.Contains(skillId)).Sum(compulsion => compulsion.Rate);
  }
 
+ /// <summary>
+ /// Returns the resistance value for the specified attribute, or 0 if not present.
+ /// </summary>
+ /// <param name="attribute">The attribute for which to retrieve resistance.</param>
+ /// <returns>The resistance value for the given attribute, or 0 if none is set.</returns>
  public float GetResistance(BasicAttribute attribute) {
  if (Resistances.TryGetValue(attribute, out float value)) {
  return value;
@@ -318,6 +338,13 @@ public float GetResistance(BasicAttribute attribute) {
  return 0;
  }
 
+ /// <summary>
+ /// Calculates the total invoke value and rate for a specified invoke effect type, filtered by skill ID or skill group.
+ /// </summary>
+ /// <param name="invokeType">The type of invoke effect to aggregate.</param>
+ /// <param name="skillId">The skill ID to match against invoke effects.</param>
+ /// <param name="skillGroup">Optional skill group IDs to match against invoke effects.</param>
+ /// <returns>A tuple containing the total invoke value (as an integer) and the total invoke rate (as a float).</returns>
  public (int, float) GetInvokeValues(InvokeEffectType invokeType, int skillId, params int[] skillGroup) {
  if (!Invokes.TryGetValue(invokeType, out var nestedInvokeDic))
  return (0, 0f);
@@ -335,6 +362,9 @@ public float GetResistance(BasicAttribute attribute) {
  return ((int) value, rate);
  }
 
+ /// <summary>
+ /// Sets the shield health for a buff based on its metadata, using either a fixed value or a percentage of the actor's maximum health.
+ /// </summary>
  private void SetShield(Buff buff) {
  if (buff.Metadata.Shield == null) {
  return;
@@ -369,6 +399,9 @@ private void SetMount(Buff buff) {
  }
  }
 
+ /// <summary>
+ /// Applies update effects from the buff, including canceling specified buffs and resetting skill cooldowns for the actor.
+ /// </summary>
  private void SetUpdates(Buff buff) {
  if (buff.Metadata.Update.Cancel != null) {
  CancelBuffs(buff, buff.Metadata.Update.Cancel);
@@ -381,6 +414,15 @@ private void SetUpdates(Buff buff) {
  }
  }
  }
+ /// <summary>
+ /// Triggers an event for all enabled buffs, causing the owner to apply each buff's effects for the specified event type.
+ /// </summary>
+ /// <param name="caster">The actor who initiated the event.</param>
+ /// <param name="owner">The actor who owns the buffs.</param>
+ /// <param name="target">The target actor affected by the event.</param>
+ /// <param name="type">The event condition type that determines which effects to apply.</param>
+ /// <param name="skillId">Optional skill ID associated with the event.</param>
+ /// <param name="buffId">Optional buff ID associated with the event.</param>
  public void TriggerEvent(IActor caster, IActor owner, IActor target, EventConditionType type, int skillId = 0, int buffId = 0) {
  foreach (Buff buff in EnumerateBuffs()) {
  if (!buff.Enabled) {
@@ -520,6 +562,12 @@ public void Remove(params (int id, int casterId)[] buffIds) {
  }
  }
 
+ /// <summary>
+ /// Removes all buffs with the specified ID and caster ID from the actor, updates resistances, handles related effects, and refreshes stats if necessary.
+ /// </summary>
+ /// <param name="id">The buff ID to remove.</param>
+ /// <param name="casterId">The object ID of the caster whose buffs should be removed.</param>
+ /// <returns>True if the removal process completes.</returns>
  public bool Remove(int id, int casterId) {
  //TODO: Check if buff is removable/should be removed
  bool refreshStats = false;

Maple2.Server.Game/Manager/Config/SkillManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Storage;
+using Maple2.Database.Storage;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
 using Maple2.Model.Metadata;
@@ -30,6 +30,9 @@ public void LoadSkillBook() {
  session.Send(SkillBookPacket.Load(SkillBook));
  }
 
+ /// <summary>
+ /// Applies all passive skill effects that target the player, updating active buffs based on the player's learned passive skills.
+ /// </summary>
  public void UpdatePassiveBuffs(bool notifyField = true) {
  // TODO: Only remove buffs that have been unlearned.
  /*foreach (Buff buff in session.Player.Buffs.Buffs.Values) {

Maple2.Server.Game/Manager/Field/FieldManager/FieldManager.State.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Numerics;
@@ -437,6 +437,10 @@ public void AddSkill(IActor caster, SkillEffectMetadata effect, Vector3[] points
  }
  }
 
+ /// <summary>
+ /// Adds splash skill effects from a skill record, calculating effect positions based on cube magic paths if applicable.
+ /// </summary>
+ /// <param name="record">The skill record containing caster, position, rotation, and attack metadata.</param>
  public void AddSkill(SkillRecord record) {
  SkillMetadataAttack attack = record.Attack;
  if (!TableMetadata.MagicPathTable.Entries.TryGetValue(attack.CubeMagicPathId, out IReadOnlyList<MagicPath>? cubeMagicPaths)) {
@@ -474,6 +478,14 @@ public void AddSkill(SkillRecord record) {
  }
  }
 
+ /// <summary>
+ /// Returns a filtered collection of actors within the specified prisms, based on the target type and limit.
+ /// </summary>
+ /// <param name="prisms">The prisms used to filter actors by location or area.</param>
+ /// <param name="targetType">The type of targets to select (e.g., friendly players, hostile mobs, or hungry mobs).</param>
+ /// <param name="limit">The maximum number of actors to return.</param>
+ /// <param name="ignore">An optional collection of actors to exclude from the results.</param>
+ /// <returns>An enumerable of actors matching the criteria, or an empty collection if the target type is unhandled.</returns>
  public IEnumerable<IActor> GetTargets(Prism[] prisms, ApplyTargetType targetType, int limit, ICollection<IActor>? ignore = null) {
  switch (targetType) {
  case ApplyTargetType.Friendly:

Maple2.Database/Context/MetadataContext.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Extensions;
+using Maple2.Database.Extensions;
 using Maple2.Database.Model.Metadata;
 using Maple2.Model.Game.Field;
 using Maple2.Model.Metadata;
@@ -59,6 +59,9 @@ protected override void OnModelCreating(ModelBuilder modelBuilder) {
  modelBuilder.Entity<FunctionCubeMetadata>(ConfigureFunctionCubeMetadata);
  }
 
+ /// <summary>
+ /// Configures the Entity Framework Core mapping for the AdditionalEffectMetadata entity, including table name, composite primary key, and JSON conversion for complex properties.
+ /// </summary>
  private static void ConfigureAdditionalEffectMetadata(EntityTypeBuilder<AdditionalEffectMetadata> builder) {
  builder.ToTable("additional-effect");
  builder.HasKey(effect => new { effect.Id, effect.Level });

Maple2.File.Ingest/Mapper/AdditionalEffectMapper.cs

@@ -1,4 +1,4 @@
-using Maple2.File.IO;
+using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.AdditionalEffect;
 using Maple2.Model.Enum;
@@ -16,6 +16,10 @@ public AdditionalEffectMapper(M2dReader xmlReader) {
  parser = new AdditionalEffectParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed additional effect data into strongly typed <see cref="AdditionalEffectMetadata"/> objects.
+ /// </summary>
+ /// <returns>An enumerable of <see cref="AdditionalEffectMetadata"/> representing all parsed additional effects.</returns>
  protected override IEnumerable<AdditionalEffectMetadata> Map() {
  foreach ((int id, IList<AdditionalEffectData> datas) in parser.Parse()) {
  foreach (AdditionalEffectData data in datas) {
@@ -231,6 +235,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  NotKill: dotDamage.notKill);
  }
 
+ /// <summary>
+ /// Converts a <see cref="DotBuffProperty"/> to a <see cref="AdditionalEffectMetadataDot.DotBuff"/> if the buff ID is positive; otherwise returns null.
+ /// </summary>
+ /// <param name="dotBuff">The DOT buff property to convert.</param>
+ /// <returns>A <see cref="AdditionalEffectMetadataDot.DotBuff"/> instance if valid; otherwise, null.</returns>
  private static AdditionalEffectMetadataDot.DotBuff? Convert(DotBuffProperty? dotBuff) {
  if (dotBuff is not { buffID: > 0 }) {
  return null;
@@ -239,6 +248,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  return new AdditionalEffectMetadataDot.DotBuff(Target: (SkillTargetType) dotBuff.target, Id: dotBuff.buffID, Level: dotBuff.buffLevel);
  }
 
+ /// <summary>
+ /// Converts a <see cref="ShieldProperty"/> to an <see cref="AdditionalEffectMetadataShield"/> if shield values are positive; otherwise returns null.
+ /// </summary>
+ /// <param name="shield">The shield property to convert.</param>
+ /// <returns>An <see cref="AdditionalEffectMetadataShield"/> if applicable; otherwise, null.</returns>
  private static AdditionalEffectMetadataShield? Convert(ShieldProperty shield) {
  if (shield is { hpValue: <= 0, hpByTargetMaxHP: <= 0 }) {
  return null;

Maple2.File.Ingest/Mapper/SkillMapper.cs

@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.Skill;
@@ -14,6 +14,10 @@ public SkillMapper(M2dReader xmlReader) {
  parser = new SkillParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed skill XML data into structured <see cref="StoredSkillMetadata"/> objects, transforming raw skill definitions into strongly typed metadata for further processing.
+ /// </summary>
+ /// <returns>An enumerable sequence of <see cref="StoredSkillMetadata"/> representing all valid skills parsed from the source data.</returns>
  protected override IEnumerable<StoredSkillMetadata> Map() {
  foreach ((int id, string name, SkillData data) in parser.Parse()) {
  if (data.basic == null) continue; // Old_JobChange_01
@@ -133,6 +137,11 @@ protected override IEnumerable<StoredSkillMetadata> Map() {
  }
  }
 
+ /// <summary>
+ /// Converts a <see cref="RegionSkill"/> object into a <see cref="SkillMetadataRange"/>, mapping region type strings to <see cref="SkillRegion"/> values and transferring relevant range properties.
+ /// </summary>
+ /// <param name="region">The region skill data to convert.</param>
+ /// <returns>A <see cref="SkillMetadataRange"/> representing the region's metadata.</returns>
  private static SkillMetadataRange Convert(RegionSkill region) {
  return new SkillMetadataRange(
  Type: region.rangeType switch {

Maple2.File.Ingest/MapperExtensions.cs

@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 using System.Diagnostics;
 using System.Reflection;
 using Maple2.File.Ingest.Utils;
@@ -227,6 +227,11 @@ public static byte OptionIndex(this SpecialAttribute attribute) {
  };
  }
 
+ /// <summary>
+ /// Converts a <see cref="TriggerSkill"/> instance into a <see cref="SkillEffectMetadata"/>, mapping its properties to either a splash or condition effect and assembling the associated skills.
+ /// </summary>
+ /// <param name="trigger">The trigger skill data to convert.</param>
+ /// <returns>A <see cref="SkillEffectMetadata"/> representing the trigger's effect, including splash or condition details and linked skills.</returns>
  public static SkillEffectMetadata Convert(this TriggerSkill trigger) {
  SkillEffectMetadataCondition? condition = null;
  SkillEffectMetadataSplash? splash = null;
@@ -316,6 +321,11 @@ public static SkillMetadataAutoTargeting Convert(this AutoTargeting autoTargetin
  UseMove: autoTargeting.autoTargetUseMove);
  }
 
+ /// <summary>
+ /// Converts a parsed XML skill begin condition into a strongly typed <see cref="BeginCondition"/> metadata object for use in Maple2 game logic.
+ /// </summary>
+ /// <param name="beginCondition">The XML-parsed skill begin condition to convert.</param>
+ /// <returns>A <see cref="BeginCondition"/> instance containing mapped level, gender, mesos, stats, map and skill requirements, job codes, probability, cooldowns, durations, state flags, dungeon group types, weapon requirements, and subconditions for target, owner, and caster.</returns>
  public static BeginCondition Convert(this Maple2.File.Parser.Xml.Skill.BeginCondition beginCondition) {
  return new BeginCondition(
  Level: beginCondition.level,

Maple2.Server.Core/Packets/RequestPacket.cs

@@ -1,4 +1,4 @@
-using Maple2.PacketLib.Tools;
+using Maple2.PacketLib.Tools;
 using Maple2.Server.Core.Constants;
 
 namespace Maple2.Server.Core.Packets;
@@ -8,10 +8,18 @@ public static ByteWriter Login() {
  return Packet.Of(SendOp.RequestLogin);
  }
 
+ /// <summary>
+ /// Creates a packet for requesting a session key from the server.
+ /// </summary>
+ /// <returns>A <see cref="ByteWriter"/> containing the key request packet.</returns>
  public static ByteWriter Key() {
  return Packet.Of(SendOp.RequestKey);
  }
 
+ /// <summary>
+ /// Creates a heartbeat request packet containing the current system tick count.
+ /// </summary>
+ /// <returns>A ByteWriter representing the heartbeat request packet.</returns>
  public static ByteWriter Heartbeat() {
  var pWriter = Packet.Of(SendOp.RequestHeartbeat);
  pWriter.WriteInt(Environment.TickCount);

Maple2.Server.Game/Commands/BuffCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using Maple2.Database.Storage;
@@ -40,6 +40,17 @@ public BuffCommand(GameSession session, SkillMetadataStorage skillStorage) : bas
  this.SetHandler<InvocationContext, int, int, int, int, bool, string, bool>(Handle, id, level, stack, duration, all, target, remove);
  }
 
+ /// <summary>
+ /// Processes the "buff" command to add or remove a specified buff on one or more players in the current field.
+ /// </summary>
+ /// <param name="ctx">The command invocation context.</param>
+ /// <param name="buffId">The ID of the buff to add or remove.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="stack">The number of buff stacks to apply.</param>
+ /// <param name="duration">The duration of the buff in seconds, or -1 for default duration.</param>
+ /// <param name="all">If true, applies the operation to all players in the field.</param>
+ /// <param name="target">The name of the target player to affect, or empty to target the command issuer.</param>
+ /// <param name="remove">If true, removes the buff instead of adding it.</param>
  private void Handle(InvocationContext ctx, int buffId, int level, int stack, int duration, bool all, string target, bool remove) {
  try {
  if (!skillStorage.TryGetEffect(buffId, (short) level, out AdditionalEffectMetadata? _)) {

Maple2.Server.Game/Commands/KillCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.Numerics;
@@ -141,6 +141,12 @@ private void Handle(InvocationContext ctx, string name) {
  }
  }
 
+ /// <summary>
+ /// Instantly kills the specified NPC by applying damage equal to its current health and broadcasts the resulting updates to the field.
+ /// </summary>
+ /// <param name="session">The game session performing the kill action.</param>
+ /// <param name="npc">The NPC to be killed.</param>
+ /// <param name="skill">The skill metadata used to generate the damage record.</param>
  private static void Kill(GameSession session, FieldNpc npc, SkillMetadata skill) {
  var damageRecord = new DamageRecord(skill, skill.Data.Motions[0].Attacks[0]) {
  CasterId = session.Player.ObjectId,

Maple2.Server.Game/Manager/AnimationManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Model.Enum;
+using Maple2.Model.Enum;
 using Maple2.Model.Metadata;
 using Maple2.Server.Core.Packets;
 using Maple2.Server.Game.Model;
@@ -199,7 +199,10 @@ public void CancelSequence() {
  /// <summary>
  /// Updates the animation state based on the current tick count.
  /// </summary>
- /// <param name="tickCount">The current server tick count</param>
+ /// <summary>
+ /// Updates the animation state for the actor based on the current server tick, processing keyframe events, handling looping, and resetting sequences as needed.
+ /// </summary>
+ /// <param name="tickCount">The current server tick count.</param>
  public void Update(long tickCount) {
  // Skip update if no animation metadata is available
  if (RigMetadata is null) {
@@ -349,7 +352,12 @@ public float GetSequenceSegmentTime(string keyframe1, string keyframe2) {
  /// </summary>
  /// <param name="sequenceTime">The current sequence time</param>
  /// <param name="key">The keyframe that was hit</param>
- /// <param name="speed">The current animation speed</param>
+ /// <summary>
+ /// Handles a keyframe event during an animation sequence, triggering actor callbacks and updating loop or end timing based on the keyframe type.
+ /// </summary>
+ /// <param name="sequenceTime">The current normalized time within the animation sequence.</param>
+ /// <param name="key">The animation keyframe being processed.</param>
+ /// <param name="speed">The current animation speed.</param>
  private void HitKeyframe(float sequenceTime, AnimationKey key, float speed) {
  isHandlingKeyframe = true;
 

Maple2.Server.Game/Manager/Config/BuffManager.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Numerics;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
@@ -61,6 +61,9 @@ public void Clear() {
  }
  }
 
+ /// <summary>
+ /// Applies entrance buffs and refreshes premium club buffs for the actor when entering a field.
+ /// </summary>
  public void LoadFieldBuffs() {
  // Lapenshards
  // Game Events
@@ -71,6 +74,18 @@ public void LoadFieldBuffs() {
  }
  }
 
+ /// <summary>
+ /// Adds a buff to the specified owner, handling stacking, duration, cooldowns, group conflicts, and effect application.
+ /// </summary>
+ /// <param name="caster">The actor applying the buff.</param>
+ /// <param name="owner">The actor receiving the buff.</param>
+ /// <param name="id">The buff's skill or effect ID.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="startTick">The tick count when the buff starts.</param>
+ /// <param name="stacks">The number of stacks to apply (clamped to the buff's maximum).</param>
+ /// <param name="durationMs">The duration of the buff in milliseconds. If negative, uses the default duration.</param>
+ /// <param name="notifyField">Whether to broadcast the buff addition to the field.</param>
+ /// <param name="type">The event condition type triggering the buff application.</param>
  public void AddBuff(IActor caster, IActor owner, int id, short level, long startTick, int stacks = 0, int durationMs = -1, bool notifyField = true, EventConditionType type = EventConditionType.Activate) {
  if (!owner.Field.SkillMetadata.TryGetEffect(id, level, out AdditionalEffectMetadata? additionalEffect)) {
  logger.Error("Invalid buff: {SkillId},{Level}", id, level);
@@ -310,6 +325,11 @@ public float TotalCompulsionRate(CompulsionEventType type, int skillId = 0) {
  nestedCompulsionDic.Values.Where(compulsion => compulsion.SkillIds.Contains(skillId)).Sum(compulsion => compulsion.Rate);
  }
 
+ /// <summary>
+ /// Returns the resistance value for the specified attribute, or 0 if not present.
+ /// </summary>
+ /// <param name="attribute">The attribute for which to retrieve resistance.</param>
+ /// <returns>The resistance value for the given attribute, or 0 if none is set.</returns>
  public float GetResistance(BasicAttribute attribute) {
  if (Resistances.TryGetValue(attribute, out float value)) {
  return value;
@@ -318,6 +338,13 @@ public float GetResistance(BasicAttribute attribute) {
  return 0;
  }
 
+ /// <summary>
+ /// Calculates the total invoke value and rate for a specified invoke effect type, filtered by skill ID or skill group.
+ /// </summary>
+ /// <param name="invokeType">The type of invoke effect to aggregate.</param>
+ /// <param name="skillId">The skill ID to match against invoke effects.</param>
+ /// <param name="skillGroup">Optional skill group IDs to match against invoke effects.</param>
+ /// <returns>A tuple containing the total invoke value (as an integer) and the total invoke rate (as a float).</returns>
  public (int, float) GetInvokeValues(InvokeEffectType invokeType, int skillId, params int[] skillGroup) {
  if (!Invokes.TryGetValue(invokeType, out var nestedInvokeDic))
  return (0, 0f);
@@ -335,6 +362,9 @@ public float GetResistance(BasicAttribute attribute) {
  return ((int) value, rate);
  }
 
+ /// <summary>
+ /// Sets the shield health for a buff based on its metadata, using either a fixed value or a percentage of the actor's maximum health.
+ /// </summary>
  private void SetShield(Buff buff) {
  if (buff.Metadata.Shield == null) {
  return;
@@ -369,6 +399,9 @@ private void SetMount(Buff buff) {
  }
  }
 
+ /// <summary>
+ /// Applies update effects from the buff, including canceling specified buffs and resetting skill cooldowns for the actor.
+ /// </summary>
  private void SetUpdates(Buff buff) {
  if (buff.Metadata.Update.Cancel != null) {
  CancelBuffs(buff, buff.Metadata.Update.Cancel);
@@ -381,6 +414,15 @@ private void SetUpdates(Buff buff) {
  }
  }
  }
+ /// <summary>
+ /// Triggers an event for all enabled buffs, causing the owner to apply each buff's effects for the specified event type.
+ /// </summary>
+ /// <param name="caster">The actor who initiated the event.</param>
+ /// <param name="owner">The actor who owns the buffs.</param>
+ /// <param name="target">The target actor affected by the event.</param>
+ /// <param name="type">The event condition type that determines which effects to apply.</param>
+ /// <param name="skillId">Optional skill ID associated with the event.</param>
+ /// <param name="buffId">Optional buff ID associated with the event.</param>
  public void TriggerEvent(IActor caster, IActor owner, IActor target, EventConditionType type, int skillId = 0, int buffId = 0) {
  foreach (Buff buff in EnumerateBuffs()) {
  if (!buff.Enabled) {
@@ -520,6 +562,12 @@ public void Remove(params (int id, int casterId)[] buffIds) {
  }
  }
 
+ /// <summary>
+ /// Removes all buffs with the specified ID and caster ID from the actor, updates resistances, handles related effects, and refreshes stats if necessary.
+ /// </summary>
+ /// <param name="id">The buff ID to remove.</param>
+ /// <param name="casterId">The object ID of the caster whose buffs should be removed.</param>
+ /// <returns>True if the removal process completes.</returns>
  public bool Remove(int id, int casterId) {
  //TODO: Check if buff is removable/should be removed
  bool refreshStats = false;

Maple2.Server.Game/Manager/Config/SkillManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Storage;
+using Maple2.Database.Storage;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
 using Maple2.Model.Metadata;
@@ -30,6 +30,9 @@ public void LoadSkillBook() {
  session.Send(SkillBookPacket.Load(SkillBook));
  }
 
+ /// <summary>
+ /// Applies all passive skill effects that target the player, updating active buffs based on the player's learned passive skills.
+ /// </summary>
  public void UpdatePassiveBuffs(bool notifyField = true) {
  // TODO: Only remove buffs that have been unlearned.
  /*foreach (Buff buff in session.Player.Buffs.Buffs.Values) {

Maple2.Server.Game/Manager/Field/FieldManager/FieldManager.State.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Numerics;
@@ -437,6 +437,10 @@ public void AddSkill(IActor caster, SkillEffectMetadata effect, Vector3[] points
  }
  }
 
+ /// <summary>
+ /// Adds splash skill effects from a skill record, calculating effect positions based on cube magic paths if applicable.
+ /// </summary>
+ /// <param name="record">The skill record containing caster, position, rotation, and attack metadata.</param>
  public void AddSkill(SkillRecord record) {
  SkillMetadataAttack attack = record.Attack;
  if (!TableMetadata.MagicPathTable.Entries.TryGetValue(attack.CubeMagicPathId, out IReadOnlyList<MagicPath>? cubeMagicPaths)) {
@@ -474,6 +478,14 @@ public void AddSkill(SkillRecord record) {
  }
  }
 
+ /// <summary>
+ /// Returns a filtered collection of actors within the specified prisms, based on the target type and limit.
+ /// </summary>
+ /// <param name="prisms">The prisms used to filter actors by location or area.</param>
+ /// <param name="targetType">The type of targets to select (e.g., friendly players, hostile mobs, or hungry mobs).</param>
+ /// <param name="limit">The maximum number of actors to return.</param>
+ /// <param name="ignore">An optional collection of actors to exclude from the results.</param>
+ /// <returns>An enumerable of actors matching the criteria, or an empty collection if the target type is unhandled.</returns>
  public IEnumerable<IActor> GetTargets(Prism[] prisms, ApplyTargetType targetType, int limit, ICollection<IActor>? ignore = null) {
  switch (targetType) {
  case ApplyTargetType.Friendly:

Maple2.Database/Context/MetadataContext.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Extensions;
+using Maple2.Database.Extensions;
 using Maple2.Database.Model.Metadata;
 using Maple2.Model.Game.Field;
 using Maple2.Model.Metadata;
@@ -59,6 +59,9 @@ protected override void OnModelCreating(ModelBuilder modelBuilder) {
  modelBuilder.Entity<FunctionCubeMetadata>(ConfigureFunctionCubeMetadata);
  }
 
+ /// <summary>
+ /// Configures the Entity Framework Core mapping for the AdditionalEffectMetadata entity, including table name, composite primary key, and JSON conversion for complex properties.
+ /// </summary>
  private static void ConfigureAdditionalEffectMetadata(EntityTypeBuilder<AdditionalEffectMetadata> builder) {
  builder.ToTable("additional-effect");
  builder.HasKey(effect => new { effect.Id, effect.Level });

Maple2.File.Ingest/Mapper/AdditionalEffectMapper.cs

@@ -1,4 +1,4 @@
-using Maple2.File.IO;
+using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.AdditionalEffect;
 using Maple2.Model.Enum;
@@ -16,6 +16,10 @@ public AdditionalEffectMapper(M2dReader xmlReader) {
  parser = new AdditionalEffectParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed additional effect data into strongly typed <see cref="AdditionalEffectMetadata"/> objects.
+ /// </summary>
+ /// <returns>An enumerable of <see cref="AdditionalEffectMetadata"/> representing all parsed additional effects.</returns>
  protected override IEnumerable<AdditionalEffectMetadata> Map() {
  foreach ((int id, IList<AdditionalEffectData> datas) in parser.Parse()) {
  foreach (AdditionalEffectData data in datas) {
@@ -231,6 +235,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  NotKill: dotDamage.notKill);
  }
 
+ /// <summary>
+ /// Converts a <see cref="DotBuffProperty"/> to a <see cref="AdditionalEffectMetadataDot.DotBuff"/> if the buff ID is positive; otherwise returns null.
+ /// </summary>
+ /// <param name="dotBuff">The DOT buff property to convert.</param>
+ /// <returns>A <see cref="AdditionalEffectMetadataDot.DotBuff"/> instance if valid; otherwise, null.</returns>
  private static AdditionalEffectMetadataDot.DotBuff? Convert(DotBuffProperty? dotBuff) {
  if (dotBuff is not { buffID: > 0 }) {
  return null;
@@ -239,6 +248,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  return new AdditionalEffectMetadataDot.DotBuff(Target: (SkillTargetType) dotBuff.target, Id: dotBuff.buffID, Level: dotBuff.buffLevel);
  }
 
+ /// <summary>
+ /// Converts a <see cref="ShieldProperty"/> to an <see cref="AdditionalEffectMetadataShield"/> if shield values are positive; otherwise returns null.
+ /// </summary>
+ /// <param name="shield">The shield property to convert.</param>
+ /// <returns>An <see cref="AdditionalEffectMetadataShield"/> if applicable; otherwise, null.</returns>
  private static AdditionalEffectMetadataShield? Convert(ShieldProperty shield) {
  if (shield is { hpValue: <= 0, hpByTargetMaxHP: <= 0 }) {
  return null;

Maple2.File.Ingest/Mapper/SkillMapper.cs

@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.Skill;
@@ -14,6 +14,10 @@ public SkillMapper(M2dReader xmlReader) {
  parser = new SkillParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed skill XML data into structured <see cref="StoredSkillMetadata"/> objects, transforming raw skill definitions into strongly typed metadata for further processing.
+ /// </summary>
+ /// <returns>An enumerable sequence of <see cref="StoredSkillMetadata"/> representing all valid skills parsed from the source data.</returns>
  protected override IEnumerable<StoredSkillMetadata> Map() {
  foreach ((int id, string name, SkillData data) in parser.Parse()) {
  if (data.basic == null) continue; // Old_JobChange_01
@@ -133,6 +137,11 @@ protected override IEnumerable<StoredSkillMetadata> Map() {
  }
  }
 
+ /// <summary>
+ /// Converts a <see cref="RegionSkill"/> object into a <see cref="SkillMetadataRange"/>, mapping region type strings to <see cref="SkillRegion"/> values and transferring relevant range properties.
+ /// </summary>
+ /// <param name="region">The region skill data to convert.</param>
+ /// <returns>A <see cref="SkillMetadataRange"/> representing the region's metadata.</returns>
  private static SkillMetadataRange Convert(RegionSkill region) {
  return new SkillMetadataRange(
  Type: region.rangeType switch {

Maple2.File.Ingest/MapperExtensions.cs

@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 using System.Diagnostics;
 using System.Reflection;
 using Maple2.File.Ingest.Utils;
@@ -227,6 +227,11 @@ public static byte OptionIndex(this SpecialAttribute attribute) {
  };
  }
 
+ /// <summary>
+ /// Converts a <see cref="TriggerSkill"/> instance into a <see cref="SkillEffectMetadata"/>, mapping its properties to either a splash or condition effect and assembling the associated skills.
+ /// </summary>
+ /// <param name="trigger">The trigger skill data to convert.</param>
+ /// <returns>A <see cref="SkillEffectMetadata"/> representing the trigger's effect, including splash or condition details and linked skills.</returns>
  public static SkillEffectMetadata Convert(this TriggerSkill trigger) {
  SkillEffectMetadataCondition? condition = null;
  SkillEffectMetadataSplash? splash = null;
@@ -316,6 +321,11 @@ public static SkillMetadataAutoTargeting Convert(this AutoTargeting autoTargetin
  UseMove: autoTargeting.autoTargetUseMove);
  }
 
+ /// <summary>
+ /// Converts a parsed XML skill begin condition into a strongly typed <see cref="BeginCondition"/> metadata object for use in Maple2 game logic.
+ /// </summary>
+ /// <param name="beginCondition">The XML-parsed skill begin condition to convert.</param>
+ /// <returns>A <see cref="BeginCondition"/> instance containing mapped level, gender, mesos, stats, map and skill requirements, job codes, probability, cooldowns, durations, state flags, dungeon group types, weapon requirements, and subconditions for target, owner, and caster.</returns>
  public static BeginCondition Convert(this Maple2.File.Parser.Xml.Skill.BeginCondition beginCondition) {
  return new BeginCondition(
  Level: beginCondition.level,

Maple2.Server.Core/Packets/RequestPacket.cs

@@ -1,4 +1,4 @@
-using Maple2.PacketLib.Tools;
+using Maple2.PacketLib.Tools;
 using Maple2.Server.Core.Constants;
 
 namespace Maple2.Server.Core.Packets;
@@ -8,10 +8,18 @@ public static ByteWriter Login() {
  return Packet.Of(SendOp.RequestLogin);
  }
 
+ /// <summary>
+ /// Creates a packet for requesting a session key from the server.
+ /// </summary>
+ /// <returns>A <see cref="ByteWriter"/> containing the key request packet.</returns>
  public static ByteWriter Key() {
  return Packet.Of(SendOp.RequestKey);
  }
 
+ /// <summary>
+ /// Creates a heartbeat request packet containing the current system tick count.
+ /// </summary>
+ /// <returns>A ByteWriter representing the heartbeat request packet.</returns>
  public static ByteWriter Heartbeat() {
  var pWriter = Packet.Of(SendOp.RequestHeartbeat);
  pWriter.WriteInt(Environment.TickCount);

Maple2.Server.Game/Commands/BuffCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using Maple2.Database.Storage;
@@ -40,6 +40,17 @@ public BuffCommand(GameSession session, SkillMetadataStorage skillStorage) : bas
  this.SetHandler<InvocationContext, int, int, int, int, bool, string, bool>(Handle, id, level, stack, duration, all, target, remove);
  }
 
+ /// <summary>
+ /// Processes the "buff" command to add or remove a specified buff on one or more players in the current field.
+ /// </summary>
+ /// <param name="ctx">The command invocation context.</param>
+ /// <param name="buffId">The ID of the buff to add or remove.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="stack">The number of buff stacks to apply.</param>
+ /// <param name="duration">The duration of the buff in seconds, or -1 for default duration.</param>
+ /// <param name="all">If true, applies the operation to all players in the field.</param>
+ /// <param name="target">The name of the target player to affect, or empty to target the command issuer.</param>
+ /// <param name="remove">If true, removes the buff instead of adding it.</param>
  private void Handle(InvocationContext ctx, int buffId, int level, int stack, int duration, bool all, string target, bool remove) {
  try {
  if (!skillStorage.TryGetEffect(buffId, (short) level, out AdditionalEffectMetadata? _)) {

Maple2.Server.Game/Commands/KillCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.Numerics;
@@ -141,6 +141,12 @@ private void Handle(InvocationContext ctx, string name) {
  }
  }
 
+ /// <summary>
+ /// Instantly kills the specified NPC by applying damage equal to its current health and broadcasts the resulting updates to the field.
+ /// </summary>
+ /// <param name="session">The game session performing the kill action.</param>
+ /// <param name="npc">The NPC to be killed.</param>
+ /// <param name="skill">The skill metadata used to generate the damage record.</param>
  private static void Kill(GameSession session, FieldNpc npc, SkillMetadata skill) {
  var damageRecord = new DamageRecord(skill, skill.Data.Motions[0].Attacks[0]) {
  CasterId = session.Player.ObjectId,

Maple2.Server.Game/Manager/AnimationManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Model.Enum;
+using Maple2.Model.Enum;
 using Maple2.Model.Metadata;
 using Maple2.Server.Core.Packets;
 using Maple2.Server.Game.Model;
@@ -199,7 +199,10 @@ public void CancelSequence() {
  /// <summary>
  /// Updates the animation state based on the current tick count.
  /// </summary>
- /// <param name="tickCount">The current server tick count</param>
+ /// <summary>
+ /// Updates the animation state for the actor based on the current server tick, processing keyframe events, handling looping, and resetting sequences as needed.
+ /// </summary>
+ /// <param name="tickCount">The current server tick count.</param>
  public void Update(long tickCount) {
  // Skip update if no animation metadata is available
  if (RigMetadata is null) {
@@ -349,7 +352,12 @@ public float GetSequenceSegmentTime(string keyframe1, string keyframe2) {
  /// </summary>
  /// <param name="sequenceTime">The current sequence time</param>
  /// <param name="key">The keyframe that was hit</param>
- /// <param name="speed">The current animation speed</param>
+ /// <summary>
+ /// Handles a keyframe event during an animation sequence, triggering actor callbacks and updating loop or end timing based on the keyframe type.
+ /// </summary>
+ /// <param name="sequenceTime">The current normalized time within the animation sequence.</param>
+ /// <param name="key">The animation keyframe being processed.</param>
+ /// <param name="speed">The current animation speed.</param>
  private void HitKeyframe(float sequenceTime, AnimationKey key, float speed) {
  isHandlingKeyframe = true;
 

Maple2.Server.Game/Manager/Config/BuffManager.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Numerics;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
@@ -61,6 +61,9 @@ public void Clear() {
  }
  }
 
+ /// <summary>
+ /// Applies entrance buffs and refreshes premium club buffs for the actor when entering a field.
+ /// </summary>
  public void LoadFieldBuffs() {
  // Lapenshards
  // Game Events
@@ -71,6 +74,18 @@ public void LoadFieldBuffs() {
  }
  }
 
+ /// <summary>
+ /// Adds a buff to the specified owner, handling stacking, duration, cooldowns, group conflicts, and effect application.
+ /// </summary>
+ /// <param name="caster">The actor applying the buff.</param>
+ /// <param name="owner">The actor receiving the buff.</param>
+ /// <param name="id">The buff's skill or effect ID.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="startTick">The tick count when the buff starts.</param>
+ /// <param name="stacks">The number of stacks to apply (clamped to the buff's maximum).</param>
+ /// <param name="durationMs">The duration of the buff in milliseconds. If negative, uses the default duration.</param>
+ /// <param name="notifyField">Whether to broadcast the buff addition to the field.</param>
+ /// <param name="type">The event condition type triggering the buff application.</param>
  public void AddBuff(IActor caster, IActor owner, int id, short level, long startTick, int stacks = 0, int durationMs = -1, bool notifyField = true, EventConditionType type = EventConditionType.Activate) {
  if (!owner.Field.SkillMetadata.TryGetEffect(id, level, out AdditionalEffectMetadata? additionalEffect)) {
  logger.Error("Invalid buff: {SkillId},{Level}", id, level);
@@ -310,6 +325,11 @@ public float TotalCompulsionRate(CompulsionEventType type, int skillId = 0) {
  nestedCompulsionDic.Values.Where(compulsion => compulsion.SkillIds.Contains(skillId)).Sum(compulsion => compulsion.Rate);
  }
 
+ /// <summary>
+ /// Returns the resistance value for the specified attribute, or 0 if not present.
+ /// </summary>
+ /// <param name="attribute">The attribute for which to retrieve resistance.</param>
+ /// <returns>The resistance value for the given attribute, or 0 if none is set.</returns>
  public float GetResistance(BasicAttribute attribute) {
  if (Resistances.TryGetValue(attribute, out float value)) {
  return value;
@@ -318,6 +338,13 @@ public float GetResistance(BasicAttribute attribute) {
  return 0;
  }
 
+ /// <summary>
+ /// Calculates the total invoke value and rate for a specified invoke effect type, filtered by skill ID or skill group.
+ /// </summary>
+ /// <param name="invokeType">The type of invoke effect to aggregate.</param>
+ /// <param name="skillId">The skill ID to match against invoke effects.</param>
+ /// <param name="skillGroup">Optional skill group IDs to match against invoke effects.</param>
+ /// <returns>A tuple containing the total invoke value (as an integer) and the total invoke rate (as a float).</returns>
  public (int, float) GetInvokeValues(InvokeEffectType invokeType, int skillId, params int[] skillGroup) {
  if (!Invokes.TryGetValue(invokeType, out var nestedInvokeDic))
  return (0, 0f);
@@ -335,6 +362,9 @@ public float GetResistance(BasicAttribute attribute) {
  return ((int) value, rate);
  }
 
+ /// <summary>
+ /// Sets the shield health for a buff based on its metadata, using either a fixed value or a percentage of the actor's maximum health.
+ /// </summary>
  private void SetShield(Buff buff) {
  if (buff.Metadata.Shield == null) {
  return;
@@ -369,6 +399,9 @@ private void SetMount(Buff buff) {
  }
  }
 
+ /// <summary>
+ /// Applies update effects from the buff, including canceling specified buffs and resetting skill cooldowns for the actor.
+ /// </summary>
  private void SetUpdates(Buff buff) {
  if (buff.Metadata.Update.Cancel != null) {
  CancelBuffs(buff, buff.Metadata.Update.Cancel);
@@ -381,6 +414,15 @@ private void SetUpdates(Buff buff) {
  }
  }
  }
+ /// <summary>
+ /// Triggers an event for all enabled buffs, causing the owner to apply each buff's effects for the specified event type.
+ /// </summary>
+ /// <param name="caster">The actor who initiated the event.</param>
+ /// <param name="owner">The actor who owns the buffs.</param>
+ /// <param name="target">The target actor affected by the event.</param>
+ /// <param name="type">The event condition type that determines which effects to apply.</param>
+ /// <param name="skillId">Optional skill ID associated with the event.</param>
+ /// <param name="buffId">Optional buff ID associated with the event.</param>
  public void TriggerEvent(IActor caster, IActor owner, IActor target, EventConditionType type, int skillId = 0, int buffId = 0) {
  foreach (Buff buff in EnumerateBuffs()) {
  if (!buff.Enabled) {
@@ -520,6 +562,12 @@ public void Remove(params (int id, int casterId)[] buffIds) {
  }
  }
 
+ /// <summary>
+ /// Removes all buffs with the specified ID and caster ID from the actor, updates resistances, handles related effects, and refreshes stats if necessary.
+ /// </summary>
+ /// <param name="id">The buff ID to remove.</param>
+ /// <param name="casterId">The object ID of the caster whose buffs should be removed.</param>
+ /// <returns>True if the removal process completes.</returns>
  public bool Remove(int id, int casterId) {
  //TODO: Check if buff is removable/should be removed
  bool refreshStats = false;

Maple2.Server.Game/Manager/Config/SkillManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Storage;
+using Maple2.Database.Storage;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
 using Maple2.Model.Metadata;
@@ -30,6 +30,9 @@ public void LoadSkillBook() {
  session.Send(SkillBookPacket.Load(SkillBook));
  }
 
+ /// <summary>
+ /// Applies all passive skill effects that target the player, updating active buffs based on the player's learned passive skills.
+ /// </summary>
  public void UpdatePassiveBuffs(bool notifyField = true) {
  // TODO: Only remove buffs that have been unlearned.
  /*foreach (Buff buff in session.Player.Buffs.Buffs.Values) {

Maple2.Server.Game/Manager/Field/FieldManager/FieldManager.State.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Numerics;
@@ -437,6 +437,10 @@ public void AddSkill(IActor caster, SkillEffectMetadata effect, Vector3[] points
  }
  }
 
+ /// <summary>
+ /// Adds splash skill effects from a skill record, calculating effect positions based on cube magic paths if applicable.
+ /// </summary>
+ /// <param name="record">The skill record containing caster, position, rotation, and attack metadata.</param>
  public void AddSkill(SkillRecord record) {
  SkillMetadataAttack attack = record.Attack;
  if (!TableMetadata.MagicPathTable.Entries.TryGetValue(attack.CubeMagicPathId, out IReadOnlyList<MagicPath>? cubeMagicPaths)) {
@@ -474,6 +478,14 @@ public void AddSkill(SkillRecord record) {
  }
  }
 
+ /// <summary>
+ /// Returns a filtered collection of actors within the specified prisms, based on the target type and limit.
+ /// </summary>
+ /// <param name="prisms">The prisms used to filter actors by location or area.</param>
+ /// <param name="targetType">The type of targets to select (e.g., friendly players, hostile mobs, or hungry mobs).</param>
+ /// <param name="limit">The maximum number of actors to return.</param>
+ /// <param name="ignore">An optional collection of actors to exclude from the results.</param>
+ /// <returns>An enumerable of actors matching the criteria, or an empty collection if the target type is unhandled.</returns>
  public IEnumerable<IActor> GetTargets(Prism[] prisms, ApplyTargetType targetType, int limit, ICollection<IActor>? ignore = null) {
  switch (targetType) {
  case ApplyTargetType.Friendly:

Maple2.Database/Context/MetadataContext.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Extensions;
+using Maple2.Database.Extensions;
 using Maple2.Database.Model.Metadata;
 using Maple2.Model.Game.Field;
 using Maple2.Model.Metadata;
@@ -59,6 +59,9 @@ protected override void OnModelCreating(ModelBuilder modelBuilder) {
  modelBuilder.Entity<FunctionCubeMetadata>(ConfigureFunctionCubeMetadata);
  }
 
+ /// <summary>
+ /// Configures the Entity Framework Core mapping for the AdditionalEffectMetadata entity, including table name, composite primary key, and JSON conversion for complex properties.
+ /// </summary>
  private static void ConfigureAdditionalEffectMetadata(EntityTypeBuilder<AdditionalEffectMetadata> builder) {
  builder.ToTable("additional-effect");
  builder.HasKey(effect => new { effect.Id, effect.Level });

Maple2.File.Ingest/Mapper/AdditionalEffectMapper.cs

@@ -1,4 +1,4 @@
-using Maple2.File.IO;
+using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.AdditionalEffect;
 using Maple2.Model.Enum;
@@ -16,6 +16,10 @@ public AdditionalEffectMapper(M2dReader xmlReader) {
  parser = new AdditionalEffectParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed additional effect data into strongly typed <see cref="AdditionalEffectMetadata"/> objects.
+ /// </summary>
+ /// <returns>An enumerable of <see cref="AdditionalEffectMetadata"/> representing all parsed additional effects.</returns>
  protected override IEnumerable<AdditionalEffectMetadata> Map() {
  foreach ((int id, IList<AdditionalEffectData> datas) in parser.Parse()) {
  foreach (AdditionalEffectData data in datas) {
@@ -231,6 +235,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  NotKill: dotDamage.notKill);
  }
 
+ /// <summary>
+ /// Converts a <see cref="DotBuffProperty"/> to a <see cref="AdditionalEffectMetadataDot.DotBuff"/> if the buff ID is positive; otherwise returns null.
+ /// </summary>
+ /// <param name="dotBuff">The DOT buff property to convert.</param>
+ /// <returns>A <see cref="AdditionalEffectMetadataDot.DotBuff"/> instance if valid; otherwise, null.</returns>
  private static AdditionalEffectMetadataDot.DotBuff? Convert(DotBuffProperty? dotBuff) {
  if (dotBuff is not { buffID: > 0 }) {
  return null;
@@ -239,6 +248,11 @@ private static AdditionalEffectMetadataStatus Convert(StatusProperty status, Off
  return new AdditionalEffectMetadataDot.DotBuff(Target: (SkillTargetType) dotBuff.target, Id: dotBuff.buffID, Level: dotBuff.buffLevel);
  }
 
+ /// <summary>
+ /// Converts a <see cref="ShieldProperty"/> to an <see cref="AdditionalEffectMetadataShield"/> if shield values are positive; otherwise returns null.
+ /// </summary>
+ /// <param name="shield">The shield property to convert.</param>
+ /// <returns>An <see cref="AdditionalEffectMetadataShield"/> if applicable; otherwise, null.</returns>
  private static AdditionalEffectMetadataShield? Convert(ShieldProperty shield) {
  if (shield is { hpValue: <= 0, hpByTargetMaxHP: <= 0 }) {
  return null;

Maple2.File.Ingest/Mapper/SkillMapper.cs

@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 using Maple2.File.IO;
 using Maple2.File.Parser;
 using Maple2.File.Parser.Xml.Skill;
@@ -14,6 +14,10 @@ public SkillMapper(M2dReader xmlReader) {
  parser = new SkillParser(xmlReader);
  }
 
+ /// <summary>
+ /// Maps parsed skill XML data into structured <see cref="StoredSkillMetadata"/> objects, transforming raw skill definitions into strongly typed metadata for further processing.
+ /// </summary>
+ /// <returns>An enumerable sequence of <see cref="StoredSkillMetadata"/> representing all valid skills parsed from the source data.</returns>
  protected override IEnumerable<StoredSkillMetadata> Map() {
  foreach ((int id, string name, SkillData data) in parser.Parse()) {
  if (data.basic == null) continue; // Old_JobChange_01
@@ -133,6 +137,11 @@ protected override IEnumerable<StoredSkillMetadata> Map() {
  }
  }
 
+ /// <summary>
+ /// Converts a <see cref="RegionSkill"/> object into a <see cref="SkillMetadataRange"/>, mapping region type strings to <see cref="SkillRegion"/> values and transferring relevant range properties.
+ /// </summary>
+ /// <param name="region">The region skill data to convert.</param>
+ /// <returns>A <see cref="SkillMetadataRange"/> representing the region's metadata.</returns>
  private static SkillMetadataRange Convert(RegionSkill region) {
  return new SkillMetadataRange(
  Type: region.rangeType switch {

Maple2.File.Ingest/MapperExtensions.cs

@@ -1,4 +1,4 @@
-using System.ComponentModel;
+using System.ComponentModel;
 using System.Diagnostics;
 using System.Reflection;
 using Maple2.File.Ingest.Utils;
@@ -227,6 +227,11 @@ public static byte OptionIndex(this SpecialAttribute attribute) {
  };
  }
 
+ /// <summary>
+ /// Converts a <see cref="TriggerSkill"/> instance into a <see cref="SkillEffectMetadata"/>, mapping its properties to either a splash or condition effect and assembling the associated skills.
+ /// </summary>
+ /// <param name="trigger">The trigger skill data to convert.</param>
+ /// <returns>A <see cref="SkillEffectMetadata"/> representing the trigger's effect, including splash or condition details and linked skills.</returns>
  public static SkillEffectMetadata Convert(this TriggerSkill trigger) {
  SkillEffectMetadataCondition? condition = null;
  SkillEffectMetadataSplash? splash = null;
@@ -316,6 +321,11 @@ public static SkillMetadataAutoTargeting Convert(this AutoTargeting autoTargetin
  UseMove: autoTargeting.autoTargetUseMove);
  }
 
+ /// <summary>
+ /// Converts a parsed XML skill begin condition into a strongly typed <see cref="BeginCondition"/> metadata object for use in Maple2 game logic.
+ /// </summary>
+ /// <param name="beginCondition">The XML-parsed skill begin condition to convert.</param>
+ /// <returns>A <see cref="BeginCondition"/> instance containing mapped level, gender, mesos, stats, map and skill requirements, job codes, probability, cooldowns, durations, state flags, dungeon group types, weapon requirements, and subconditions for target, owner, and caster.</returns>
  public static BeginCondition Convert(this Maple2.File.Parser.Xml.Skill.BeginCondition beginCondition) {
  return new BeginCondition(
  Level: beginCondition.level,

Maple2.Server.Core/Packets/RequestPacket.cs

@@ -1,4 +1,4 @@
-using Maple2.PacketLib.Tools;
+using Maple2.PacketLib.Tools;
 using Maple2.Server.Core.Constants;
 
 namespace Maple2.Server.Core.Packets;
@@ -8,10 +8,18 @@ public static ByteWriter Login() {
  return Packet.Of(SendOp.RequestLogin);
  }
 
+ /// <summary>
+ /// Creates a packet for requesting a session key from the server.
+ /// </summary>
+ /// <returns>A <see cref="ByteWriter"/> containing the key request packet.</returns>
  public static ByteWriter Key() {
  return Packet.Of(SendOp.RequestKey);
  }
 
+ /// <summary>
+ /// Creates a heartbeat request packet containing the current system tick count.
+ /// </summary>
+ /// <returns>A ByteWriter representing the heartbeat request packet.</returns>
  public static ByteWriter Heartbeat() {
  var pWriter = Packet.Of(SendOp.RequestHeartbeat);
  pWriter.WriteInt(Environment.TickCount);

Maple2.Server.Game/Commands/BuffCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using Maple2.Database.Storage;
@@ -40,6 +40,17 @@ public BuffCommand(GameSession session, SkillMetadataStorage skillStorage) : bas
  this.SetHandler<InvocationContext, int, int, int, int, bool, string, bool>(Handle, id, level, stack, duration, all, target, remove);
  }
 
+ /// <summary>
+ /// Processes the "buff" command to add or remove a specified buff on one or more players in the current field.
+ /// </summary>
+ /// <param name="ctx">The command invocation context.</param>
+ /// <param name="buffId">The ID of the buff to add or remove.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="stack">The number of buff stacks to apply.</param>
+ /// <param name="duration">The duration of the buff in seconds, or -1 for default duration.</param>
+ /// <param name="all">If true, applies the operation to all players in the field.</param>
+ /// <param name="target">The name of the target player to affect, or empty to target the command issuer.</param>
+ /// <param name="remove">If true, removes the buff instead of adding it.</param>
  private void Handle(InvocationContext ctx, int buffId, int level, int stack, int duration, bool all, string target, bool remove) {
  try {
  if (!skillStorage.TryGetEffect(buffId, (short) level, out AdditionalEffectMetadata? _)) {

Maple2.Server.Game/Commands/KillCommand.cs

@@ -1,4 +1,4 @@
-using System.CommandLine;
+using System.CommandLine;
 using System.CommandLine.Invocation;
 using System.CommandLine.IO;
 using System.Numerics;
@@ -141,6 +141,12 @@ private void Handle(InvocationContext ctx, string name) {
  }
  }
 
+ /// <summary>
+ /// Instantly kills the specified NPC by applying damage equal to its current health and broadcasts the resulting updates to the field.
+ /// </summary>
+ /// <param name="session">The game session performing the kill action.</param>
+ /// <param name="npc">The NPC to be killed.</param>
+ /// <param name="skill">The skill metadata used to generate the damage record.</param>
  private static void Kill(GameSession session, FieldNpc npc, SkillMetadata skill) {
  var damageRecord = new DamageRecord(skill, skill.Data.Motions[0].Attacks[0]) {
  CasterId = session.Player.ObjectId,

Maple2.Server.Game/Manager/AnimationManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Model.Enum;
+using Maple2.Model.Enum;
 using Maple2.Model.Metadata;
 using Maple2.Server.Core.Packets;
 using Maple2.Server.Game.Model;
@@ -199,7 +199,10 @@ public void CancelSequence() {
  /// <summary>
  /// Updates the animation state based on the current tick count.
  /// </summary>
- /// <param name="tickCount">The current server tick count</param>
+ /// <summary>
+ /// Updates the animation state for the actor based on the current server tick, processing keyframe events, handling looping, and resetting sequences as needed.
+ /// </summary>
+ /// <param name="tickCount">The current server tick count.</param>
  public void Update(long tickCount) {
  // Skip update if no animation metadata is available
  if (RigMetadata is null) {
@@ -349,7 +352,12 @@ public float GetSequenceSegmentTime(string keyframe1, string keyframe2) {
  /// </summary>
  /// <param name="sequenceTime">The current sequence time</param>
  /// <param name="key">The keyframe that was hit</param>
- /// <param name="speed">The current animation speed</param>
+ /// <summary>
+ /// Handles a keyframe event during an animation sequence, triggering actor callbacks and updating loop or end timing based on the keyframe type.
+ /// </summary>
+ /// <param name="sequenceTime">The current normalized time within the animation sequence.</param>
+ /// <param name="key">The animation keyframe being processed.</param>
+ /// <param name="speed">The current animation speed.</param>
  private void HitKeyframe(float sequenceTime, AnimationKey key, float speed) {
  isHandlingKeyframe = true;
 

Maple2.Server.Game/Manager/Config/BuffManager.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Numerics;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
@@ -61,6 +61,9 @@ public void Clear() {
  }
  }
 
+ /// <summary>
+ /// Applies entrance buffs and refreshes premium club buffs for the actor when entering a field.
+ /// </summary>
  public void LoadFieldBuffs() {
  // Lapenshards
  // Game Events
@@ -71,6 +74,18 @@ public void LoadFieldBuffs() {
  }
  }
 
+ /// <summary>
+ /// Adds a buff to the specified owner, handling stacking, duration, cooldowns, group conflicts, and effect application.
+ /// </summary>
+ /// <param name="caster">The actor applying the buff.</param>
+ /// <param name="owner">The actor receiving the buff.</param>
+ /// <param name="id">The buff's skill or effect ID.</param>
+ /// <param name="level">The level of the buff.</param>
+ /// <param name="startTick">The tick count when the buff starts.</param>
+ /// <param name="stacks">The number of stacks to apply (clamped to the buff's maximum).</param>
+ /// <param name="durationMs">The duration of the buff in milliseconds. If negative, uses the default duration.</param>
+ /// <param name="notifyField">Whether to broadcast the buff addition to the field.</param>
+ /// <param name="type">The event condition type triggering the buff application.</param>
  public void AddBuff(IActor caster, IActor owner, int id, short level, long startTick, int stacks = 0, int durationMs = -1, bool notifyField = true, EventConditionType type = EventConditionType.Activate) {
  if (!owner.Field.SkillMetadata.TryGetEffect(id, level, out AdditionalEffectMetadata? additionalEffect)) {
  logger.Error("Invalid buff: {SkillId},{Level}", id, level);
@@ -310,6 +325,11 @@ public float TotalCompulsionRate(CompulsionEventType type, int skillId = 0) {
  nestedCompulsionDic.Values.Where(compulsion => compulsion.SkillIds.Contains(skillId)).Sum(compulsion => compulsion.Rate);
  }
 
+ /// <summary>
+ /// Returns the resistance value for the specified attribute, or 0 if not present.
+ /// </summary>
+ /// <param name="attribute">The attribute for which to retrieve resistance.</param>
+ /// <returns>The resistance value for the given attribute, or 0 if none is set.</returns>
  public float GetResistance(BasicAttribute attribute) {
  if (Resistances.TryGetValue(attribute, out float value)) {
  return value;
@@ -318,6 +338,13 @@ public float GetResistance(BasicAttribute attribute) {
  return 0;
  }
 
+ /// <summary>
+ /// Calculates the total invoke value and rate for a specified invoke effect type, filtered by skill ID or skill group.
+ /// </summary>
+ /// <param name="invokeType">The type of invoke effect to aggregate.</param>
+ /// <param name="skillId">The skill ID to match against invoke effects.</param>
+ /// <param name="skillGroup">Optional skill group IDs to match against invoke effects.</param>
+ /// <returns>A tuple containing the total invoke value (as an integer) and the total invoke rate (as a float).</returns>
  public (int, float) GetInvokeValues(InvokeEffectType invokeType, int skillId, params int[] skillGroup) {
  if (!Invokes.TryGetValue(invokeType, out var nestedInvokeDic))
  return (0, 0f);
@@ -335,6 +362,9 @@ public float GetResistance(BasicAttribute attribute) {
  return ((int) value, rate);
  }
 
+ /// <summary>
+ /// Sets the shield health for a buff based on its metadata, using either a fixed value or a percentage of the actor's maximum health.
+ /// </summary>
  private void SetShield(Buff buff) {
  if (buff.Metadata.Shield == null) {
  return;
@@ -369,6 +399,9 @@ private void SetMount(Buff buff) {
  }
  }
 
+ /// <summary>
+ /// Applies update effects from the buff, including canceling specified buffs and resetting skill cooldowns for the actor.
+ /// </summary>
  private void SetUpdates(Buff buff) {
  if (buff.Metadata.Update.Cancel != null) {
  CancelBuffs(buff, buff.Metadata.Update.Cancel);
@@ -381,6 +414,15 @@ private void SetUpdates(Buff buff) {
  }
  }
  }
+ /// <summary>
+ /// Triggers an event for all enabled buffs, causing the owner to apply each buff's effects for the specified event type.
+ /// </summary>
+ /// <param name="caster">The actor who initiated the event.</param>
+ /// <param name="owner">The actor who owns the buffs.</param>
+ /// <param name="target">The target actor affected by the event.</param>
+ /// <param name="type">The event condition type that determines which effects to apply.</param>
+ /// <param name="skillId">Optional skill ID associated with the event.</param>
+ /// <param name="buffId">Optional buff ID associated with the event.</param>
  public void TriggerEvent(IActor caster, IActor owner, IActor target, EventConditionType type, int skillId = 0, int buffId = 0) {
  foreach (Buff buff in EnumerateBuffs()) {
  if (!buff.Enabled) {
@@ -520,6 +562,12 @@ public void Remove(params (int id, int casterId)[] buffIds) {
  }
  }
 
+ /// <summary>
+ /// Removes all buffs with the specified ID and caster ID from the actor, updates resistances, handles related effects, and refreshes stats if necessary.
+ /// </summary>
+ /// <param name="id">The buff ID to remove.</param>
+ /// <param name="casterId">The object ID of the caster whose buffs should be removed.</param>
+ /// <returns>True if the removal process completes.</returns>
  public bool Remove(int id, int casterId) {
  //TODO: Check if buff is removable/should be removed
  bool refreshStats = false;

Maple2.Server.Game/Manager/Config/SkillManager.cs

@@ -1,4 +1,4 @@
-using Maple2.Database.Storage;
+using Maple2.Database.Storage;
 using Maple2.Model.Enum;
 using Maple2.Model.Game;
 using Maple2.Model.Metadata;
@@ -30,6 +30,9 @@ public void LoadSkillBook() {
  session.Send(SkillBookPacket.Load(SkillBook));
  }
 
+ /// <summary>
+ /// Applies all passive skill effects that target the player, updating active buffs based on the player's learned passive skills.
+ /// </summary>
  public void UpdatePassiveBuffs(bool notifyField = true) {
  // TODO: Only remove buffs that have been unlearned.
  /*foreach (Buff buff in session.Player.Buffs.Buffs.Values) {

Maple2.Server.Game/Manager/Field/FieldManager/FieldManager.State.cs

@@ -1,4 +1,4 @@
-using System.Collections.Concurrent;
+using System.Collections.Concurrent;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Numerics;
@@ -437,6 +437,10 @@ public void AddSkill(IActor caster, SkillEffectMetadata effect, Vector3[] points
  }
  }
 
+ /// <summary>
+ /// Adds splash skill effects from a skill record, calculating effect positions based on cube magic paths if applicable.
+ /// </summary>
+ /// <param name="record">The skill record containing caster, position, rotation, and attack metadata.</param>
  public void AddSkill(SkillRecord record) {
  SkillMetadataAttack attack = record.Attack;
  if (!TableMetadata.MagicPathTable.Entries.TryGetValue(attack.CubeMagicPathId, out IReadOnlyList<MagicPath>? cubeMagicPaths)) {
@@ -474,6 +478,14 @@ public void AddSkill(SkillRecord record) {
  }
  }
 
+ /// <summary>
+ /// Returns a filtered collection of actors within the specified prisms, based on the target type and limit.
+ /// </summary>
+ /// <param name="prisms">The prisms used to filter actors by location or area.</param>
+ /// <param name="targetType">The type of targets to select (e.g., friendly players, hostile mobs, or hungry mobs).</param>
+ /// <param name="limit">The maximum number of actors to return.</param>
+ /// <param name="ignore">An optional collection of actors to exclude from the results.</param>
+ /// <returns>An enumerable of actors matching the criteria, or an empty collection if the target type is unhandled.</returns>
  public IEnumerable<IActor> GetTargets(Prism[] prisms, ApplyTargetType targetType, int limit, ICollection<IActor>? ignore = null) {
  switch (targetType) {
  case ApplyTargetType.Friendly: