Character::getSpecialization() - Code Metrics - heroesofabenez/combat - Measure and Improve Code Quality continuously with Scrutinizer

Character::getSpecialization() A
last analyzed 2025-08-30 12:01 UTC

↳ Parent: Character

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes	2
Bugs	0	Features	0

Metric	Value
eloc	1
c	2
b	0
f	0
dl	0
loc	3
rs	10
ccs	0
cts	1
cp	0
cc	1
nc	1
nop	0
crap	2

<?php
declare(strict_types=1);

namespace HeroesofAbenez\Combat;

use Nexendrie\Utils\Numbers;
use Symfony\Component\OptionsResolver\OptionsResolver;

/**
 * Structure for single character
 *
 * @author Jakub Konečný
 * @property-read int|string $id
 * @property-read string $name
 * @property-read string $gender
 * @property-read string $race
 * @property-read string $occupation
 * @property-read string $specialization
 * @property-read int $level
 * @property-read int $strength
 * @property-read int $strengthBase
 * @property-read int $dexterity
 * @property-read int $dexterityBase
 * @property-read int $constitution
 * @property-read int $constitutionBase
 * @property-read int $intelligence
 * @property-read int $intelligenceBase
 * @property-read int $charisma
 * @property-read int $charismaBase
 * @property-read int $maxHitpoints
 * @property-read int $maxHitpointsBase
 * @property-read int $hitpoints
 * @property-read int $damage
 * @property-read int $damageBase
 * @property-read int $hit
 * @property-read int $hitBase
 * @property-read int $dodge
 * @property-read int $dodgeBase
 * @property-read int $initiative
 * @property-read int $initiativeBase
 * @property-read string $initiativeFormula
 * @property-read int $defense
 * @property-read int $defenseBase
 * @property-read int|null $activePet
 * @property-read bool $stunned
 * @property-read bool $poisoned
 * @property-read bool $hidden
 * @property-read BaseCharacterSkill[] $usableSkills
 * @property IInitiativeFormulaParser $initiativeFormulaParser
 * @property int $positionRow
 * @property int $positionColumn
 */
class Character
{
    use \Nette\SmartObject;

    public const HITPOINTS_PER_CONSTITUTION = 5;
    public const STAT_STRENGTH = "strength";
    public const STAT_DEXTERITY = "dexterity";
    public const STAT_CONSTITUTION = "constitution";
    public const STAT_INTELLIGENCE = "intelligence";
    public const STAT_CHARISMA = "charisma";
    public const STAT_MAX_HITPOINTS = "maxHitpoints";
    public const STAT_DAMAGE = "damage";
    public const STAT_DEFENSE = "defense";
    public const STAT_HIT = "hit";
    public const STAT_DODGE = "dodge";
    public const STAT_INITIATIVE = "initiative";
    public const BASE_STATS = [
        self::STAT_STRENGTH,
        self::STAT_DEXTERITY,
        self::STAT_CONSTITUTION,
        self::STAT_INTELLIGENCE,
        self::STAT_CHARISMA,
    ];
    public const SECONDARY_STATS = [
        self::STAT_MAX_HITPOINTS,
        self::STAT_DAMAGE,
        self::STAT_DEFENSE,
        self::STAT_HIT,
        self::STAT_DODGE,
        self::STAT_INITIATIVE,
    ];
    public const STATUS_STUNNED = "stunned";
    public const STATUS_POISONED = "poisoned";
    public const STATUS_HIDDEN = "hidden";

    protected int|string $id;
    protected string $name;
    protected string $gender = "male";
    protected string $race;
    protected string $occupation;
    protected string $specialization;
    protected int $level;
    protected int $strength;
    protected int $strengthBase;
    protected int $dexterity;
    protected int $dexterityBase;
    protected int $constitution;
    protected int $constitutionBase;
    protected int $intelligence;
    protected int $intelligenceBase;
    protected int $charisma;
    protected int $charismaBase;
    protected int $maxHitpoints;
    protected int $maxHitpointsBase;
    protected int $hitpoints;
    protected int $damage = 0;
    protected int $damageBase = 0;
    protected int $hit = 0;
    protected int $hitBase = 0;
    protected int $dodge = 0;
    protected int $dodgeBase = 0;
    protected int $initiative = 0;
    protected int $initiativeBase = 0;
    protected string $initiativeFormula;
    protected IInitiativeFormulaParser $initiativeFormulaParser;
    protected float $defense = 0;
    protected float $defenseBase = 0;
    /** @var Equipment[]|EquipmentCollection Character's equipment */
    public EquipmentCollection $equipment;
    /** @var Pet[]|PetsCollection Character's pets */
    public PetsCollection $pets;
    /** @var BaseCharacterSkill[]|CharacterSkillsCollection Character's skills */
    public CharacterSkillsCollection $skills;
    protected ?int $activePet = null;
    /** @var CharacterEffect[]|CharacterEffectsCollection Active effects */
    public CharacterEffectsCollection $effects;
    /** @var ICharacterEffectsProvider[]|CharacterEffectsProvidersCollection */
    public CharacterEffectsProvidersCollection $effectProviders;
    protected int $positionRow = 0;
    protected int $positionColumn = 0;
    /** @var callable[] */
    protected array $statuses = [];

