Favor
"Favor" is the "reputation" you have with the gods/goddesses. High favor can bring blessings and low favor can bring curses. Players gain or lose favor depending on their actions, such as killing specific creatures or presenting gifts to an altar.
Favor is updated approximately every 20 ticks (configurable)
The amount of favor each player has with a specific deity is represented by points and levels, similar to Experience. By default, the player has favor level 0 with all gods/goddesses. The player's level can increase up to 10 or decrease to -10 but these ranges can be configured using commands.
Each player's favor with each deity will tend toward level 0 over time. The percent chance for favor to decay each tick depends on the config values for "favor_update_rate" and "favor_decay_rate". Each deity can have different decay chances.
Each player can have 1 patron deity. Some perks may only be available for players who have declared that deity as their patron. Currently, the only way to declare a patron is through commands or another perk. Favor with a Patron deity decays more slowly.
The /favor command can be used to query or modify favor amounts. It has the following uses:
/favor list/favor set <targets> enabled (true|false)/favor add <targets> <deity> <amount> [levels|points|decay]/favor set <targets> <deity> <amount> [levels|points|decay]/favor set <targets> <deity> patron/favor set <targets> <deity> unlocked (true|false)/favor query <target> <deity> [levels|points|decay]/favor query <target> enabled/favor query <target> patron/favor cap <target> <deity> <min> <max> [levels|points]/favor reset <targets>/favor reset <targets> <deity>/favor reset <targets> (patron|cooldown)
<deity> is the namespaced id of a deity such as "greek:hades"
Setting favor enabled to false will prevent favor from changing and favor effects will not run for the specified player(s).
Favor decay is the percent chance that a favor update will trigger favor decay for a given deity. It is stored internally as a number from 0 to 1.0, but the command uses an integer from 0 to 100.
The config file (rpggods-common.toml) determines the following:
- Whether favor is enabled
- The frequency of favor updates (favor decay, cooldowns, and perk checks)
- The percent chance that a favor update will include favor decay
- The percent chance that a favor update will include
random_tickperks - How to send feedback to the player when a perk is triggered
- Whether various Affinity perks are enabled
- Whether the brazier can be used to automate offerings, and how often it updates
- A list of mobs that, when tamed, can appear to be sitting