Exposes functions for working working with the character. More...

#include "../combat/ability_fw.h"
#include "../combat/damage.h"
#include "../common.h"
#include "../item/gear.h"
#include "../item/potion.h"
#include "../memory/memory_management.h"
#include "../stats/stats.h"

Data Structures
struct	character_t

Macros
#define	MAX_ABILITY_LIMIT 20
#define	MAX_GEAR_LIMIT 20
#define	MAX_POTION_LIMIT 20

Typedefs
typedef struct character_t	character_t

Enumerations
enum	character_type_t { PLAYER , MONSTER , BOSS }

Functions
character_t *	init_character (memory_pool_t memory_pool, character_type_t type, const char name)
	Initializes a new character.
void	free_character (memory_pool_t memory_pool, character_t character)
	Frees the memory allocated for a character.
void	set_character_stats (character_t *character, int strength, int intelligence, int dexterity, int constitution)
	Sets the stats for a character.
void	set_stats (stats_t *stats, int strength, int intelligence, int dexterity, int constitution)
	Sets the stats for a character.
void	update_character_resources (resources_t current_resources, resources_t max_resources, stats_t *base_stats)
	Updates the character's resources based on their stats.
void	set_character_dmg_modifier (character_t *character, damage_type_t type, int value)
	Sets the damage modifier for a character.
void	add_ability (character_t character, ability_t ability)
	Adds an ability to a character.
void	remove_ability (character_t character, const ability_t ability)
	Removes an ability from a character.
void	add_potion (character_t character, potion_t potion)
	Adds a potion to a character's inventory.
void	remove_potion (character_t character, potion_t potion)
	Removes a potion from a character's inventory.
void	add_gear (character_t character, gear_t gear)
	Adds gear to a character's inventory.
void	remove_gear (character_t character, gear_t gear)
	Removes a gear item from a character's inventory.
void	remove_equipped_gear (character_t *character, gear_slot_t slot)
	Removes the gear equipped in a specific slot of a character.
bool	add_equipped_gear (character_t character, gear_t gear)
	Adds an equipped gear in a specific slot of a character without updating stats and abilities.
void	equip_gear (character_t character, gear_t gear)
	Equips a gear item to a character.
void	unequip_gear (character_t *character, gear_slot_t slot)
	Unequips a gear item from a character and adds it to the character's inventory.
void	reset_current_stats (character_t *character)
	Resets the current stats of a character to their base values.
void	set_level (character_t *character, int level)
	Sets the level for a character.
void	set_xp_reward (character_t *character, int xp_reward)
	Sets the XP reward for a character.
void	set_initial_xp (character_t *character, int xp)
	sets initial xp for a character
void	set_skill_points (character_t *character, int skill_points)
	Sets the skill points for a character.
void	reset_player_stats (character_t *player)
	Resets the player stats to their base values.

Detailed Description

Exposes functions for working working with the character.

Definition in file character.h.

Macro Definition Documentation

◆ MAX_ABILITY_LIMIT

#define MAX_ABILITY_LIMIT 20

Definition at line 16 of file character.h.

◆ MAX_GEAR_LIMIT

#define MAX_GEAR_LIMIT 20

Definition at line 17 of file character.h.

◆ MAX_POTION_LIMIT

#define MAX_POTION_LIMIT 20

Definition at line 18 of file character.h.

Enumeration Type Documentation

◆ character_type_t

enum character_type_t

Definition at line 20 of file character.h.

             {
    PLAYER,
    MONSTER,
    BOSS
} character_type_t;

Function Documentation

◆ add_ability()

void add_ability	(	character_t *	character,
		ability_t *	ability )

Adds an ability to a character.

Parameters

character	Pointer to the character
ability	Pointer to the ability to add

Definition at line 127 of file character.c.

                                                             {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In add_ability character is NULL");
    NULL_PTR_HANDLER_RETURN(ability, , "Character", "In add_ability ability is NULL");
 
    if (character->ability_count < MAX_ABILITY_LIMIT) {
        character->abilities[character->ability_count] = ability;
        character->ability_count++;
    } else {
        log_msg(WARNING, "Character", "%s cannot learn more abilities!", character->name);
    }
}

◆ add_equipped_gear()

bool add_equipped_gear	(	character_t *	character,
		gear_t *	gear )

Adds an equipped gear in a specific slot of a character without updating stats and abilities.

