Server:Faction

From The Al`Kabor Project Wiki
Revision as of 11:13, 21 November 2024 by Nazwadi (talk | contribs)
Jump to navigation Jump to search

This article will attempt to explain how faction works server-side to assist with understanding the various modifiers applied to characters between the base values and the ones you experience in-game.

In the source code, faction is found in /common/faction.h and /common/faction.cpp.

How Faction Gets Calculated

Faction is ultimately calculated in the FACTION_VALUE CalculateFaction(FactionMods* fm, int32 tmpCharacter_value, bool lua = false); function, where

character_value += base value + class modifier + race modifier + deity modifier

The result of this formula is then returned as a FactionValue.

CalculateFaction is called from /zone/client.cppin the GetFactionLevel function. First, the server queries data about the NPC's Primary Faction from the database and stores it in a variable called tmpFactionValue. It then calculates faction bonuses from Alliance type spells and items and adds those to tmpFactionValue. Finally, CalculateFaction is called and passed the modifiers from the NPC's Primary Faction and the tmpFactionValue.

Faction Properties

The Faction struct defined in /common/faction.h defines the following members:

Property Data Type Description
id int32 database identifier
mods std::map<std::string, int16>
base int16 The base, unmodified value that players start with for this faction before race, class, and deity modifiers are applied
name char array 50 The name of the faction
see_illusion bool Determines whether the faction will see through racial illusion spells
min_cap int16 Minimum value players can reach with this faction
max_cap int16 Maximum value players can reach with this faction

Faction Modifiers

The FactionMod struct defined in /common/faction.h defines the following members:

  • int32 base
  • int32 class_mod
  • int32 race_mod
  • int32 deity_mod

Faction Value Ranges

Min Cap Max Cap FACTION_VALUE (Enum)
>= 2000 - FACTION_MAX_ALLY = 0
>= 1100 - FACTION_ALLY = 1
>= 750 <= 1099 FACTION_WARMLY = 2
>= 500 <= 749 FACTION_KINDLY = 3
>= 100 <= 499 FACTION_AMIABLY = 4
>= 0 <= 99 FACTION_INDIFFERENTLY = 5
>= -100 <= -1 FACTION_APPREHENSIVELY = 6
>= -500 <= -101 FACTION_DUBIOUSLY = 7
>= -750 <= -501 FACTION_THREATENINGLY = 8
- <= -751 FACTION_SCOWLS = 9
- <= -2000 FACTION_MAX_SCOWLS = 10

The range of faction values above which are returned as the enums described in the final column are filtered through the const char *FactionValueToString(FACTION_VALUE faction_value); function to convert them to the corresponding string equivalent before being sent to the client and used for in-game consider or similar messages.

NPC Faction

The NPCFaction struct defined in /common/faction.h defines the following members:

Property Data Type Description
factionID uint32
value_mod int32
npc_value int8
temp uint8