AdvanceSkill - Game

From Creation Kit
Jump to: navigation, search

Member of: Game Script

Advances the progress of the provided Skill by the given amount (for the player only).

Syntax

Function AdvanceSkill(string asSkillName, float afMagnitude) native global

Parameters

  • asSkillName: The Skill to progress.
  • afMagnitude: The amount by which the skill progress will be advanced. This is in Skill Usage amounts, so it will count towards skill progression but won't necessarily change the Skill itself. The amount must be positive. If the new amount exceeds the skill's level threshold, the skill will advance, and possibly level up. This amount is automatically modified by any active effects such as a Guardian Stone.

Return Value

None.

Examples

; Advance the given skill progress (Skill XP) on the player by the provided amount
Game.AdvanceSkill("Marksman", 50.0)

Notes

  • The amount of Skill XP needed to level up the skill varies depending on the skill, and by the current level of that skill.
  • This will invoke the on-screen message for skill progression every time the passed in amount results in a level up. If the skill will increase 20 levels due to this function, the on screen message will display each level. This can take a long time depending on how many levels. Use of this function is not recommended if you intend to use this to increase a skill by many levels. Use IncrementSkill - Game or IncrementSkillBy - Game instead.
  • The above note applies to Special Edition of Skyrim only.

See Also