Parameters

character	Pointer to the character.
gear	Pointer to the equipped gear to add.

Returns: True if the gear was successfully added, false otherwise.

Definition at line 216 of file character.c.

                                                             {
    NULL_PTR_HANDLER_RETURN(character, false, "Character", "In add_equipped_gear character is NULL");
    NULL_PTR_HANDLER_RETURN(gear, false, "Character", "In add_equipped_gear gear is NULL");
 
    if (gear->slot < MAX_SLOT) {
        if (character->equipment[gear->slot] != NULL) {
            log_msg(WARNING, "Character", "Slot %d is already occupied!", gear->slot);
            return false;
        }
 
        character->equipment[gear->slot] = gear;
        if (character->abilities[0] == character->base_attack) {
            remove_ability(character, character->abilities[0]);
        }
 
        for (int i = 0; i < gear->num_abilities; ++i) {
            add_ability(character, gear->abilities[i]);
        }
 
        return true;
    }
 
    log_msg(WARNING, "Character", "Invalid slot for gear %s!", gear->local_key);
    return false;
}

◆ add_gear()

void add_gear	(	character_t *	character,
		gear_t *	gear )

Adds gear to a character's inventory.

Parameters

character	Pointer to the character
gear	Pointer to the gear to add

Definition at line 156 of file character.c.

                                                    {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In add_gear character is NULL");
    NULL_PTR_HANDLER_RETURN(gear, , "Character", "In add_gear gear is NULL");
 
    if (character->gear_count < MAX_GEAR_LIMIT) {
        character->gear_inventory[character->gear_count] = gear;
        character->gear_count++;
 
    } else {
        log_msg(WARNING, "Character", "%s cannot carry more gear!", character->name);
    }
}

◆ add_potion()

void add_potion	(	character_t *	character,
		potion_t *	potion )

Adds a potion to a character's inventory.

Parameters

character	Pointer to the character
potion	Pointer to the potion to add

Definition at line 242 of file character.c.

                                                          {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In add_potion character is NULL");
    NULL_PTR_HANDLER_RETURN(potion, , "Character", "In add_potion potion is NULL");
 
    if (character->potion_count < MAX_POTION_LIMIT) {
        character->potion_inventory[character->potion_count] = potion;
        character->potion_count++;
    } else {
        log_msg(WARNING, "Character", "%s cannot carry more potions!", character->name);
    }
}

◆ equip_gear()

void equip_gear	(	character_t *	character,
		gear_t *	gear )

Equips a gear item to a character.

Parameters

character	Pointer to the character
gear	Pointer to the gear item to equip

Definition at line 272 of file character.c.

                                                      {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In equip_gear character is NULL");
    NULL_PTR_HANDLER_RETURN(gear, , "Character", "In equip_gear gear is NULL");
 
    if (add_equipped_gear(character, gear)) {
        remove_gear(character, gear);
 
        character->base_stats.strength += gear->stats.strength;
        character->base_stats.intelligence += gear->stats.intelligence;
        character->base_stats.dexterity += gear->stats.dexterity;
        character->base_stats.constitution += gear->stats.constitution;
        character->defenses.armor += gear->defenses.armor;
        character->defenses.magic_resist += gear->defenses.magic_resist;
        update_character_resources(&character->current_resources, &character->max_resources, &character->base_stats);
 
    } else {
        log_msg(WARNING, "Character", "Invalid slot for gear %s!", gear->local_key);
    }
}

◆ free_character()

void free_character	(	memory_pool_t *	memory_pool,
		character_t *	character )

Frees the memory allocated for a character.

Parameters

memory_pool	Pointer to the memory pool used for allocation
character	Pointer to the character to be freed

Definition at line 60 of file character.c.

                                                                        {
    NULL_PTR_HANDLER_RETURN(memory_pool, , "Character", "In free_character memory pool is NULL");
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In free_character character is NULL");
    memory_pool_free(memory_pool, character);
}

◆ init_character()

character_t * init_character	(	memory_pool_t *	memory_pool,
		character_type_t	type,
		const char *	name )

Initializes a new character.

Parameters

memory_pool	Pointer to the memory pool for dynamic allocation
type	The type of the character (e.g., player, enemy)
name	The name of the character

Returns: Pointer to the initialized character, or NULL on failure

