====== Tracked Variables ======
 
The Tracked Variables module in **Questies** allows [[create:start|World]] creators to add custom character sheet items that the AI actively tracks and updates based on specific conditions. These variables can apply to [[:Players]], NPCs, or both, and they add depth and flexibility to gameplay by tying mechanics directly to the evolving narrative.  

==== How It Works  ==== 

World creators define the variables, who they apply to, and the instructions for when and how they should be updated. For example, a **Guild Rank** variable might be applied only to Players or to all characters. The creator can then provide instructions for the AI, such as:  

  * **Conditions for Changes**: The variable changes when a Player is promoted by an authority within their guild.  
  * **Specific Triggers**: NPCs defined with [[npc_roles|NPC Roles]] might include rules for how they assign or adjust ranks. For example, a guild leader might require Players to complete a set task or earn a certain amount of reputation before promotion.  

These instructions ensure that the AI handles updates consistently and in a way that feels natural to the story.  

==== Example Use Cases  ====
 
  * **Guild Rank**: Tracks a character’s position within a guild, updated by promotions from guild leaders.  
  * **Reputation**: Measures a character’s standing with a faction or region, increasing or decreasing based on their actions.  
  * **Morality Meter**: Reflects a character’s alignment or moral standing, shifting based on their choices in the story.

==== Activation ====

World creators can set up Tracked Variables during the world-building phase, defining who they apply to and the exact conditions for updates. Once in place, the AI automatically updates these variables as the narrative progresses, guided by the creator’s instructions.  

This module ties character progression and World interactions to meaningful in-game events, creating a more immersive and dynamic experience for Players.

==== This feature is still under development and may not work as intended. ====