    /**
     *
     * @param array $stats Stats of the character
     * @param Equipment[] $equipment Equipment of the character
     * @param Pet[] $pets Pets owned by the character
     * @param BaseCharacterSkill[] $skills Skills acquired by the character
     */
    public function __construct(
        array $stats,
        array $equipment = [],
        array $pets = [],
        array $skills = [],
        IInitiativeFormulaParser $initiativeFormulaParser = new InitiativeFormulaParser()
    ) {
        $this->initiativeFormulaParser = $initiativeFormulaParser;
        $this->equipment = EquipmentCollection::fromArray($equipment);
        $this->pets = PetsCollection::fromArray($pets);
        $this->effectProviders = CharacterEffectsProvidersCollection::fromArray(array_merge($equipment, $pets));
        $this->skills = CharacterSkillsCollection::fromArray($skills);
        $this->equipment->lock();
        $this->pets->lock();
        $this->skills->lock();
        $this->setStats($stats);
        $this->effects = new CharacterEffectsCollection($this);
        $this->registerDefaultStatuses();
    }

    protected function registerDefaultStatuses(): void
    {
        $this->registerStatus(static::STATUS_STUNNED, function (Character $character): bool {
            return $character->effects->hasItems(["type" => SkillSpecial::TYPE_STUN]);
        });
        $this->registerStatus(static::STATUS_POISONED, function (Character $character): int {
            $poisons = $character->effects->getItems(["type" => SkillSpecial::TYPE_POISON]);
            $poisonValue = 0;
            /** @var CharacterEffect $poison */
            foreach ($poisons as $poison) {
                $poisonValue += $poison->value;
            }
            return $poisonValue;
        });
        $this->registerStatus(static::STATUS_HIDDEN, function (Character $character): bool {
            return $character->effects->hasItems(["type" => SkillSpecial::TYPE_HIDE]);
        });
    }

    protected function setStats(array $stats): void
    {
        $requiredStats = array_merge(["id", "name", "level", "initiativeFormula",], static::BASE_STATS);
        $allStats = array_merge($requiredStats, ["occupation", "race", "specialization", "gender",]);
        $numberStats = static::BASE_STATS;
        $textStats = ["name", "race", "occupation", "specialization", "initiativeFormula",];
        $resolver = new OptionsResolver();
        $resolver->setDefined($allStats);
        $resolver->setAllowedTypes("id", ["integer", "string",]);
        foreach ($numberStats as $stat) {
            $resolver->setAllowedTypes($stat, ["integer", "float"]);
            $resolver->setNormalizer($stat, function (OptionsResolver $resolver, $value): int {
                return (int) $value;
            });
        }
        foreach ($textStats as $stat) {
            $resolver->setNormalizer($stat, function (OptionsResolver $resolver, $value): string {
                return (string) $value;
            });
        }
        $resolver->setRequired($requiredStats);
        $stats = array_filter($stats, function ($key) use ($allStats): bool {
            return in_array($key, $allStats, true);
        }, ARRAY_FILTER_USE_KEY);
        $stats = $resolver->resolve($stats);
        foreach ($stats as $key => $value) {
            $this->$key = $value;
            if (in_array($key, $numberStats, true)) {
                $this->{$key . "Base"} = $value;
            }
        }
        $this->hitpoints = $this->maxHitpoints = $this->maxHitpointsBase = $this->constitution * static::HITPOINTS_PER_CONSTITUTION;

        $this->recalculateSecondaryStats();
        $this->hitBase = $this->hit;
        $this->dodgeBase = $this->dodge;
    }

    protected function getId(): int|string
    {
        return $this->id;
    }

    protected function getName(): string
    {
        return $this->name;
    }

    protected function getGender(): string
    {
        return $this->gender;
    }

    protected function getRace(): string
    {
        return $this->race;
    }

    protected function getOccupation(): string
    {
        return $this->occupation;
    }

    protected function getLevel(): int
    {
        return $this->level;
    }

    protected function getStrength(): int
    {
        return $this->strength;
    }

    protected function getStrengthBase(): int
    {
        return $this->strengthBase;
    }

    protected function getDexterity(): int
    {
        return $this->dexterity;
    }