Definition at line 13 of file character.c.

                                                                                                       {
    NULL_PTR_HANDLER_RETURN(memory_pool, NULL, "Character", "In init_character memory pool is NULL");
    NULL_PTR_HANDLER_RETURN(name, NULL, "Character", "In init_character name is NULL");
 
    character_t* character = memory_pool_alloc(memory_pool, sizeof(character_t));
    NULL_PTR_HANDLER_RETURN(character, NULL, "Character", "Failed to allocate memory for character: %s", name);
 
    character->type = type;
    snprintf(character->name, sizeof(character->name), "%s", name);
    character->base_stats = (stats_t) {0};
    character->current_stats = (stats_t) {0};
    character->max_resources = (resources_t) {0};
    character->current_resources = (resources_t) {0};
 
    for (int i = 0; i < DAMAGE_TYPE_COUNT; i++) {
        character->resistance[i].type = i;
        character->resistance[i].value = 0;
    }
 
    character->defenses = (defenses_t) {0};
 
    for (int i = 0; i < MAX_ABILITY_LIMIT; i++) {
        character->abilities[i] = NULL;
    }
    character->base_attack = NULL;
    character->ability_count = 0;
 
    for (int i = 0; i < MAX_POTION_LIMIT; i++) {
        character->potion_inventory[i] = NULL;
    }
    character->potion_count = 0;
 
    for (int i = 0; i < MAX_GEAR_LIMIT; i++) {
        character->gear_inventory[i] = NULL;
    }
    character->gear_count = 0;
 
    for (int i = 0; i < MAX_SLOT; i++) {
        character->equipment[i] = NULL;
    }
    character->level = 0;
    character->xp = 0;
    character->xp_reward = 0;
    character->skill_points = 0;
    return character;
}

◆ remove_ability()

void remove_ability	(	character_t *	character,
		const ability_t *	ability )

Removes an ability from a character.

Parameters

character	Pointer to the character
ability	Pointer to the ability to remove

Definition at line 139 of file character.c.

                                                                      {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In remove_ability character is NULL");
    NULL_PTR_HANDLER_RETURN(ability, , "Character", "In remove_ability ability is NULL");
 
    for (int i = 0; i < character->ability_count; i++) {
        if (character->abilities[i] == ability) {
            for (int j = i; j < character->ability_count - 1; j++) {
                character->abilities[j] = character->abilities[j + 1];
            }
            character->abilities[character->ability_count - 1] = NULL;
            character->ability_count--;
 
            break;
        }
    }
}

◆ remove_equipped_gear()

void remove_equipped_gear	(	character_t *	character,
		gear_slot_t	slot )

Removes the gear equipped in a specific slot of a character.

Parameters

character	Pointer to the character whose gear is to be removed.
slot	The slot from which the gear should be removed.

Definition at line 187 of file character.c.

                                                                    {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In remove_equipped_gear character is NULL");
    CHECK_ARG_RETURN(slot < 0 && slot >= MAX_SLOT, , "Character", "In remove_equipped_gear slot is invalid: %d", slot);
 
    if (character->equipment[slot] != NULL) {
        gear_t* gear = character->equipment[slot];
 
        character->base_stats.strength -= gear->stats.strength;
        character->base_stats.intelligence -= gear->stats.intelligence;
        character->base_stats.dexterity -= gear->stats.dexterity;
        character->base_stats.constitution -= gear->stats.constitution;
        character->defenses.armor -= gear->defenses.armor;
        character->defenses.magic_resist -= gear->defenses.magic_resist;
        update_character_resources(&character->current_resources, &character->max_resources, &character->base_stats);
 
        for (int i = 0; i < gear->num_abilities; ++i) {
            remove_ability(character, gear->abilities[i]);
        }
 
        if (character->ability_count == 0) {
            add_ability(character, character->base_attack);
        }
 
        character->equipment[slot] = NULL;
    } else {
        log_msg(WARNING, "Character", "No gear equipped in slot %d!", slot);
    }
}

◆ remove_gear()

void remove_gear	(	character_t *	character,
		gear_t *	gear )

Removes a gear item from a character's inventory.

Parameters

character	Pointer to the character
gear	Pointer to the gear item to remove

