lib/character/behaviors/effects.lua

@@ -166,6 +166,7 @@ end
 --- должен вызываться перед получением урона
 ---
 --- возвращает получаемый урон
+--- @param damage Impact
 --- @return Impact
 function behavior:beforeDamage(damage)
     local totalDamage = damage
@@ -193,6 +194,7 @@ end
 --- должен вызываться перед регенерацией
 ---
 --- возвращает кол-во здоровья
+--- @param amount Impact
 --- @return Impact
 function behavior:beforeRegeneration(amount)
     local totalAmount = amount

lib/utils/impact.lua

@@ -1,6 +1,6 @@
 --- @alias ImpactType "physic"|"magic"
 
---- Представляет из себя некое "взаимодействие", которое мы должны применить к игроку в зависимости от контекста,
+--- Представляет из себя некое "взаимодействие", которое мы должны применить к персонажу в зависимости от контекста,
 --- например, нанести урон.
 --- @class Impact
 --- @field intensity integer