    protected function getDexterityBase(): int
    {
        return $this->dexterityBase;
    }

    protected function getConstitution(): int
    {
        return $this->constitution;
    }

    protected function getConstitutionBase(): int
    {
        return $this->constitutionBase;
    }

    protected function getCharisma(): int
    {
        return $this->charisma;
    }

    protected function getCharismaBase(): int
    {
        return $this->charismaBase;
    }

    protected function getMaxHitpoints(): int
    {
        return $this->maxHitpoints;
    }

    protected function getMaxHitpointsBase(): int
    {
        return $this->maxHitpointsBase;
    }

    protected function getHitpoints(): int
    {
        return $this->hitpoints;
    }

    protected function getDamage(): int
    {
        return $this->damage;
    }

    protected function getDamageBase(): int
    {
        return $this->damageBase;
    }

    protected function getHit(): int
    {
        return $this->hit;
    }

    protected function getHitBase(): int
    {
        return $this->hitBase;
    }

    protected function getDodge(): int
    {
        return $this->dodge;
    }

    protected function getDodgeBase(): int
    {
        return $this->dodgeBase;
    }

    protected function getInitiative(): int
    {
        return $this->initiative;
    }

    protected function getInitiativeBase(): int
    {
        return $this->initiativeBase;
    }

    protected function getInitiativeFormula(): string
    {
        return $this->initiativeFormula;
    }

    protected function getDefense(): int
    {
        return (int) $this->defense;
    }

    protected function getDefenseBase(): int
    {
        return (int) $this->defenseBase;
    }

    protected function getActivePet(): ?int
    {
        /** @var Pet|null $pet */
        $pet = $this->pets->getItem(["deployed" => true]);
        if ($pet === null) {
            return null;
        }
        return $pet->id;
    }

    protected function isStunned(): bool
    {
        return $this->hasStatus(static::STATUS_STUNNED);
    }

    protected function isPoisoned(): bool
    {
        return $this->hasStatus(static::STATUS_POISONED);
    }

    protected function isHidden(): bool
    {
        return $this->hasStatus(static::STATUS_HIDDEN);
    }

    protected function getSpecialization(): string
    {
        return $this->specialization;
    }

    protected function getIntelligence(): int
    {
        return $this->intelligence;
    }

    protected function getIntelligenceBase(): int
    {
        return $this->intelligenceBase;
    }

    protected function getInitiativeFormulaParser(): IInitiativeFormulaParser
    {
        return $this->initiativeFormulaParser;
    }

    protected function setInitiativeFormulaParser(IInitiativeFormulaParser $initiativeFormulaParser): void
    {
        $oldParser = $this->initiativeFormulaParser;
        $this->initiativeFormulaParser = $initiativeFormulaParser;
        if ($oldParser !== $initiativeFormulaParser) {
            $this->recalculateStats();
        }
    }

    protected function getPositionRow(): int
    {
        return $this->positionRow;
    }

    protected function setPositionRow(int $positionRow): void
    {
        $this->positionRow = Numbers::range($positionRow, 1, PHP_INT_MAX);
    }

    protected function getPositionColumn(): int
    {
        return $this->positionColumn;
    }

    protected function setPositionColumn(int $positionColumn): void
    {
        $this->positionColumn = Numbers::range($positionColumn, 1, PHP_INT_MAX);
    }

    /**
     * Register a new possible character status
     *
     * @param string $name
     * @param callable $callback Used to determine whether the status is active/what value does it have. Is called with Character instance as parameter

     */
    public function registerStatus(string $name, callable $callback): void
    {
        $this->statuses[$name] = $callback;
    }

    public function getStatus(string $name): mixed
    {
        if (!array_key_exists($name, $this->statuses)) {
            return null;
        }
        return (call_user_func($this->statuses[$name], $this));
    }

    public function hasStatus(string $status): bool
    {
        if (!array_key_exists($status, $this->statuses)) {
            return false;
        }
        return (bool) (call_user_func($this->statuses[$status], $this));
    }

    /**
     * @internal
     */
    public function applyEffectProviders(): void
    {
        foreach ($this->effectProviders as $item) {
            $effects = $item->getCombatEffects();
            array_walk($effects, function (CharacterEffect $effect): void {
                $this->effects->removeByFilter(["id" => $effect->id]);
                $this->effects[] = $effect;
            });
        }
    }

    /**
     * @return BaseCharacterSkill[]
     */
    protected function getUsableSkills(): array
    {
        return $this->skills->getItems(["usable" => true]);
    }

    /**
     * Harm the character
     */
    public function harm(int $amount): void
    {
        $this->hitpoints -= Numbers::range($amount, 0, $this->hitpoints);
    }