Definition at line 169 of file character.c.

                                                       {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In remove_gear character is NULL");
    NULL_PTR_HANDLER_RETURN(gear, , "Character", "In remove_gear gear is NULL");
 
    for (int i = 0; i < character->gear_count; i++) {
        if (character->gear_inventory[i] == gear) {
            for (int j = i; j < character->gear_count - 1; j++) {
                character->gear_inventory[j] = character->gear_inventory[j + 1];
            }
            character->gear_inventory[character->gear_count - 1] = NULL;
            character->gear_count--;
 
            return;
        }
    }
    log_msg(WARNING, "Character", "Gear %s not found in inventory!", gear->local_key);
}

◆ remove_potion()

void remove_potion	(	character_t *	character,
		potion_t *	potion )

Removes a potion from a character's inventory.

Parameters

character	Pointer to the character
potion	Pointer to the potion to remove

Definition at line 254 of file character.c.

                                                             {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In remove_potion character is NULL");
    NULL_PTR_HANDLER_RETURN(potion, , "Character", "In remove_potion potion is NULL");
 
    for (int i = 0; i < character->potion_count; i++) {
        if (character->potion_inventory[i] == potion) {
            for (int j = i; j < character->potion_count - 1; j++) {
                character->potion_inventory[j] = character->potion_inventory[j + 1];
            }
            character->potion_inventory[character->potion_count - 1] = NULL;
            character->potion_count--;
            return;
        }
    }
    log_msg(WARNING, "Character", "Potion %s not found in inventory!", potion->name);
}

◆ reset_current_stats()

void reset_current_stats ( character_t * character )

Resets the current stats of a character to their base values.

Parameters

character Pointer to the character

Definition at line 56 of file damage.c.

                                                 {
    character->current_stats = character->base_stats;
}

◆ reset_player_stats()

void reset_player_stats ( character_t * player )

Resets the player stats to their base values.

Parameters

player Pointer to the player character

Definition at line 320 of file character.c.

                                             {
    if (player == NULL) return;
 
    // reset current stats to their starting values
    player->current_resources.health = player->max_resources.health;
    player->current_resources.mana = player->max_resources.mana;
    player->current_resources.stamina = player->max_resources.stamina;
}

◆ set_character_dmg_modifier()

void set_character_dmg_modifier	(	character_t *	character,
		damage_type_t	type,
		int	value )

Sets the damage modifier for a character.

Parameters

character	Pointer to the character to set the damage modifier for
type	The type of damage to modify
value	The value of the damage modifier

Definition at line 115 of file character.c.

                                                                                       {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In set_character_dmg_modifier character is NULL");
 
    for (int i = 0; i < DAMAGE_TYPE_COUNT; i++) {
        if (character->resistance[i].type == type) {
            character->resistance[i].value = value;
            return;
        }
    }
    log_msg(WARNING, "Character", "Unknown damage type: %d", type);
}

◆ set_character_stats()

void set_character_stats	(	character_t *	character,
		int	strength,
		int	intelligence,
		int	dexterity,
		int	constitution )

Sets the stats for a character.

Parameters

c	Pointer to the character to set stats for
strength	Strength value
intelligence	Intelligence value
dexterity	Dexterity value
constitution	Constitution value

Definition at line 66 of file character.c.

                                                                                                                  {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In set_character_stats character is NULL");
 
    set_stats(&character->base_stats, strength, intelligence, dexterity, constitution);
    character->current_stats = character->base_stats;
    update_character_resources(&character->current_resources, &character->max_resources, &character->base_stats);
    character->current_resources = character->max_resources;
    character->defenses.armor = 0;
    character->defenses.magic_resist = 0;
}

◆ set_initial_xp()

void set_initial_xp	(	character_t *	character,
		int	xp )

sets initial xp for a character

Parameters

character	Pointer to the character
xp	The initial xp value

Definition at line 300 of file character.c.

                                                    {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In set_initial_xp character is NULL");
    character->xp = xp;
}

◆ set_level()

void set_level	(	character_t *	character,
		int	level )

Sets the level for a character.

Parameters

character	Pointer to the character
level	The level value

Definition at line 305 of file character.c.

                                                  {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In set_level character is NULL");
    character->level = level;
}

◆ set_skill_points()

void set_skill_points	(	character_t *	character,
		int	skill_points )

Sets the skill points for a character.

Parameters

character	Pointer to the character
skill_points	How many skill points the character has

Definition at line 315 of file character.c.

                                                                {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In set_skill_points character is NULL");
    character->skill_points = skill_points;
}

◆ set_stats()

