141 lines
3.8 KiB
Python
141 lines
3.8 KiB
Python
"""
|
||
Character statistics data model.
|
||
|
||
This module defines the Stats dataclass which represents a character's core
|
||
attributes and provides computed properties for derived values like HP and MP.
|
||
"""
|
||
|
||
from dataclasses import dataclass, field, asdict
|
||
from typing import Dict, Any
|
||
|
||
|
||
@dataclass
|
||
class Stats:
|
||
"""
|
||
Character statistics representing core attributes.
|
||
|
||
Attributes:
|
||
strength: Physical power, affects melee damage
|
||
dexterity: Agility and precision, affects initiative and evasion
|
||
constitution: Endurance and health, affects HP and defense
|
||
intelligence: Magical power, affects spell damage and MP
|
||
wisdom: Perception and insight, affects magical resistance
|
||
charisma: Social influence, affects NPC interactions
|
||
|
||
Computed Properties:
|
||
hit_points: Maximum HP = 10 + (constitution × 2)
|
||
mana_points: Maximum MP = 10 + (intelligence × 2)
|
||
defense: Physical defense = constitution // 2
|
||
resistance: Magical resistance = wisdom // 2
|
||
"""
|
||
|
||
strength: int = 10
|
||
dexterity: int = 10
|
||
constitution: int = 10
|
||
intelligence: int = 10
|
||
wisdom: int = 10
|
||
charisma: int = 10
|
||
|
||
@property
|
||
def hit_points(self) -> int:
|
||
"""
|
||
Calculate maximum hit points based on constitution.
|
||
|
||
Formula: 10 + (constitution × 2)
|
||
|
||
Returns:
|
||
Maximum HP value
|
||
"""
|
||
return 10 + (self.constitution * 2)
|
||
|
||
@property
|
||
def mana_points(self) -> int:
|
||
"""
|
||
Calculate maximum mana points based on intelligence.
|
||
|
||
Formula: 10 + (intelligence × 2)
|
||
|
||
Returns:
|
||
Maximum MP value
|
||
"""
|
||
return 10 + (self.intelligence * 2)
|
||
|
||
@property
|
||
def defense(self) -> int:
|
||
"""
|
||
Calculate physical defense from constitution.
|
||
|
||
Formula: constitution // 2
|
||
|
||
Returns:
|
||
Physical defense value (damage reduction)
|
||
"""
|
||
return self.constitution // 2
|
||
|
||
@property
|
||
def resistance(self) -> int:
|
||
"""
|
||
Calculate magical resistance from wisdom.
|
||
|
||
Formula: wisdom // 2
|
||
|
||
Returns:
|
||
Magical resistance value (spell damage reduction)
|
||
"""
|
||
return self.wisdom // 2
|
||
|
||
def to_dict(self) -> Dict[str, Any]:
|
||
"""
|
||
Serialize stats to a dictionary.
|
||
|
||
Returns:
|
||
Dictionary containing all stat values
|
||
"""
|
||
return asdict(self)
|
||
|
||
@classmethod
|
||
def from_dict(cls, data: Dict[str, Any]) -> 'Stats':
|
||
"""
|
||
Deserialize stats from a dictionary.
|
||
|
||
Args:
|
||
data: Dictionary containing stat values
|
||
|
||
Returns:
|
||
Stats instance
|
||
"""
|
||
return cls(
|
||
strength=data.get("strength", 10),
|
||
dexterity=data.get("dexterity", 10),
|
||
constitution=data.get("constitution", 10),
|
||
intelligence=data.get("intelligence", 10),
|
||
wisdom=data.get("wisdom", 10),
|
||
charisma=data.get("charisma", 10),
|
||
)
|
||
|
||
def copy(self) -> 'Stats':
|
||
"""
|
||
Create a deep copy of this Stats instance.
|
||
|
||
Returns:
|
||
New Stats instance with same values
|
||
"""
|
||
return Stats(
|
||
strength=self.strength,
|
||
dexterity=self.dexterity,
|
||
constitution=self.constitution,
|
||
intelligence=self.intelligence,
|
||
wisdom=self.wisdom,
|
||
charisma=self.charisma,
|
||
)
|
||
|
||
def __repr__(self) -> str:
|
||
"""String representation showing all stats and computed properties."""
|
||
return (
|
||
f"Stats(STR={self.strength}, DEX={self.dexterity}, "
|
||
f"CON={self.constitution}, INT={self.intelligence}, "
|
||
f"WIS={self.wisdom}, CHA={self.charisma}, "
|
||
f"HP={self.hit_points}, MP={self.mana_points}, "
|
||
f"DEF={self.defense}, RES={self.resistance})"
|
||
)
|