From 8f752eac962001824d3901deab86812fc0d6234d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Franti=C5=A1ek=20Boh=C3=A1=C4=8Dek?=
 <fandabohacek@gmail.com>
Date: Sat, 7 Jan 2023 11:09:46 +0100
Subject: [PATCH] chore(game): add missing documentation

---
 .../Data/Items/PartnerEquipment.cs            |  7 +++++++
 Core/NosSmooth.Game/Data/Mates/Mate.cs        | 19 ++++++++++++++++++
 Core/NosSmooth.Game/Data/Mates/Partner.cs     | 19 ++++++++++++++++++
 .../NosSmooth.Game/Data/Mates/PartnerSkill.cs |  6 ++++++
 Core/NosSmooth.Game/Data/Mates/PartnerSp.cs   |  8 ++++++++
 .../NosSmooth.Game/Data/Mates/PartyPartner.cs |  4 ++++
 Core/NosSmooth.Game/Data/Mates/PartyPet.cs    |  4 ++++
 Core/NosSmooth.Game/Data/Mates/Pet.cs         | 20 +++++++++++++++++++
 Core/NosSmooth.Game/Data/Social/Group.cs      |  1 -
 .../NosSmooth.Game/Data/Social/GroupMember.cs |  6 +++++-
 .../Data/Stats/MateArmorStats.cs              | 13 ++++++++++--
 .../Data/Stats/MateAttackStats.cs             |  9 +++++++++
 Core/NosSmooth.Game/Data/Stats/Resistance.cs  |  7 +++++++
 .../Events/Groups/GroupInitializedEvent.cs    |  7 +++++++
 .../Events/Groups/GroupMemberStatEvent.cs     |  4 ++++
 .../Events/Mates/MateStatEvent.cs             |  6 ++++++
 .../Mates/MatesPartyInitializedEvent.cs       |  5 +++++
 .../Events/Mates/PartnerInitializedEvent.cs   |  4 ++++
 .../Mates/PartnerSkillsReceivedEvent.cs       |  5 +++++
 .../Events/Mates/PetInitializedEvent.cs       |  4 ++++
 .../Events/Mates/PetSkillReceivedEvent.cs     |  5 +++++
 .../Server/Entities/RevivePacket.cs           |  7 +++++++
 .../Server/Groups/PinitMateSubPacket.cs       |  9 +++++++++
 .../Server/Groups/PinitPlayerSubPacket.cs     | 12 +++++++++++
 .../Server/Groups/PstPacket.cs                |  4 +++-
 .../Server/Mates/ScNPacket.cs                 |  2 +-
 26 files changed, 191 insertions(+), 6 deletions(-)

diff --git a/Core/NosSmooth.Game/Data/Items/PartnerEquipment.cs b/Core/NosSmooth.Game/Data/Items/PartnerEquipment.cs
index a17b407a6dde14c94f00faeb6444bbe61b1b01e3..c5cfd5f08396d39baae8685ac04ea47bbe4cdc4e 100644
--- a/Core/NosSmooth.Game/Data/Items/PartnerEquipment.cs
+++ b/Core/NosSmooth.Game/Data/Items/PartnerEquipment.cs
@@ -6,6 +6,13 @@
 
 namespace NosSmooth.Game.Data.Items;
 