void set_stats	(	stats_t *	stats,
		int	strength,
		int	intelligence,
		int	dexterity,
		int	constitution )

Sets the stats for a character.

Parameters

stats	Pointer to the stats structure to set
strength	Strength value
intelligence	Intelligence value
dexterity	Dexterity value
constitution	Constitution value

Definition at line 77 of file character.c.

                                                                                                {
    NULL_PTR_HANDLER_RETURN(stats, , "Character", "In set_stats stats is NULL");
 
    stats->strength = strength;
    stats->intelligence = intelligence;
    stats->dexterity = dexterity;
    stats->constitution = constitution;
}

◆ set_xp_reward()

void set_xp_reward	(	character_t *	character,
		int	xp_reward )

Sets the XP reward for a character.

Parameters

character	Pointer to the character
xp_reward	The XP reward value

Definition at line 310 of file character.c.

                                                          {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In set_xp_reward character is NULL");
    character->xp_reward = xp_reward;
}

◆ unequip_gear()

void unequip_gear	(	character_t *	character,
		gear_slot_t	slot )

Unequips a gear item from a character and adds it to the character's inventory.

Parameters

character	Pointer to the character
slot	The slot to unequip from

Definition at line 292 of file character.c.

                                                                  {
    NULL_PTR_HANDLER_RETURN(character, , "Character", "In unequip_gear character is NULL");
    CHECK_ARG_RETURN(slot < 0 && slot >= MAX_SLOT, , "Character", "In unequip_gear slot is invalid: %d", slot);
 
    add_gear(character, character->equipment[slot]);
    remove_equipped_gear(character, slot);
}

◆ update_character_resources()

void update_character_resources	(	resources_t *	current_resources,
		resources_t *	max_resources,
		stats_t *	base_stats )

Updates the character's resources based on their stats.

Parameters

current_resources	Pointer to the current resources structure to update
max_resources	Pointer to the max resources structure to update
base_stats	Pointer to the base stats structure

Definition at line 86 of file character.c.

                                                                                                                 {
    NULL_PTR_HANDLER_RETURN(current_resources, , "Character", "In update_character_resources current_resources is NULL");
    NULL_PTR_HANDLER_RETURN(max_resources, , "Character", "In update_character_resources max_resources is NULL");
    NULL_PTR_HANDLER_RETURN(base_stats, , "Character", "In update_character_resources base_stats is NULL");
 
    int new_max_health = 5 * base_stats->constitution;
    int new_max_mana = 1 * base_stats->intelligence;
    int new_max_stamina = 2 * base_stats->strength;
 
    if (max_resources->health > 0 && current_resources->health > 0) {
        current_resources->health = (int) ((double) current_resources->health / max_resources->health * new_max_health + 0.5);
    }
    if (max_resources->mana > 0 && current_resources->mana > 0) {
        current_resources->mana = (int) ((double) current_resources->mana / max_resources->mana * new_max_mana + 0.5);
    }
    if (max_resources->stamina > 0 && current_resources->stamina > 0) {
        current_resources->stamina = (int) ((double) current_resources->stamina / max_resources->stamina * new_max_stamina + 0.5);
    }
 
    // Limit current values to new max values
    current_resources->health = current_resources->health > new_max_health ? new_max_health : current_resources->health;
    current_resources->mana = current_resources->mana > new_max_mana ? new_max_mana : current_resources->mana;
    current_resources->stamina = current_resources->stamina > new_max_stamina ? new_max_stamina : current_resources->stamina;
 
    max_resources->health = new_max_health;
    max_resources->mana = new_max_mana;
    max_resources->stamina = new_max_stamina;
}

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ MAX_ABILITY_LIMIT

◆ MAX_GEAR_LIMIT

◆ MAX_POTION_LIMIT

Enumeration Type Documentation

◆ character_type_t

Function Documentation

◆ add_ability()

◆ add_equipped_gear()

◆ add_gear()

◆ add_potion()

◆ equip_gear()

◆ free_character()

◆ init_character()

◆ remove_ability()

◆ remove_equipped_gear()

◆ remove_gear()

◆ remove_potion()

◆ reset_current_stats()

◆ reset_player_stats()

◆ set_character_dmg_modifier()

◆ set_character_stats()

◆ set_initial_xp()

◆ set_level()

◆ set_skill_points()

◆ set_stats()

◆ set_xp_reward()

◆ unequip_gear()

◆ update_character_resources()