sv_dynamic_handicap.qc File Reference

Source file that contains implementation of the Dynamic handicap mutator. More...

#include "sv_dynamic_handicap.qh"

Include dependency graph for sv_dynamic_handicap.qc:

Go to the source code of this file.

Functions
float	DynamicHandicap_ClampHandicap (float handicap)
	Clamps the value of the handicap. More...
void	DynamicHandicap_UpdateHandicap ()
	Updates the handicap of all players. More...
	MUTATOR_HOOKFUNCTION (dynamic_handicap, BuildMutatorsString)
	MUTATOR_HOOKFUNCTION (dynamic_handicap, BuildMutatorsPrettyString)
	MUTATOR_HOOKFUNCTION (dynamic_handicap, ClientDisconnect)
	MUTATOR_HOOKFUNCTION (dynamic_handicap, PutClientInServer)
	MUTATOR_HOOKFUNCTION (dynamic_handicap, MakePlayerObserver)
	MUTATOR_HOOKFUNCTION (dynamic_handicap, AddedPlayerScore)
	REGISTER_MUTATOR (dynamic_handicap, autocvar_g_dynamic_handicap)

Variables
int	autocvar_g_dynamic_handicap
	Whether to enable dynamic handicap. More...
float	autocvar_g_dynamic_handicap_exponent
	The exponent used to calculate handicap. More...
float	autocvar_g_dynamic_handicap_max
	The maximum value of the handicap. More...
float	autocvar_g_dynamic_handicap_min
	The minimum value of the handicap. More...
float	autocvar_g_dynamic_handicap_scale
	The scale of the handicap. More...

Detailed Description

Source file that contains implementation of the Dynamic handicap mutator.

Author

Lyberta

Copyright

GNU GPLv2 or any later version.

Definition in file sv_dynamic_handicap.qc.

Function Documentation

DynamicHandicap_ClampHandicap()

float DynamicHandicap_ClampHandicap

(

float

handicap

)

Clamps the value of the handicap.

Parameters

[in]

handicap

Value to clamp.

Returns

Clamped value.

Definition at line 65 of file sv_dynamic_handicap.qc.

References autocvar_g_dynamic_handicap, autocvar_g_dynamic_handicap_max, autocvar_g_dynamic_handicap_min, and REGISTER_MUTATOR().

Referenced by DynamicHandicap_UpdateHandicap().

{
    if ((autocvar_g_dynamic_handicap_min >= 0) && (handicap <
        autocvar_g_dynamic_handicap_min))
    {
        handicap = autocvar_g_dynamic_handicap_min;
    }
    if ((autocvar_g_dynamic_handicap_max > 0) && (handicap >
        autocvar_g_dynamic_handicap_max))
    {
        handicap = autocvar_g_dynamic_handicap_max;
    }
    return handicap;
}

Here is the call graph for this function:

Here is the caller graph for this function:

DynamicHandicap_UpdateHandicap()

void DynamicHandicap_UpdateHandicap

(

)

Updates the handicap of all players.

Returns

No return.

Definition at line 32 of file sv_dynamic_handicap.qc.

References autocvar_g_dynamic_handicap_exponent, autocvar_g_dynamic_handicap_scale, DynamicHandicap_ClampHandicap(), fabs(), FOREACH_CLIENT, Handicap_SetForcedHandicap(), IS_PLAYER, and PlayerScore_Get.

Referenced by MUTATOR_HOOKFUNCTION().

{
    float total_score = 0;
    float totalplayers = 0;
    FOREACH_CLIENT(IS_PLAYER(it),
    {
        total_score += PlayerScore_Get(it, SP_SCORE);
        ++totalplayers;
    });
    float mean_score = total_score / totalplayers;
    FOREACH_CLIENT(true,
    {
        float score = PlayerScore_Get(it, SP_SCORE);
        float handicap = fabs((score - mean_score) *
            autocvar_g_dynamic_handicap_scale);
        handicap = handicap ** autocvar_g_dynamic_handicap_exponent;
        if (score < mean_score)
        {
            handicap = -handicap;
        }
        if (handicap >= 0)
        {
            handicap += 1;
        }
        else
        {
            handicap = 1 / (fabs(handicap) + 1);
        }
        handicap = DynamicHandicap_ClampHandicap(handicap);
        Handicap_SetForcedHandicap(it, handicap);
    });
}