+/// <summary>
+/// An equipment of a partner.
+/// </summary>
+/// <param name="Weapon">The weapon of the partner.</param>
+/// <param name="Armor">The armor of the partner.</param>
+/// <param name="Gauntlet">The gauntlet of the partner.</param>
+/// <param name="Boots">The boots of the partner.</param>
 public record PartnerEquipment
 (
     UpgradeableItem? Weapon,
diff --git a/Core/NosSmooth.Game/Data/Mates/Mate.cs b/Core/NosSmooth.Game/Data/Mates/Mate.cs
index 0f6928a9da52fff8d5a34d34fb853c51ad7e4465..69888401b569a70c2c40a4c4c5233cc260b4d62e 100644
--- a/Core/NosSmooth.Game/Data/Mates/Mate.cs
+++ b/Core/NosSmooth.Game/Data/Mates/Mate.cs
@@ -11,6 +11,25 @@ using NosSmooth.PacketSerializer.Abstractions.Common;
 
 namespace NosSmooth.Game.Data.Mates;
 
+/// <summary>
+/// Information about player's pet or partner.
+/// </summary>
+/// <remarks>
+/// Used for mates the character owns
+/// </remarks>
+/// <param name="MateId">The id of the mate.</param>
+/// <param name="NpcVNum">The vnum of the mate.</param>
+/// <param name="TransportId">Unknown function TODO.</param>
+/// <param name="Level">The level of the mate.</param>
+/// <param name="Loyalty">The loyalty of the mate.</param>
+/// <param name="Attack">The attack statistics of the mate.</param>
+/// <param name="Armor">The armor statistics of the mate.</param>
+/// <param name="Element">The element of the mate.</param>
+/// <param name="Resistance">The resistance of the mate.</param>
+/// <param name="Hp">The health of the mate.</param>
+/// <param name="Mp">The mana of the mate.</param>
+/// <param name="Name">The name of the mate.</param>
+/// <param name="IsSummonable">Whether the mate is summonable.</param>
 public record Mate
 (
     long MateId,
diff --git a/Core/NosSmooth.Game/Data/Mates/Partner.cs b/Core/NosSmooth.Game/Data/Mates/Partner.cs
index aacdb4da2d8d1c7856cdd1f58e7839be7914dcb1..608fb3cb309fc5d59a60f251f0a505416f09579a 100644
--- a/Core/NosSmooth.Game/Data/Mates/Partner.cs
+++ b/Core/NosSmooth.Game/Data/Mates/Partner.cs
@@ -11,6 +11,25 @@ using NosSmooth.Packets.Enums;
 
 namespace NosSmooth.Game.Data.Mates;
 
+/// <summary>
+/// Information about player's partner
+/// </summary>
+/// <param name="MateId">The id of the mate.</param>
+/// <param name="NpcVNum">The vnum of the mate.</param>
+/// <param name="TransportId">Unknown function TODO.</param>
+/// <param name="Level">The level of the mate.</param>
+/// <param name="Loyalty">The loyalty of the mate.</param>
+/// <param name="Attack">The attack statistics of the mate.</param>
+/// <param name="Armor">The armor statistics of the mate.</param>
+/// <param name="Equipment">The equipment of the partner.</param>
+/// <param name="Element">The element of the mate.</param>
+/// <param name="Resistance">The resistance of the mate.</param>
+/// <param name="Hp">The health of the mate.</param>
+/// <param name="Mp">The mana of the mate.</param>
+/// <param name="MorphVNum">The morph vnum of the partner.</param>
+/// <param name="Name">The name of the mate.</param>
+/// <param name="IsSummonable">Whether the mate is summonable.</param>
+/// <param name="Sp">The equipped sp of the partner.</param>
 public record Partner
 (
     long MateId,
diff --git a/Core/NosSmooth.Game/Data/Mates/PartnerSkill.cs b/Core/NosSmooth.Game/Data/Mates/PartnerSkill.cs
index 491a777b468627193ecbce66862e268268419702..cbf0c216d00ae9b55d572b573c531cc41e31085d 100644
--- a/Core/NosSmooth.Game/Data/Mates/PartnerSkill.cs
+++ b/Core/NosSmooth.Game/Data/Mates/PartnerSkill.cs
@@ -10,6 +10,12 @@ using NosSmooth.Packets.Enums.Mates;
 
 namespace NosSmooth.Game.Data.Mates;
 
+/// <summary>
+/// A skill of a partner's sp.
+/// </summary>
+/// <param name="SkillVNum">The vnum of the skill.</param>
+/// <param name="Rank">The partner rank of the skill.</param>
+/// <param name="Info">The info of the skill.</param>
 public record PartnerSkill
 (
     int SkillVNum,
diff --git a/Core/NosSmooth.Game/Data/Mates/PartnerSp.cs b/Core/NosSmooth.Game/Data/Mates/PartnerSp.cs
index 20cf1577f6bd5503bc0e04ea73826e730587e1fd..8274f437c57cd87c6ec5a139f166b972c13f70f8 100644
--- a/Core/NosSmooth.Game/Data/Mates/PartnerSp.cs
+++ b/Core/NosSmooth.Game/Data/Mates/PartnerSp.cs
@@ -8,6 +8,14 @@ using NosSmooth.Game.Data.Characters;
 
 namespace NosSmooth.Game.Data.Mates;
 
+/// <summary>
+/// An sp of the partner.
+/// </summary>
+/// <param name="VNum">The vnum of the sp item.</param>
+/// <param name="AgilityPercentage">The agility percentage for acquiring skills.</param>
+/// <param name="Skill1">Information about the first skill of the partner.</param>
+/// <param name="Skill2">Information about the second skill of the partner.</param>
+/// <param name="Skill3">Information about the third skill of the partner.</param>
 public record PartnerSp
 (
     long VNum,
diff --git a/Core/NosSmooth.Game/Data/Mates/PartyPartner.cs b/Core/NosSmooth.Game/Data/Mates/PartyPartner.cs
index a2f7b105ebb8ff004f8ee452621423eff3ba0ee2..ffb8429f2c527e45f074a55fc824062233f35c69 100644
--- a/Core/NosSmooth.Game/Data/Mates/PartyPartner.cs
+++ b/Core/NosSmooth.Game/Data/Mates/PartyPartner.cs
@@ -8,6 +8,10 @@ using NosSmooth.Game.Data.Info;
 
 namespace NosSmooth.Game.Data.Mates;
 
+/// <summary>
+/// Information about a partner that is currently in character's party.
+/// </summary>
+/// <param name="Partner">The underlying partner.</param>
 public record PartyPartner
 (
     Partner Partner
diff --git a/Core/NosSmooth.Game/Data/Mates/PartyPet.cs b/Core/NosSmooth.Game/Data/Mates/PartyPet.cs
index fd11c78e6a35210902b8fd906e2c02783e0af86e..22bf25ab09d240d29caa5159d701ec5edbb163d2 100644
--- a/Core/NosSmooth.Game/Data/Mates/PartyPet.cs
+++ b/Core/NosSmooth.Game/Data/Mates/PartyPet.cs
@@ -8,6 +8,10 @@ using NosSmooth.Game.Data.Info;
 
 namespace NosSmooth.Game.Data.Mates;
 
+/// <summary>
+/// Information about a pet that is currently in character's party.
+/// </summary>
+/// <param name="Pet">The underlying pet.</param>
 public record PartyPet
 (
     Pet Pet
diff --git a/Core/NosSmooth.Game/Data/Mates/Pet.cs b/Core/NosSmooth.Game/Data/Mates/Pet.cs
index f00475abce7ae7f5e3b72ee64f8de8b3a99445db..3dd142baa5b7321c99b16de40b00b509da40616f 100644
--- a/Core/NosSmooth.Game/Data/Mates/Pet.cs
+++ b/Core/NosSmooth.Game/Data/Mates/Pet.cs
@@ -12,6 +12,26 @@ using NosSmooth.PacketSerializer.Abstractions.Common;
 
 namespace NosSmooth.Game.Data.Mates;
 
+/// <summary>
+/// Information about player's pet or partner.
+/// </summary>
+/// <remarks>
+/// Used for mates the character owns
+/// </remarks>
+/// <param name="MateId">The id of the mate.</param>
+/// <param name="NpcVNum">The vnum of the mate.</param>
+/// <param name="TransportId">Unknown function TODO.</param>
+/// <param name="Level">The level of the mate.</param>
+/// <param name="Loyalty">The loyalty of the mate.</param>
+/// <param name="Attack">The attack statistics of the mate.</param>
+/// <param name="Armor">The armor statistics of the mate.</param>
+/// <param name="Element">The element of the mate.</param>
+/// <param name="Resistance">The resistance of the mate.</param>
+/// <param name="Hp">The health of the mate.</param>
+/// <param name="Mp">The mana of the mate.</param>
+/// <param name="Name">The name of the mate.</param>
+/// <param name="IsSummonable">Whether the mate is summonable.</param>
+/// <param name="CanPickUp">Whether the pet can pick up items.</param>
 public record Pet
 (
     long MateId,
diff --git a/Core/NosSmooth.Game/Data/Social/Group.cs b/Core/NosSmooth.Game/Data/Social/Group.cs
index 94dcb49baad65c5800e077a587abe5e15c8f23a1..691611f312a1d7021a31dc4d4f6b37090ee10511 100644
--- a/Core/NosSmooth.Game/Data/Social/Group.cs
+++ b/Core/NosSmooth.Game/Data/Social/Group.cs
@@ -16,7 +16,6 @@ namespace NosSmooth.Game.Data.Social;
 /// Represents nostale group of players or pets and partners.
 /// </summary>
 /// <param name="Id">The id of the group.</param>
-/// <param name="Size">The size of the group.</param>
 /// <param name="Members">The members of the group. (excluding the character)</param>
 public record Group(short? Id, IReadOnlyList<GroupMember>? Members)
 {
diff --git a/Core/NosSmooth.Game/Data/Social/GroupMember.cs b/Core/NosSmooth.Game/Data/Social/GroupMember.cs
index bb4655248b579f3463964228a11b964ab7943583..9c13d0986d642aecc6e01bf2e93d2ed7020a2b26 100644
--- a/Core/NosSmooth.Game/Data/Social/GroupMember.cs
+++ b/Core/NosSmooth.Game/Data/Social/GroupMember.cs
@@ -9,6 +9,10 @@ using NosSmooth.Packets.Enums.Players;
 
 namespace NosSmooth.Game.Data.Social;
 
+/// <summary>
+/// A member of a group the character is in.
+/// </summary>
+/// <param name="PlayerId">The id of the group member player.</param>
 public record GroupMember(long PlayerId)
 {
     /// <summary>
@@ -54,5 +58,5 @@ public record GroupMember(long PlayerId)
     /// <summary>
     /// Gets the effects of the member.
     /// </summary>
-    public IReadOnlyList<long>? EffectsVNums { get; internal set; }
+    public IReadOnlyList<short>? EffectsVNums { get; internal set; }
 }
\ No newline at end of file
diff --git a/Core/NosSmooth.Game/Data/Stats/MateArmorStats.cs b/Core/NosSmooth.Game/Data/Stats/MateArmorStats.cs
index fd1127f04f13e14f7268e9c950f68fbabffdacce..cb2d860028baee31a7ce096c6b45a05c3f175e9c 100644
--- a/Core/NosSmooth.Game/Data/Stats/MateArmorStats.cs
+++ b/Core/NosSmooth.Game/Data/Stats/MateArmorStats.cs
@@ -6,12 +6,21 @@
 
 namespace NosSmooth.Game.Data.Stats;
 
+/// <summary>
+/// Stats about mate armor.
+/// </summary>
+/// <param name="DefenceUpgrade">The upgrade of defence.</param>
+/// <param name="MeleeDefence">The melee defence.</param>
+/// <param name="MeleeDefenceDodge">The melee dodge rate.</param>
+/// <param name="RangedDefence">The ranged defence.</param>
+/// <param name="RangedDodgeRate">The ranged dodge rate.</param>
+/// <param name="MagicalDefence">The magical defence.</param>
 public record MateArmorStats
 (
     short DefenceUpgrade,
     int MeleeDefence,
     int MeleeDefenceDodge,
-    int RangeDefence,
-    int RangeDodgeRate,
+    int RangedDefence,
+    int RangedDodgeRate,
     int MagicalDefence
 );
\ No newline at end of file
diff --git a/Core/NosSmooth.Game/Data/Stats/MateAttackStats.cs b/Core/NosSmooth.Game/Data/Stats/MateAttackStats.cs
index 672c2303a4c86e9b5b70e8d8b718519b7aaeec94..b79e21e874aca8254069203f60e9e4c1e94ec1d9 100644
--- a/Core/NosSmooth.Game/Data/Stats/MateAttackStats.cs
+++ b/Core/NosSmooth.Game/Data/Stats/MateAttackStats.cs
@@ -6,6 +6,15 @@
 
 namespace NosSmooth.Game.Data.Stats;
 
+/// <summary>
+/// Stats about mate attack.
+/// </summary>
+/// <param name="AttackUpgrade">The upgrade of attack.</param>
+/// <param name="MinimumAttack">The minimum attack.</param>
+/// <param name="MaximumAttack">The maximum attack.</param>
+/// <param name="Precision">The precision or concentration.</param>
+/// <param name="CriticalChance">The critical chance.</param>
+/// <param name="CriticalRate">The critical rate.</param>
 public record MateAttackStats
 (
     short AttackUpgrade,
diff --git a/Core/NosSmooth.Game/Data/Stats/Resistance.cs b/Core/NosSmooth.Game/Data/Stats/Resistance.cs
index 7386e148ec65d09c2c6cebe8276d6dc4bdf08d4a..af263bb1f2e7b24311981c795923aaa759717bbd 100644
--- a/Core/NosSmooth.Game/Data/Stats/Resistance.cs
+++ b/Core/NosSmooth.Game/Data/Stats/Resistance.cs
@@ -6,6 +6,13 @@
 
 namespace NosSmooth.Game.Data.Stats;
 
+/// <summary>
+/// Stats about resistance of character or mate.
+/// </summary>
+/// <param name="FireResistance">The fire resistance percentage.</param>
+/// <param name="WaterResistance">The water resistance percentage.</param>
+/// <param name="LightResistance">The light resistance percentage.</param>
+/// <param name="DarkResistance">The dark resistance percentage.</param>
 public record Resistance
 (
     short FireResistance,
diff --git a/Core/NosSmooth.Game/Events/Groups/GroupInitializedEvent.cs b/Core/NosSmooth.Game/Events/Groups/GroupInitializedEvent.cs
index 6afd6fdd4dfc75757c9e2b2f427d7eb83567d5b0..63e5a0a43e26329e1f6bdfae05112d9096c8047f 100644
--- a/Core/NosSmooth.Game/Events/Groups/GroupInitializedEvent.cs
+++ b/Core/NosSmooth.Game/Events/Groups/GroupInitializedEvent.cs
@@ -8,4 +8,11 @@ using NosSmooth.Game.Data.Social;
 
 namespace NosSmooth.Game.Events.Groups;
 
+/// <summary>
+/// A group has been initialized.
+/// </summary>
+/// <remarks>
+/// May be sent multiple times even for the same group.
+/// </remarks>
+/// <param name="Group">The initialized group with members.</param>
 public record GroupInitializedEvent(Group Group) : IGameEvent;
\ No newline at end of file
diff --git a/Core/NosSmooth.Game/Events/Groups/GroupMemberStatEvent.cs b/Core/NosSmooth.Game/Events/Groups/GroupMemberStatEvent.cs
index b7074ec0c74c59334b2627340ab551b0357ddfeb..e914e1786b037af1af3ecfe846d8187d54a5a19d 100644
--- a/Core/NosSmooth.Game/Events/Groups/GroupMemberStatEvent.cs
+++ b/Core/NosSmooth.Game/Events/Groups/GroupMemberStatEvent.cs
@@ -8,4 +8,8 @@ using NosSmooth.Game.Data.Social;
 
 namespace NosSmooth.Game.Events.Groups;
 
+/// <summary>
+/// A new stats (hp, mp) of a group received.
+/// </summary>
+/// <param name="Member">The updated group member.</param>
 public record GroupMemberStatEvent(GroupMember Member) : IGameEvent;
\ No newline at end of file
diff --git a/Core/NosSmooth.Game/Events/Mates/MateStatEvent.cs b/Core/NosSmooth.Game/Events/Mates/MateStatEvent.cs
index acf3182b34a413220b8c9b51f10c76353b2bdf0f..a73e3b2228f2ae1f302b5e2eeb1b00badd777744 100644
--- a/Core/NosSmooth.Game/Events/Mates/MateStatEvent.cs
+++ b/Core/NosSmooth.Game/Events/Mates/MateStatEvent.cs
@@ -10,4 +10,10 @@ using NosSmooth.Game.Data.Social;
 
 namespace NosSmooth.Game.Events.Mates;
 
+/// <summary>
+/// A new stats (hp, mp) of a mate received.
+/// </summary>
+/// <param name="Mate">The mate.</param>
+/// <param name="Hp">The current hp of the mate.</param>
+/// <param name="Mp">The current mp of the mate.</param>
 public record MateStatEvent(Mate Mate, Health Hp, Health Mp) : IGameEvent;
\ No newline at end of file
diff --git a/Core/NosSmooth.Game/Events/Mates/MatesPartyInitializedEvent.cs b/Core/NosSmooth.Game/Events/Mates/MatesPartyInitializedEvent.cs
index 1b36cde57eed68fcb49832860dc99f67e8daef65..5922d59ac6503a4bade8b207b1f9eb022048268e 100644
--- a/Core/NosSmooth.Game/Events/Mates/MatesPartyInitializedEvent.cs
+++ b/Core/NosSmooth.Game/Events/Mates/MatesPartyInitializedEvent.cs
@@ -9,4 +9,9 @@ using NosSmooth.Game.Data.Social;
 
 namespace NosSmooth.Game.Events.Mates;
 
+/// <summary>
+/// A party was initialized and got information about currently present party pets.
+/// </summary>
+/// <param name="Pet">The party pet.</param>
+/// <param name="Partner">The party partner.</param>
 public record MatesPartyInitializedEvent(Pet? Pet, Partner? Partner) : IGameEvent;
\ No newline at end of file
diff --git a/Core/NosSmooth.Game/Events/Mates/PartnerInitializedEvent.cs b/Core/NosSmooth.Game/Events/Mates/PartnerInitializedEvent.cs
index 4bddce5d6e05d2c4bc574effd3cd5eec0ac44367..1a758edd80b861ec3928aa492a58e91f1612b808 100644
--- a/Core/NosSmooth.Game/Events/Mates/PartnerInitializedEvent.cs
+++ b/Core/NosSmooth.Game/Events/Mates/PartnerInitializedEvent.cs
@@ -9,4 +9,8 @@ using NosSmooth.Game.Data.Social;
 
 namespace NosSmooth.Game.Events.Mates;
 
+/// <summary>
+/// A partner the character owns was initialized.
+/// </summary>
+/// <param name="Partner">The partner.</param>
 public record PartnerInitializedEvent(Partner Partner) : IGameEvent;
\ No newline at end of file
diff --git a/Core/NosSmooth.Game/Events/Mates/PartnerSkillsReceivedEvent.cs b/Core/NosSmooth.Game/Events/Mates/PartnerSkillsReceivedEvent.cs
index 1c4648aa10bebbb6f18e8fbab7083eaffff2f816..297485dc9edfb16b8c59c257cb96860098ed0d2e 100644
--- a/Core/NosSmooth.Game/Events/Mates/PartnerSkillsReceivedEvent.cs
+++ b/Core/NosSmooth.Game/Events/Mates/PartnerSkillsReceivedEvent.cs
@@ -10,4 +10,9 @@ using NosSmooth.Game.Data.Social;
 
 namespace NosSmooth.Game.Events.Mates;
 
+/// <summary>
+/// A partner the character owns skills were received.
+/// </summary>
+/// <param name="Partner">The partner.</param>
+/// <param name="Skills">The skills of the partner.</param>
 public record PartnerSkillsReceivedEvent(Partner? Partner, IReadOnlyList<Skill> Skills) : IGameEvent;
\ No newline at end of file
diff --git a/Core/NosSmooth.Game/Events/Mates/PetInitializedEvent.cs b/Core/NosSmooth.Game/Events/Mates/PetInitializedEvent.cs
index 175bf1b2ae7a4856fac5f21e5fc26baada64ea53..5afb3192b77129096b079b0176b6553a7ab0e854 100644
--- a/Core/NosSmooth.Game/Events/Mates/PetInitializedEvent.cs
+++ b/Core/NosSmooth.Game/Events/Mates/PetInitializedEvent.cs
@@ -9,4 +9,8 @@ using NosSmooth.Game.Data.Social;
 
 namespace NosSmooth.Game.Events.Mates;
 
+/// <summary>
+/// A pet the character owns was initialized.
+/// </summary>
+/// <param name="Pet">The pet.</param>
 public record PetInitializedEvent(Pet Pet) : IGameEvent;
\ No newline at end of file
diff --git a/Core/NosSmooth.Game/Events/Mates/PetSkillReceivedEvent.cs b/Core/NosSmooth.Game/Events/Mates/PetSkillReceivedEvent.cs
index 4b5c11248da78d768abd493b8a2d91d6b0a6a0d0..afcc8fc98e5a88d144a341adfe57b56631d894e8 100644
--- a/Core/NosSmooth.Game/Events/Mates/PetSkillReceivedEvent.cs
+++ b/Core/NosSmooth.Game/Events/Mates/PetSkillReceivedEvent.cs
@@ -10,4 +10,9 @@ using NosSmooth.Game.Data.Social;
 
 namespace NosSmooth.Game.Events.Mates;
 
+/// <summary>
+/// A pet the character owns skill was received.
+/// </summary>
+/// <param name="Pet">The pet.</param>
+/// <param name="PetSkill">The skill of the pet.</param>
 public record PetSkillReceivedEvent(Pet? Pet, Skill? PetSkill) : IGameEvent;
\ No newline at end of file
diff --git a/Packets/NosSmooth.Packets/Server/Entities/RevivePacket.cs b/Packets/NosSmooth.Packets/Server/Entities/RevivePacket.cs
index 66c3cbe550ba5342fcff85d46cf488feedd4c02d..ca9daa8d8563d0cd201adf5c5cc844c714b6d097 100644
--- a/Packets/NosSmooth.Packets/Server/Entities/RevivePacket.cs
+++ b/Packets/NosSmooth.Packets/Server/Entities/RevivePacket.cs
@@ -9,6 +9,13 @@ using NosSmooth.PacketSerializer.Abstractions.Attributes;
 
 namespace NosSmooth.Packets.Server.Entities;
 
+/// <summary>
+/// A packet specifying a revival
+/// of an entity, usually a player.
+/// </summary>
+/// <param name="EntityType">The type of the revived entity.</param>
+/// <param name="EntityId">The id of the revived entity.</param>
+/// <param name="TimeSpaceLives">Unknown function, seems like representing lives in a timespace.</param>
 [PacketHeader("revive", PacketSource.Server)]
 [GenerateSerializer(true)]
 public record RevivePacket
diff --git a/Packets/NosSmooth.Packets/Server/Groups/PinitMateSubPacket.cs b/Packets/NosSmooth.Packets/Server/Groups/PinitMateSubPacket.cs
index 9d1b345dbdab44f421d839fd7dc17a558840232a..c4bc766465c5e027472d717de779f1f1a05b1a00 100644
--- a/Packets/NosSmooth.Packets/Server/Groups/PinitMateSubPacket.cs
+++ b/Packets/NosSmooth.Packets/Server/Groups/PinitMateSubPacket.cs
@@ -11,6 +11,15 @@ using NosSmooth.PacketSerializer.Abstractions.Common;
 
 namespace NosSmooth.Packets.Server.Groups;
 
+/// <summary>
+/// A sub packet of <see cref="PinitPacket"/>
+/// representing a mate.
+/// </summary>
+/// <param name="MateType">The type of the mate.</param>
+/// <param name="Level">The level of the mate.</param>
+/// <param name="Name">The name of the mate.</param>
+/// <param name="Unknown">Unknown TODO.</param>
+/// <param name="VNum">The VNum of the mate entity.</param>
 public record PinitMateSubPacket
 (
     [PacketIndex(0)]
diff --git a/Packets/NosSmooth.Packets/Server/Groups/PinitPlayerSubPacket.cs b/Packets/NosSmooth.Packets/Server/Groups/PinitPlayerSubPacket.cs
index 8c30820f836e4919cb04400fdc4a39bb981a1f3f..19b80c983313f26718b6f8c4478ecee6a8f1525b 100644
--- a/Packets/NosSmooth.Packets/Server/Groups/PinitPlayerSubPacket.cs
+++ b/Packets/NosSmooth.Packets/Server/Groups/PinitPlayerSubPacket.cs
@@ -12,6 +12,18 @@ using NosSmooth.PacketSerializer.Abstractions.Common;
 
 namespace NosSmooth.Packets.Server.Groups;
 
+/// <summary>
+/// A sub packet of <see cref="PinitPacket"/>
+/// representing a player.
+/// </summary>
+/// <param name="GroupPosition">The position in the group.</param>
+/// <param name="Level">The level of the player.</param>
+/// <param name="Name">The name of the player.</param>
+/// <param name="GroupId">The group id of the group character is in.</param>
+/// <param name="Sex">The sex of the player.</param>
+/// <param name="Class">The class of the player.</param>
+/// <param name="MorphVNum">The morph of the player</param>
+/// <param name="HeroLevel">The hero level of the player.</param>
 [PacketHeader(null, PacketSource.Server)]
 [GenerateSerializer(true)]
 public record PinitPlayerSubPacket
diff --git a/Packets/NosSmooth.Packets/Server/Groups/PstPacket.cs b/Packets/NosSmooth.Packets/Server/Groups/PstPacket.cs
index 0aa48f3a8f0592b68d52f365a945af4c653d8cb7..593d38d860ac3ca990020d4825add07419c9c5b8 100644
--- a/Packets/NosSmooth.Packets/Server/Groups/PstPacket.cs
+++ b/Packets/NosSmooth.Packets/Server/Groups/PstPacket.cs
@@ -16,7 +16,9 @@ namespace NosSmooth.Packets.Server.Groups;
 /// Party status packet.
 /// </summary>
 /// <param name="EntityType">The type of the entity.</param>
-/// <param name="GroupPosition">The position in the group of the entity</param>
+/// <param name="EntityId">The id of the entity.</param>
+/// <param name="GroupPosition">The position in the group of a player. Present only for players.</param>
+/// <param name="MateType">The type of a mate. Present only for mates.</param>
 /// <param name="HpPercentage">The hp percentage of the entity.</param>
 /// <param name="MpPercentage">The mp percentage of the entity.</param>
 /// <param name="Hp">The hp of the entity.</param>
diff --git a/Packets/NosSmooth.Packets/Server/Mates/ScNPacket.cs b/Packets/NosSmooth.Packets/Server/Mates/ScNPacket.cs
index 8a2e15b68d1379c3bda89a006d95c8e55d139933..ccdf768acd9cc6585b52ee5502d5f83466c4dcad 100644
--- a/Packets/NosSmooth.Packets/Server/Mates/ScNPacket.cs
+++ b/Packets/NosSmooth.Packets/Server/Mates/ScNPacket.cs
@@ -23,7 +23,7 @@ namespace NosSmooth.Packets.Server.Mates;
 /// <param name="Loyalty">The loyalty of the partner.</param>
 /// <param name="Experience">The experience of the partner.</param>
 /// <param name="WeaponSubPacket">Information about partner's weapon.</param>
-/// <param name="ArmodSubPacket">Information about partner's armor.</param>
+/// <param name="ArmorSubPacket">Information about partner's armor.</param>
 /// <param name="GauntletSubPacket">Information about partner's gauntlet.</param>
 /// <param name="BootsSubPacket">Information about partner's boots.</param>
 /// <param name="Unknown1">Unknown TODO.</param>