    /**
     * Heal the character
     */
    public function heal(int $amount): void
    {
        $this->hitpoints += Numbers::range($amount, 0, $this->maxHitpoints - $this->hitpoints);
    }

    /**
     * Determine which (primary) stat should be used to calculate damage
     */
    public function damageStat(): string
    {
        /** @var Weapon|null $item */
        $item = $this->equipment->getItem(["%class%" => Weapon::class, "worn" => true,]);
        if ($item === null) {
            return static::STAT_STRENGTH;
        }
        return $item->damageStat;
    }

    /**
     * Recalculate secondary stats from the the primary ones
     */
    public function recalculateSecondaryStats(): void
    {
        $stats = [
            static::STAT_DAMAGE => $this->damageStat(), static::STAT_HIT => static::STAT_DEXTERITY,
            static::STAT_DODGE => static::STAT_DEXTERITY, static::STAT_MAX_HITPOINTS => static::STAT_CONSTITUTION,
            static::STAT_INITIATIVE => "",
        ];
        foreach ($stats as $secondary => $primary) {
            $gain = $this->$secondary - $this->{$secondary . "Base"};
            if ($secondary === static::STAT_DAMAGE) {
                $base = (int) round($this->$primary / 2);
            } elseif ($secondary === static::STAT_MAX_HITPOINTS) {
                $base = $this->$primary * static::HITPOINTS_PER_CONSTITUTION;
            } elseif ($secondary === static::STAT_INITIATIVE) {
                $base = $this->initiativeFormulaParser->calculateInitiative($this);
            } else {
                $base = $this->$primary * 3;
            }
            $this->{$secondary . "Base"} = $base;
            $this->$secondary = $base + $gain;
        }
    }

    /**
     * Recalculates stats of the character (mostly used during combat)
     */
    public function recalculateStats(): void
    {
        $stats = array_merge(static::BASE_STATS, static::SECONDARY_STATS);
        $debuffs = [];
        foreach ($stats as $stat) {
            $$stat = $this->{$stat . "Base"};
            $debuffs[$stat] = 0;
        }
        $this->effects->removeByFilter(["duration<" => 1]);
        foreach ($this->effects as $effect) {
            $stat = $effect->stat;
            $type = $effect->type;
            $bonus_value = 0;
            if (!in_array($type, SkillSpecial::NO_STAT_TYPES, true)) {
                $bonus_value = ($effect->valueAbsolute) ? $effect->value : $$stat / 100 * $effect->value;
            }
            if ($type === SkillSpecial::TYPE_BUFF) {
                $$stat += $bonus_value;
            } elseif ($type === SkillSpecial::TYPE_DEBUFF) {
                $debuffs[$stat] += $bonus_value;
            }
            unset($stat, $type, $bonus_value);
        }
        foreach ($debuffs as $stat => $value) {
            $value = min($value, 80);
            $bonus_value = $$stat / 100 * $value;
            $$stat -= $bonus_value;
        }
        foreach ($stats as $stat) {
            $this->$stat = (int) round($$stat);
        }
        $this->recalculateSecondaryStats();
    }

    /**
     * Reset character's initiative
     */
    public function resetInitiative(): void
    {
        $this->initiative = $this->initiativeBase = 0;
    }

    public function canAct(): bool
    {
        return !$this->hasStatus(static::STATUS_STUNNED) && $this->hitpoints > 0;
    }

    public function canDefend(): bool
    {
        return !$this->hasStatus(static::STATUS_STUNNED);
    }
}


