Difference between revisions of "SetLevel"

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search
imported>JOG
imported>Scanner
m
Line 10: Line 10:
* LevelToPCFlag == 1 means that level is an offset to the player's level
* LevelToPCFlag == 1 means that level is an offset to the player's level
* LevelToPCFlag == 0 means that level is a straight level (also that Min and Max params are meaningless)
* LevelToPCFlag == 0 means that level is a straight level (also that Min and Max params are meaningless)
In Case an actor is auto-scaled via PCOffset-Flag set, the LevelToPCFlag == 0 is meaningless (doesn't work) and the level is always offset to the player's level.


MinLevel and MaxLevel correspond to the Calc Min and Calc Max settings on the NPC and Creature tabs in the editor.
MinLevel and MaxLevel correspond to the Calc Min and Calc Max settings on the NPC and Creature tabs in the editor.
Line 16: Line 18:


NOTE: This function can be called on the player and will change the player's level, but not any of his stats (and the world will not "level up" with the player until he goes through a loading door, or changes cells), so this is not recommended. Use [[AdvancePCLevel]] instead.
NOTE: This function can be called on the player and will change the player's level, but not any of his stats (and the world will not "level up" with the player until he goes through a loading door, or changes cells), so this is not recommended. Use [[AdvancePCLevel]] instead.
IMPORTANT: This function can cause crashes and is not considered safe ! It's just a matter of time or number of uses (prabability based) until it produces a crash. The best way to crash is to use it on an actor that is equipped with a bow. The other way is to use it very frequently.


==See Also==
==See Also==

Revision as of 09:47, 6 August 2007

Syntax:

SetLevel iNewLevel, LevelToPCFlag, MinLevel (optional), MaxLevel (optional)

Example:

SetLevel 10     ; sets the actor's level to 10
SetLevel 2, 1   ; sets the actor's level to PC+2
SetLevel 0, 1, 6, 0    ; sets the actor's level to PC+0, min 6, no maximum

For NPCs and Creatures, this function allows you to completely change their level as well as whether they are leveled to the player or not.

  • LevelToPCFlag == 1 means that level is an offset to the player's level
  • LevelToPCFlag == 0 means that level is a straight level (also that Min and Max params are meaningless)

In Case an actor is auto-scaled via PCOffset-Flag set, the LevelToPCFlag == 0 is meaningless (doesn't work) and the level is always offset to the player's level.

MinLevel and MaxLevel correspond to the Calc Min and Calc Max settings on the NPC and Creature tabs in the editor.

Calling SetLevel will also immediately recalc an actor's stats and equipment (as if the player just leveled up).

NOTE: This function can be called on the player and will change the player's level, but not any of his stats (and the world will not "level up" with the player until he goes through a loading door, or changes cells), so this is not recommended. Use AdvancePCLevel instead.

IMPORTANT: This function can cause crashes and is not considered safe ! It's just a matter of time or number of uses (prabability based) until it produces a crash. The best way to crash is to use it on an actor that is equipped with a bow. The other way is to use it very frequently.

See Also

AdvancePCLevel