Here is the call graph for this function:

Here is the caller graph for this function:

MUTATOR_HOOKFUNCTION() [1/6]

MUTATOR_HOOKFUNCTION	(	dynamic_handicap	,
		BuildMutatorsString
	)

Definition at line 84 of file sv_dynamic_handicap.qc.

References M_ARGV, and strcat().

{
    M_ARGV(0, string) = strcat(M_ARGV(0, string), ":handicap");
}

Here is the call graph for this function:

MUTATOR_HOOKFUNCTION() [2/6]

MUTATOR_HOOKFUNCTION	(	dynamic_handicap	,
		BuildMutatorsPrettyString
	)

Definition at line 89 of file sv_dynamic_handicap.qc.

References M_ARGV, and strcat().

{
    M_ARGV(0, string) = strcat(M_ARGV(0, string), ", Dynamic handicap");
}

Here is the call graph for this function:

MUTATOR_HOOKFUNCTION() [3/6]

MUTATOR_HOOKFUNCTION	(	dynamic_handicap	,
		ClientDisconnect
	)

Definition at line 94 of file sv_dynamic_handicap.qc.

References DynamicHandicap_UpdateHandicap().

{
    DynamicHandicap_UpdateHandicap();
}

Here is the call graph for this function:

MUTATOR_HOOKFUNCTION() [4/6]

MUTATOR_HOOKFUNCTION	(	dynamic_handicap	,
		PutClientInServer
	)

Definition at line 99 of file sv_dynamic_handicap.qc.

References DynamicHandicap_UpdateHandicap().

{
    DynamicHandicap_UpdateHandicap();
}

Here is the call graph for this function:

MUTATOR_HOOKFUNCTION() [5/6]

MUTATOR_HOOKFUNCTION	(	dynamic_handicap	,
		MakePlayerObserver
	)

Definition at line 104 of file sv_dynamic_handicap.qc.

References DynamicHandicap_UpdateHandicap().

{
    DynamicHandicap_UpdateHandicap();
}

Here is the call graph for this function:

MUTATOR_HOOKFUNCTION() [6/6]

MUTATOR_HOOKFUNCTION	(	dynamic_handicap	,
		AddedPlayerScore
	)

Definition at line 109 of file sv_dynamic_handicap.qc.

References DynamicHandicap_UpdateHandicap(), entity(), and M_ARGV.

{
    if (M_ARGV(0, entity) != SP_SCORE)
    {
        return;
    }
    DynamicHandicap_UpdateHandicap();
}

Here is the call graph for this function:

REGISTER_MUTATOR()

REGISTER_MUTATOR	(	dynamic_handicap	,
		autocvar_g_dynamic_handicap
	)

Referenced by DynamicHandicap_ClampHandicap().

Here is the caller graph for this function:

Variable Documentation

autocvar_g_dynamic_handicap

int autocvar_g_dynamic_handicap

Whether to enable dynamic handicap.

Definition at line 10 of file sv_dynamic_handicap.qc.

Referenced by DynamicHandicap_ClampHandicap().

autocvar_g_dynamic_handicap_exponent

float autocvar_g_dynamic_handicap_exponent

The exponent used to calculate handicap.

1 means linear scale. Values more than 1 mean stronger non-linear handicap. Values less than 1 mean weaker non-linear handicap.

Definition at line 17 of file sv_dynamic_handicap.qc.

Referenced by DynamicHandicap_UpdateHandicap().

autocvar_g_dynamic_handicap_max

float autocvar_g_dynamic_handicap_max

The maximum value of the handicap.

Definition at line 19 of file sv_dynamic_handicap.qc.

Referenced by DynamicHandicap_ClampHandicap().

autocvar_g_dynamic_handicap_min

float autocvar_g_dynamic_handicap_min

The minimum value of the handicap.

Definition at line 18 of file sv_dynamic_handicap.qc.

Referenced by DynamicHandicap_ClampHandicap().

autocvar_g_dynamic_handicap_scale

float autocvar_g_dynamic_handicap_scale

The scale of the handicap.

Larger values mean more penalties for strong players and more buffs for weak players.

Definition at line 13 of file sv_dynamic_handicap.qc.

Referenced by DynamicHandicap_UpdateHandicap().