1		<?php
2		declare(strict_types=1);
3
4		namespace HeroesofAbenez\Combat;
5
6		use Nexendrie\Utils\Numbers;
7		use Symfony\Component\OptionsResolver\OptionsResolver;
8
9		/**
10		* Structure for single character
11		*
12		* @author Jakub Konečný
13		* @property-read int\|string $id
14		* @property-read string $name
15		* @property-read string $gender
16		* @property-read string $race
17		* @property-read string $occupation
18		* @property-read string $specialization
19		* @property-read int $level
20		* @property-read int $strength
21		* @property-read int $strengthBase
22		* @property-read int $dexterity
23		* @property-read int $dexterityBase
24		* @property-read int $constitution
25		* @property-read int $constitutionBase
26		* @property-read int $intelligence
27		* @property-read int $intelligenceBase
28		* @property-read int $charisma
29		* @property-read int $charismaBase
30		* @property-read int $maxHitpoints
31		* @property-read int $maxHitpointsBase
32		* @property-read int $hitpoints
33		* @property-read int $damage
34		* @property-read int $damageBase
35		* @property-read int $hit
36		* @property-read int $hitBase
37		* @property-read int $dodge
38		* @property-read int $dodgeBase
39		* @property-read int $initiative
40		* @property-read int $initiativeBase
41		* @property-read string $initiativeFormula
42		* @property-read int $defense
43		* @property-read int $defenseBase
44		* @property-read int\|null $activePet
45		* @property-read bool $stunned
46		* @property-read bool $poisoned
47		* @property-read bool $hidden
48		* @property-read BaseCharacterSkill[] $usableSkills
49		* @property IInitiativeFormulaParser $initiativeFormulaParser
50		* @property int $positionRow
51		* @property int $positionColumn
52		*/
53	1	class Character
54		{
55		use \Nette\SmartObject;
56
57		public const HITPOINTS_PER_CONSTITUTION = 5;
58		public const STAT_STRENGTH = "strength";
59		public const STAT_DEXTERITY = "dexterity";
60		public const STAT_CONSTITUTION = "constitution";
61		public const STAT_INTELLIGENCE = "intelligence";
62		public const STAT_CHARISMA = "charisma";
63		public const STAT_MAX_HITPOINTS = "maxHitpoints";
64		public const STAT_DAMAGE = "damage";
65		public const STAT_DEFENSE = "defense";
66		public const STAT_HIT = "hit";
67		public const STAT_DODGE = "dodge";
68		public const STAT_INITIATIVE = "initiative";
69		public const BASE_STATS = [
70		self::STAT_STRENGTH,
71		self::STAT_DEXTERITY,
72		self::STAT_CONSTITUTION,
73		self::STAT_INTELLIGENCE,
74		self::STAT_CHARISMA,
75		];
76		public const SECONDARY_STATS = [
77		self::STAT_MAX_HITPOINTS,
78		self::STAT_DAMAGE,
79		self::STAT_DEFENSE,
80		self::STAT_HIT,
81		self::STAT_DODGE,
82		self::STAT_INITIATIVE,
83		];
84		public const STATUS_STUNNED = "stunned";
85		public const STATUS_POISONED = "poisoned";
86		public const STATUS_HIDDEN = "hidden";
87
88		protected int\|string $id;
89		protected string $name;
90		protected string $gender = "male";
91		protected string $race;
92		protected string $occupation;
93		protected string $specialization;
94		protected int $level;
95		protected int $strength;
96		protected int $strengthBase;
97		protected int $dexterity;
98		protected int $dexterityBase;
99		protected int $constitution;
100		protected int $constitutionBase;
101		protected int $intelligence;
102		protected int $intelligenceBase;
103		protected int $charisma;
104		protected int $charismaBase;
105		protected int $maxHitpoints;
106		protected int $maxHitpointsBase;
107		protected int $hitpoints;
108		protected int $damage = 0;
109		protected int $damageBase = 0;
110		protected int $hit = 0;
111		protected int $hitBase = 0;
112		protected int $dodge = 0;
113		protected int $dodgeBase = 0;
114		protected int $initiative = 0;
115		protected int $initiativeBase = 0;
116		protected string $initiativeFormula;
117		protected IInitiativeFormulaParser $initiativeFormulaParser;
118		protected float $defense = 0;
119		protected float $defenseBase = 0;
120		/** @var Equipment[]\|EquipmentCollection Character's equipment */
121		public EquipmentCollection $equipment;
122		/** @var Pet[]\|PetsCollection Character's pets */
123		public PetsCollection $pets;
124		/** @var BaseCharacterSkill[]\|CharacterSkillsCollection Character's skills */
125		public CharacterSkillsCollection $skills;
126		protected ?int $activePet = null;
127		/** @var CharacterEffect[]\|CharacterEffectsCollection Active effects */
128		public CharacterEffectsCollection $effects;
129		/** @var ICharacterEffectsProvider[]\|CharacterEffectsProvidersCollection */
130		public CharacterEffectsProvidersCollection $effectProviders;
131		protected int $positionRow = 0;
132		protected int $positionColumn = 0;
133		/** @var callable[] */
134		protected array $statuses = [];
135
136		/**
137		*
138		* @param array $stats Stats of the character
139		* @param Equipment[] $equipment Equipment of the character
140		* @param Pet[] $pets Pets owned by the character
141		* @param BaseCharacterSkill[] $skills Skills acquired by the character
142		*/
143		public function __construct(
144		array $stats,
145		array $equipment = [],
146		array $pets = [],
147		array $skills = [],
148		IInitiativeFormulaParser $initiativeFormulaParser = new InitiativeFormulaParser()
149		) {
150	1	$this->initiativeFormulaParser = $initiativeFormulaParser;
151	1	$this->equipment = EquipmentCollection::fromArray($equipment);
152	1	$this->pets = PetsCollection::fromArray($pets);
153	1	$this->effectProviders = CharacterEffectsProvidersCollection::fromArray(array_merge($equipment, $pets));
154	1	$this->skills = CharacterSkillsCollection::fromArray($skills);
155	1	$this->equipment->lock();
156	1	$this->pets->lock();
157	1	$this->skills->lock();
158	1	$this->setStats($stats);
159	1	$this->effects = new CharacterEffectsCollection($this);
160	1	$this->registerDefaultStatuses();
161	1	}
162
163		protected function registerDefaultStatuses(): void
164		{
165	1	$this->registerStatus(static::STATUS_STUNNED, function (Character $character): bool {
166	1	return $character->effects->hasItems(["type" => SkillSpecial::TYPE_STUN]);
167	1	});
168	1	$this->registerStatus(static::STATUS_POISONED, function (Character $character): int {
169	1	$poisons = $character->effects->getItems(["type" => SkillSpecial::TYPE_POISON]);
170	1	$poisonValue = 0;
171		/** @var CharacterEffect $poison */
172	1	foreach ($poisons as $poison) {
173	1	$poisonValue += $poison->value;
174		}
175	1	return $poisonValue;
176	1	});
177	1	$this->registerStatus(static::STATUS_HIDDEN, function (Character $character): bool {
178	1	return $character->effects->hasItems(["type" => SkillSpecial::TYPE_HIDE]);
179	1	});
180	1	}
181
182		protected function setStats(array $stats): void
183		{
184	1	$requiredStats = array_merge(["id", "name", "level", "initiativeFormula",], static::BASE_STATS);
185	1	$allStats = array_merge($requiredStats, ["occupation", "race", "specialization", "gender",]);
186	1	$numberStats = static::BASE_STATS;
187	1	$textStats = ["name", "race", "occupation", "specialization", "initiativeFormula",];
188	1	$resolver = new OptionsResolver();
189	1	$resolver->setDefined($allStats);
190	1	$resolver->setAllowedTypes("id", ["integer", "string",]);
191	1	foreach ($numberStats as $stat) {
192	1	$resolver->setAllowedTypes($stat, ["integer", "float"]);
193	1	$resolver->setNormalizer($stat, function (OptionsResolver $resolver, $value): int {
194	1	return (int) $value;
195	1	});
196		}
197	1	foreach ($textStats as $stat) {
198	1	$resolver->setNormalizer($stat, function (OptionsResolver $resolver, $value): string {
199	1	return (string) $value;
200	1	});
201		}
202	1	$resolver->setRequired($requiredStats);
203	1	$stats = array_filter($stats, function ($key) use ($allStats): bool {
204	1	return in_array($key, $allStats, true);
205	1	}, ARRAY_FILTER_USE_KEY);
206	1	$stats = $resolver->resolve($stats);
207	1	foreach ($stats as $key => $value) {
208	1	$this->$key = $value;
209	1	if (in_array($key, $numberStats, true)) {
210	1	$this->{$key . "Base"} = $value;
211		}
212		}
213	1	$this->hitpoints = $this->maxHitpoints = $this->maxHitpointsBase = $this->constitution * static::HITPOINTS_PER_CONSTITUTION;
		0 ignored issues – show introduced 2025-08-30 12:01 UTC by Report Bug Copy Issue Report Line exceeds 120 characters; contains 132 characters Loading history...
214	1	$this->recalculateSecondaryStats();
215	1	$this->hitBase = $this->hit;
216	1	$this->dodgeBase = $this->dodge;
217	1	}
218
219		protected function getId(): int\|string
220		{
221	1	return $this->id;
222		}
223
224		protected function getName(): string
225		{
226	1	return $this->name;
227		}
228
229		protected function getGender(): string
230		{
231		return $this->gender;
232		}
233
234		protected function getRace(): string
235		{
236		return $this->race;
237		}
238
239		protected function getOccupation(): string
240		{
241		return $this->occupation;
242		}
243
244		protected function getLevel(): int
245		{
246	1	return $this->level;
247		}
248
249		protected function getStrength(): int
250		{
251	1	return $this->strength;
252		}
253
254		protected function getStrengthBase(): int
255		{
256		return $this->strengthBase;
257		}
258
259		protected function getDexterity(): int
260		{
261	1	return $this->dexterity;
262		}
263
264		protected function getDexterityBase(): int
265		{
266		return $this->dexterityBase;
267		}
268
269		protected function getConstitution(): int
270		{
271	1	return $this->constitution;
272		}
273
274		protected function getConstitutionBase(): int
275		{
276		return $this->constitutionBase;
277		}
278
279		protected function getCharisma(): int
280		{
281	1	return $this->charisma;
282		}
283
284		protected function getCharismaBase(): int
285		{
286		return $this->charismaBase;
287		}
288
289		protected function getMaxHitpoints(): int
290		{
291	1	return $this->maxHitpoints;
292		}
293
294		protected function getMaxHitpointsBase(): int
295		{
296	1	return $this->maxHitpointsBase;
297		}
298
299		protected function getHitpoints(): int
300		{
301	1	return $this->hitpoints;
302		}
303
304		protected function getDamage(): int
305		{
306	1	return $this->damage;
307		}
308
309		protected function getDamageBase(): int
310		{
311		return $this->damageBase;
312		}
313
314		protected function getHit(): int
315		{
316	1	return $this->hit;
317		}
318
319		protected function getHitBase(): int
320		{
321		return $this->hitBase;
322		}
323
324		protected function getDodge(): int
325		{
326	1	return $this->dodge;
327		}
328
329		protected function getDodgeBase(): int
330		{
331		return $this->dodgeBase;
332		}
333
334		protected function getInitiative(): int
335		{
336	1	return $this->initiative;
337		}
338
339		protected function getInitiativeBase(): int
340		{
341	1	return $this->initiativeBase;
342		}
343
344		protected function getInitiativeFormula(): string
345		{
346	1	return $this->initiativeFormula;
347		}
348
349		protected function getDefense(): int
350		{
351	1	return (int) $this->defense;
352		}
353
354		protected function getDefenseBase(): int
355		{
356		return (int) $this->defenseBase;
357		}
358
359		protected function getActivePet(): ?int
360		{
361		/** @var Pet\|null $pet */
362	1	$pet = $this->pets->getItem(["deployed" => true]);
363	1	if ($pet === null) {
364	1	return null;
365		}
366	1	return $pet->id;
367		}
368
369		protected function isStunned(): bool
370		{
371		return $this->hasStatus(static::STATUS_STUNNED);
372		}
373
374		protected function isPoisoned(): bool
375		{
376	1	return $this->hasStatus(static::STATUS_POISONED);
377		}
378
379		protected function isHidden(): bool
380		{
381	1	return $this->hasStatus(static::STATUS_HIDDEN);
382		}
383
384		protected function getSpecialization(): string
385		{
386		return $this->specialization;
387		}
388
389		protected function getIntelligence(): int
390		{
391	1	return $this->intelligence;
392		}
393
394		protected function getIntelligenceBase(): int
395		{
396		return $this->intelligenceBase;
397		}
398
399		protected function getInitiativeFormulaParser(): IInitiativeFormulaParser
400		{
401	1	return $this->initiativeFormulaParser;
402		}
403
404		protected function setInitiativeFormulaParser(IInitiativeFormulaParser $initiativeFormulaParser): void
405		{
406	1	$oldParser = $this->initiativeFormulaParser;
407	1	$this->initiativeFormulaParser = $initiativeFormulaParser;
408	1	if ($oldParser !== $initiativeFormulaParser) {
409	1	$this->recalculateStats();
410		}
411	1	}
412
413		protected function getPositionRow(): int
414		{
415	1	return $this->positionRow;
416		}
417
418		protected function setPositionRow(int $positionRow): void
419		{
420	1	$this->positionRow = Numbers::range($positionRow, 1, PHP_INT_MAX);
421	1	}
422
423		protected function getPositionColumn(): int
424		{
425	1	return $this->positionColumn;
426		}
427
428		protected function setPositionColumn(int $positionColumn): void
429		{
430	1	$this->positionColumn = Numbers::range($positionColumn, 1, PHP_INT_MAX);
431	1	}
432
433		/**
434		* Register a new possible character status
435		*
436		* @param string $name
437		* @param callable $callback Used to determine whether the status is active/what value does it have. Is called with Character instance as parameter
		0 ignored issues – show introduced 2025-08-30 12:01 UTC by Report Bug Copy Issue Report Line exceeds 120 characters; contains 151 characters Loading history...
438		*/
439		public function registerStatus(string $name, callable $callback): void
440		{
441	1	$this->statuses[$name] = $callback;
442	1	}
443
444		public function getStatus(string $name): mixed
445		{
446	1	if (!array_key_exists($name, $this->statuses)) {
447	1	return null;
448		}
449	1	return (call_user_func($this->statuses[$name], $this));
450		}
451
452		public function hasStatus(string $status): bool
453		{
454	1	if (!array_key_exists($status, $this->statuses)) {
455	1	return false;
456		}
457	1	return (bool) (call_user_func($this->statuses[$status], $this));
458		}
459
460		/**
461		* @internal
462		*/
463		public function applyEffectProviders(): void
464		{
465	1	foreach ($this->effectProviders as $item) {
466	1	$effects = $item->getCombatEffects();
467	1	array_walk($effects, function (CharacterEffect $effect): void {
468	1	$this->effects->removeByFilter(["id" => $effect->id]);
469	1	$this->effects[] = $effect;
470	1	});
471		}
472	1	}
473
474		/**
475		* @return BaseCharacterSkill[]
476		*/
477		protected function getUsableSkills(): array
478		{
479	1	return $this->skills->getItems(["usable" => true]);
480		}
481
482		/**
483		* Harm the character
484		*/
485		public function harm(int $amount): void
486		{
487	1	$this->hitpoints -= Numbers::range($amount, 0, $this->hitpoints);
488	1	}
489
490		/**
491		* Heal the character
492		*/
493		public function heal(int $amount): void
494		{
495	1	$this->hitpoints += Numbers::range($amount, 0, $this->maxHitpoints - $this->hitpoints);
496	1	}
497
498		/**
499		* Determine which (primary) stat should be used to calculate damage
500		*/
501		public function damageStat(): string
502		{
503		/** @var Weapon\|null $item */
504	1	$item = $this->equipment->getItem(["%class%" => Weapon::class, "worn" => true,]);
505	1	if ($item === null) {
506	1	return static::STAT_STRENGTH;
507		}
508	1	return $item->damageStat;
509		}
510
511		/**
512		* Recalculate secondary stats from the the primary ones
513		*/
514		public function recalculateSecondaryStats(): void
515		{
516	1	$stats = [
517	1	static::STAT_DAMAGE => $this->damageStat(), static::STAT_HIT => static::STAT_DEXTERITY,
518	1	static::STAT_DODGE => static::STAT_DEXTERITY, static::STAT_MAX_HITPOINTS => static::STAT_CONSTITUTION,
519	1	static::STAT_INITIATIVE => "",
520		];
521	1	foreach ($stats as $secondary => $primary) {
522	1	$gain = $this->$secondary - $this->{$secondary . "Base"};
523	1	if ($secondary === static::STAT_DAMAGE) {
524	1	$base = (int) round($this->$primary / 2);
525	1	} elseif ($secondary === static::STAT_MAX_HITPOINTS) {
526	1	$base = $this->$primary * static::HITPOINTS_PER_CONSTITUTION;
527	1	} elseif ($secondary === static::STAT_INITIATIVE) {
528	1	$base = $this->initiativeFormulaParser->calculateInitiative($this);
529		} else {
530	1	$base = $this->$primary * 3;
531		}
532	1	$this->{$secondary . "Base"} = $base;
533	1	$this->$secondary = $base + $gain;
534		}
535	1	}
536
537		/**
538		* Recalculates stats of the character (mostly used during combat)
539		*/
540		public function recalculateStats(): void
541		{
542	1	$stats = array_merge(static::BASE_STATS, static::SECONDARY_STATS);
543	1	$debuffs = [];
544	1	foreach ($stats as $stat) {
545	1	$$stat = $this->{$stat . "Base"};
546	1	$debuffs[$stat] = 0;
547		}
548	1	$this->effects->removeByFilter(["duration<" => 1]);
549	1	foreach ($this->effects as $effect) {
550	1	$stat = $effect->stat;
551	1	$type = $effect->type;
552	1	$bonus_value = 0;
553	1	if (!in_array($type, SkillSpecial::NO_STAT_TYPES, true)) {
554	1	$bonus_value = ($effect->valueAbsolute) ? $effect->value : $$stat / 100 * $effect->value;
555		}
556	1	if ($type === SkillSpecial::TYPE_BUFF) {
557	1	$$stat += $bonus_value;
558	1	} elseif ($type === SkillSpecial::TYPE_DEBUFF) {
559	1	$debuffs[$stat] += $bonus_value;
560		}
561	1	unset($stat, $type, $bonus_value);
562		}
563	1	foreach ($debuffs as $stat => $value) {
564	1	$value = min($value, 80);
565	1	$bonus_value = $$stat / 100 * $value;
566	1	$$stat -= $bonus_value;
567		}
568	1	foreach ($stats as $stat) {
569	1	$this->$stat = (int) round($$stat);
570		}
571	1	$this->recalculateSecondaryStats();
572	1	}
573
574		/**
575		* Reset character's initiative
576		*/
577		public function resetInitiative(): void
578		{
579	1	$this->initiative = $this->initiativeBase = 0;
580	1	}
581
582		public function canAct(): bool
583		{
584	1	return !$this->hasStatus(static::STATUS_STUNNED) && $this->hitpoints > 0;
585		}
586
587		public function canDefend(): bool
588		{
589	1	return !$this->hasStatus(static::STATUS_STUNNED);
590		}
591		}
592

heroesofabenez / combat

Character::getSpecialization() A last analyzed 2025-08-30 12:01 UTC

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like

Character::getSpecialization() A
last analyzed 2025-08-30 12:01 UTC