Difference between revisions of "Game Script"
Jump to navigation
Jump to search
m
Fixed a mistake that lost half the page....whoops
imported>CraftySentinel m |
imported>CraftySentinel m (Fixed a mistake that lost half the page....whoops) |
||
Line 1: | Line 1: | ||
'''Source:''' Creation Kit | |||
[[ | '''Extends:''' None | ||
'''Flags:''' [[Flag Reference|Hidden]] | |||
Collection of game-specific global functions | Collection of game-specific global functions | ||
Line 9: | Line 11: | ||
== Definition == | == Definition == | ||
<source lang="papyrus"> | <source lang="papyrus"> | ||
ScriptName Game | ScriptName Game Hidden | ||
</source> | </source> | ||
== Global Functions == | == Global Functions == | ||
''' | {|class="wikitable" width =100% | ||
!style="text-align:left;" width=25%|Function | |||
!style="text-align:left;"|Description | |||
|- | |||
|[[AddAchievement - Game|'''AddAchievement'''(Int ''aiAchievementID'')]] | |||
|Adds the specified achievement/trophy to the player's gamer profile. | |||
|- | |||
|[[AddPerkPoints - Game|'''AddPerkPoints'''(Int ''aiPerkPoints'')]] | |||
|Adds the given number of perk points to the player. Clamped at 255. | |||
|- | |||
|[[AdvanceSkill - Game|'''AdvanceSkill'''(String ''asSkillName'', Float ''afMagnitude'')]] | |||
|Advance the given skill on the player by the provided amount of skill usage | |||
|- | |||
|[[AddHavokBallAndSocketConstraint - Game|Bool '''AddHavokBallAndSocketConstraint'''(ObjectReference ''arRefA'', String ''arRefANode'', ObjectReference ''arRefB'', String ''arRefBNode'', Float ''afRefALocalOffsetX'', Float ''afRefALocalOffsetY'', Float ''afRefALocalOffsetZ'', Float ''afRefBLocalOffsetX'', Float ''afRefBLocalOffsetY'', Float ''afRefBLocalOffsetZ'')]] | |||
|Adds a ball-and-socket constraint between two rigid bodies, identified by their ref and node names | |||
|- | |||
|[[CalculateFavorCost - Game|Int '''CalculateFavorCost'''(Int ''aiFavorPrice'')]] | |||
|Calculates how many points the player would have to pay for a favor of the specified price. | |||
|- | |||
|[[ClearPrison - Game|'''ClearPrison'''()]] | |||
|Clears all Prison variables on the PlayerCharacter so the game will know he is out of prison. | |||
|- | |||
|[[ClearTempEffects - Game|'''ClearTempEffects'''()]] | |||
|Clears all temp effects (such as terrain effects) in the game. | |||
|- | |||
|[[DisablePlayerControls - Game|'''DisablePlayerControls'''(Bool ''abMovement'', Bool ''abFighting'', Bool ''abCamSwitch'', Bool ''abLooking'', Bool ''abSneaking'', Bool ''abMenu'', Bool ''abActivate'', Bool ''abJournalTabs'', Int ''aiDisablePOVType'')]] | |||
|Disables the specified player controls. | |||
|- | |||
|[[EnableFastTravel - Game|'''EnableFastTravel'''(Bool ''abEnable'')]] | |||
|Enables or disables the player's ability to fast travel. | |||
|- | |||
|[[EnablePlayerControls - Game|'''EnablePlayerControls'''(Bool ''abMovement'', Bool ''abFighting'', Bool ''abCamSwitch'', Bool ''abLooking'', Bool ''abSneaking'', Bool ''abMenu'', Bool ''abActivate'', Bool ''abJournalTabs'', Int ''aiDisablePOVType'')]] | |||
|Enables the specified player controls. | |||
|- | |||
|[[FadeOutGame - Game|'''FadeOutGame'''(Bool ''abFadingOut'', Bool ''abBlackFade'', Float ''afSecsBeforeFade'', Float ''afFadeDuration'')]] | |||
|Fades the game in and out with the specified parameters. | |||
|- | |||
|[[FastTravel - Game|'''FastTravel'''(ObjectReference ''akDestination'')]] | |||
|Fast-travels the player to the specified object's location. | |||
|- | |||
|[[FindClosestActor - Game|Actor '''FindClosestActor'''(Float ''afX'', Float ''afY'', Float ''afZ'', Float ''afRadius'')]] | |||
|Finds the closest actor within a given radius of a location | |||
|- | |||
|[[FindClosestActorFromRef - Game|Actor '''FindClosestActorFromRef'''(ObjectReference ''arCenter'', Float ''afRadius'')]] | |||
|Finds the closest actor within a given radius of a reference | |||
|- | |||
|[[FindClosestReferenceOfAnyTypeInList - Game|ObjectReference '''FindClosestReferenceOfAnyTypeInList'''(FormList ''arBaseObjects'', Float ''afX'', Float ''afY'', Float ''afZ'', Float ''afRadius'')]] | |||
|Finds the closest reference of any of the base objects in the list within a given radius of a location | |||
|- | |||
|[[FindClosestReferenceOfAnyTypeInListFromRef - Game|ObjectReference '''FindClosestReferenceOfAnyTypeInListFromRef'''(FormList ''arBaseObjects'', ObjectReference ''arCenter'', Float ''afRadius'')]] | |||
|Finds the closest reference of any of the base objects in the list within a given radius of a reference | |||
|- | |||
|[[FindClosestReferenceOfType - Game|ObjectReference '''FindClosestReferenceOfType'''(Form ''arBaseObject'', Float ''afX'', Float ''afY'', Float ''afZ'', Float ''afRadius'')]] | |||
|Finds the closest reference of a given base object within a given radius of a location | |||
|- | |||
|[[FindClosestReferenceOfTypeFromRef - Game|ObjectReference '''FindClosestReferenceOfTypeFromRef'''(Form ''arBaseObject'', ObjectReference ''arCenter'', Float ''afRadius'')]] | |||
|Finds the closest reference of a given base object within a given radius of a reference | |||
|- | |||
|[[FindRandomActor - Game|Actor '''FindRandomActor'''(Float ''afX'', Float ''afY'', Float ''afZ'', Float ''afRadius'')]] | |||
|Finds a random actor within a given radius of a location | |||
|- | |||
|[[FindRandomActorFromRef - Game|Actor '''FindRandomActorFromRef'''(ObjectReference ''arCenter'', Float ''afRadius'')]] | |||
|Finds a random actor within a given radius of a reference | |||
|- | |||
|[[FindRandomReferenceOfAnyTypeInList - Game|ObjectReference '''FindRandomReferenceOfAnyTypeInList'''(FormList ''arBaseObjects'', Float ''afX'', Float ''afY'', Float ''afZ'', Float ''afRadius'')]] | |||
|Finds a random reference of any of the base objects in the list within a given radius of a location | |||
|- | |||
|[[FindRandomReferenceOfAnyTypeInListFromRef - Game|ObjectReference '''FindRandomReferenceOfAnyTypeInListFromRef'''(FormList ''arBaseObjects'', ObjectReference ''arCenter'', Float ''afRadius'')]] | |||
|Finds a random reference of any of the base objects in the list within a given radius of a reference | |||
|- | |||
|[[FindRandomReferenceOfType - Game|ObjectReference '''FindRandomReferenceOfType'''(Form ''arBaseObject'', Float ''afX'', Float ''afY'', Float ''afZ'', Float ''afRadius'')]] | |||
|Finds a random reference of a given base object within a given radius of a location | |||
|- | |||
|[[FindRandomReferenceOfTypeFromRef - Game|ObjectReference '''FindRandomReferenceOfTypeFromRef'''(Form ''arBaseObject'', ObjectReference ''arCenter'', Float ''afRadius'')]] | |||
|Finds a random reference of a given base object within a given radius of a reference | |||
|- | |||
|[[ForceFirstPerson - Game|'''ForceFirstPerson'''()]] | |||
|Forces the player camera into 1st-person. | |||
|- | |||
|[[ForceThirdPerson - Game|'''ForceThirdPerson'''()]] | |||
|Forces the player camera into 3rd-person. | |||
|- | |||
|[[GetForm - Game|Form '''GetForm'''(Int ''aiFormID'')]] | |||
|Obtains a [[Form Script|Form]] from the game by its form ID number. | |||
|- | |||
|[[GetFormFromFile - Game|Form '''GetFormFromFile'''(Int ''aiFormID'', String ''asFilename'')]] | |||
|Obtains the form specified by its form ID number which originated in the specified file. | |||
|- | |||
|[[GetGameSettingFloat - Game|Float '''GetGameSettingFloat'''(String ''asGameSetting'')]] | |||
|Obtains the value of a float game setting. | |||
|- | |||
|[[GetGameSettingInt - Game|Float '''GetGameSettingInt'''(String ''asGameSetting'')]] | |||
|Obtains the value of an int game setting. | |||
|- | |||
|[[GetGameSettingString - Game|Float '''GetGameSettingString'''(String ''asGameSetting'')]] | |||
|Obtains the value of a string game setting. | |||
|- | |||
|[[GetPlayer - Game|Actor '''GetPlayer'''()]] | |||
|Obtains the [[Actor Script|Actor]] that represents the player. | |||
|- | |||
|[[GetPlayerGrabbedRef - Game|ObjectReference '''GetPlayerGrabbedRef'''()]] | |||
|Obtains the [[ObjectReference Script|ObjectReference]] the player is currently grabbing. | |||
|- | |||
|[[GetPlayersLastRiddenHorse - Game|Actor '''GetPlayersLastRiddenHorse'''()]] | |||
|Gets this actors last ridden horse if it is the player. Returns None if player has not ridden a horse is not the player. | |||
|- | |||
|[[GetRealHoursPassed - Game|Float '''GetRealHoursPassed'''()]] | |||
|Returns the number of real-life hours that have passed playing the game. | |||
|- | |||
|[[GetSunPositionX - Game|Float '''GetSunPositionX'''()]] | |||
|Gets the X position of the sun. | |||
|- | |||
|[[GetSunPositionY - Game|Float '''GetSunPositionY'''()]] | |||
|Gets the Y position of the sun. | |||
|- | |||
|[[GetSunPositionZ - Game|Float '''GetSunPositionZ'''()]] | |||
|Gets the Z position of the sun. | |||
|- | |||
|[[HideTitleSequenceMenu - Game|'''HideTitleSequenceMenu'''()]] | |||
|Hides the title sequence menu. | |||
|- | |||
|[[IncrementSkill - Game|'''IncrementSkill'''(String ''asSkillName'')]] | |||
|Advances the provided Skill by the one point (for the player only). | |||
|- | |||
|[[IncrementSkillBy - Game|'''IncrementSkillBy'''(String ''asSkillName'', Int ''aiCount'')]] | |||
|Advances the provided Skill by the given number of points (for the player only). | |||
|- | |||
|[[IncrementStat - Game|'''IncrementStat'''(String ''asStatName'', Int ''aiModAmount'')]] | |||
|Modifies the specified MiscStat by the given amount | |||
|- | |||
|[[IsActivateControlsEnabled - Game|Bool '''IsActivateControlsEnabled'''()]] | |||
|Are the activation controls enabled? | |||
|- | |||
|[[IsCamSwitchControlsEnabled - Game|Bool '''IsCamSwitchControlsEnabled'''()]] | |||
|Are the camera switch controls enabled? | |||
|- | |||
|[[IsFastTravelEnabled - Game|Bool '''IsFastTravelEnabled'''()]] | |||
|Is fast travel enabled? | |||
|- | |||
|[[IsFastTravelControlsEnabled - Game|Bool '''IsFastTravelControlsEnabled'''()]] | |||
|Are fast travel controls enabled? | |||
|- | |||
|[[IsFightingControlsEnabled - Game|Bool '''IsFightingControlsEnabled'''()]] | |||
|Are the fighting controls enabled? | |||
|- | |||
|[[IsJournalControlsEnabled - Game|Bool '''IsJournalControlsEnabled'''()]] | |||
|Are the journal menu controls enabled? | |||
|- | |||
|[[IsLookingControlsEnabled - Game|Bool '''IsLookingControlsEnabled'''()]] | |||
|Are the looking controls enabled? | |||
|- | |||
|[[IsMenuControlsEnabled - Game|Bool '''IsMenuControlsEnabled'''()]] | |||
|Are the menu controls enabled? | |||
|- | |||
|[[IsMovementControlsEnabled - Game|Bool '''IsMovementControlsEnabled'''()]] | |||
|Are the movement controls enabled? | |||
|- | |||
|[[IsPlayerSungazing - Game|Bool '''IsPlayerSungazing'''()]] | |||
|Checks to the see if the player is looking directly at the sun. | |||
|- | |||
|[[IsSneakingControlsEnabled - Game|Bool '''IsSneakingControlsEnabled'''()]] | |||
|Are the sneaking controls enabled? | |||
|- | |||
|[[IsWordUnlocked - Game|Bool '''IsWordUnlocked'''(WordOfPower ''akWord'')]] | |||
|Is the word of power unlocked on the player? | |||
|- | |||
|[[PlayBink - Game|'''PlayBink'''(String ''asFileName'', Bool ''abInterruptible'', Bool ''abMuteAudio'', Bool ''abMuteMusic'', Bool ''abLetterbox'')]] | |||
|Plays a bink video | |||
|- | |||
|[[PrecacheCharGen - Game|'''PrecacheCharGen'''()]] | |||
|Precaches all the data used by character gen to avoid hitches with file I/O. | |||
|- | |||
|[[PrecacheCharGenClear - Game|'''PrecacheCharGenClear'''()]] | |||
|Clears all the previously cached data used by character gen. | |||
|- | |||
|[[QueryStat - Game|Int '''QueryStat'''(String ''asStat'')]] | |||
|Queries the given stat and returns its value. | |||
|- | |||
|[[QuitToMainMenu - Game|'''QuitToMainMenu'''()]] | |||
|Forces the game back to the main menu. | |||
|- | |||
|[[RemoveHavokConstraints - Game|Bool '''RemoveHavokConstraints'''(ObjectReference ''arFirstRef'', String ''arFirstRefNodeName'', ObjectReference ''arSecondRef'', String ''arSecondRefNodeName'')]] | |||
|Removes any constraint between two rigid bodies | |||
|- | |||
|[[RequestAutoSave - Game|'''RequestAutoSave'''()]] | |||
|Requests for an auto-save to be made. | |||
|- | |||
|[[RequestModel - Game|'''RequestModel'''(String ''asModelName'')]] | |||
|Requests the specified model. | |||
|- | |||
|[[RequestSave - Game|'''RequestSave'''()]] | |||
|Requests for a normal save to be made. | |||
|- | |||
|[[SendWereWolfTransformation - Game|'''SendWereWolfTransformation'''()]] | |||
|Finds an actor in high who can detect the player to call werewolf crime on the player | |||
|- | |||
|[[ServeTime - Game|'''ServeTime'''()]] | |||
|Has the player serve their jail time. | |||
|- | |||
|[[SetAllowFlyingMountLandingRequests - Game|'''SetAllowFlyingMountLandingRequests'''(Bool ''abAllow'')]] | |||
|Allow or disallow the player requests to have a flying mount land. | |||
|- | |||
|[[SetBeastForm - Game|'''SetBeastForm'''(Bool ''abEntering'')]] | |||
|Flags the player as being in/out of "beast form". | |||
|- | |||
|[[SetCameraTarget - Game|'''SetCameraTarget'''(Actor ''arTarget'')]] | |||
|Sets the camera target actor | |||
|- | |||
|[[SetHudCartMode - Game|'''SetHudCartMode'''(Bool ''abSetCartMode'')]] | |||
|Flags the HUD as being in "cart mode" or not. | |||
|- | |||
|[[SetInChargen - Game|'''SetInChargen'''(Bool ''abDisableSaving'', Bool ''abDisableWaiting'', Bool ''abShowControlsDisabledMessage'')]] | |||
|Enable/disable various functionality which we want in chargen. | |||
|- | |||
|[[SetPlayerAIDriven - Game|'''SetPlayerAIDriven'''(Bool ''abAIDriven'')]] | |||
|Enables or disables the AI driven flag on the player. | |||
|- | |||
|[[SetPlayerReportCrime - Game|'''SetPlayerReportCrime'''(Bool ''abReportCrime'')]] | |||
|Set the state of the player as an actor who commits crimes | |||
|- | |||
|[[SetSittingRotation - Game|'''SetSittingRotation'''(Float ''afValue'')]] | |||
|Set the player's sitting camera offset rotation. | |||
|- | |||
|[[SetSunGazeImageSpaceModifier - Game|'''SetSunGazeImageSpaceModifier'''(ImageSpaceModifier ''apImod'')]] | |||
|Will cause the specified ImageSpace Modifier to be triggered when the player begins looking at the sun | |||
|- | |||
|[[ShakeCamera - Game|'''ShakeCamera'''(ObjectReference ''akSource'', Float ''afStrength'')]] | |||
|Shakes the camera from the specified location with the specified strength. | |||
|- | |||
|[[ShakeController - Game|'''ShakeController'''(Float ''afLeftStrength'', Float ''afRightStrength'', Float ''afDuration'')]] | |||
|Shakes the controller for the specified amount of time. | |||
|- | |||
|[[ShowFirstPersonGeometry - Game|'''ShowFirstPersonGeometry'''(Bool ''abShow'')]] | |||
|Shows or hides the first-person geometry | |||
|- | |||
|[[ShowLimitedRaceMenu - Game|'''ShowLimitedRaceMenu'''()]] | |||
|Shows the race/sex change menu, but without the ability to change race or sex. | |||
|- | |||
|[[ShowRaceMenu - Game|'''ShowRaceMenu'''()]] | |||
|Shows the race/sex change menu. | |||
|- | |||
|[[ShowTitleSequenceMenu - Game|'''ShowTitleSequenceMenu'''()]] | |||
|Shows the title sequence menu. | |||
|- | |||
|[[ShowTrainingMenu - Game|'''ShowTrainingMenu'''(Actor ''aActor'')]] | |||
|Shows the training menu provided by actor parameter. | |||
|- | |||
|[[StartTitleSequence - Game|'''StartTitleSequence'''(String ''asSequenceName'')]] | |||
|Plays the specified sequence in the title menu. | |||
|- | |||
|[[TeachWord - Game|'''TeachWord'''(WordOfPower ''akWord'')]] | |||
|Teaches the specified [[WordOfPower Script|WordOfPower]] to the player | |||
|- | |||
|[[TriggerScreenBlood - Game|'''TriggerScreenBlood'''(Int ''aiValue'')]] | |||
|Trigger on-screen blood splatter. | |||
|- | |||
|[[UnlockWord - Game|'''UnlockWord'''(WordOfPower ''akWord'')]] | |||
|Unlocks the specified [[WordOfPower Script|WordOfPower]] so the player can use it | |||
|- | |||
|[[UsingGamepad - Game|Bool '''UsingGamepad'''()]] | |||
|Returns whether the player is using a gamepad or not. | |||
|- | |||
|} | |||
== SKSE Global Functions == | == SKSE Global Functions == | ||
''' | {|class="wikitable" width =100% | ||
!style="text-align:left;" width=25%|Function | |||
!style="text-align:left;"|Description | |||
|- | |||
|[[GetPerkPoints - Game|Int '''GetPerkPoints'''()]] | |||
|Returns the number of perk points available to the player. | |||
|- | |||
|[[SetPerkPoints - Game|'''SetPerkPoints'''(Int ''perkPoints'')]] | |||
|Sets the number of perk points available to the player. | |||
|- | |||
|[[ModPerkPoints - Game|'''ModPerkPoints'''(Int ''perkPoints'')]] | |||
|Changes the number of perk points available to the player by the specified amount. | |||
|- | |||
|[[SetGameSettingBool - Game|'''SetGameSettingBool'''(String ''setting'', Bool ''value'')]] | |||
|Changes the value of boolean Game Settings. | |||
|- | |||
|[[SetGameSettingInt - Game|'''SetGameSettingInt'''(String ''setting'', Int ''value'')]] | |||
|Changes the value of integer Game Settings. | |||
|- | |||
|[[SetGameSettingFloat - Game|'''SetGameSettingFloat'''(String ''setting'', Float ''value'')]] | |||
|Changes the value of float Game Settings. | |||
|- | |||
|[[SetGameSettingString - Game|'''SetGameSettingString'''(String ''setting'', String ''value'')]] | |||
|Changes the value of string Game Settings. | |||
|- | |||
|[[GetModCount - Game|Int '''GetModCount'''()]] | |||
|Returns the number of mods currently active. | |||
|- | |||
|[[GetModName - Game|String '''GetModName'''(Int ''modIndex'')]] | |||
|Returns the mods name at the specified index. | |||
|- | |||
|[[GetModAuthor - Game|String '''GetModAuthor'''(Int ''modIndex'')]] | |||
|Returns the specified mod's author. | |||
|- | |||
|[[GetModDescription - Game|String '''GetModDescription'''(Int ''modIndex'')]] | |||
|Returns the specified mod's description. | |||
|- | |||
|[[GetModDependencyCount - Game|Int '''GetModDependencyCount'''(Int ''modIndex'')]] | |||
|Returns the dependency count of the specified mod. | |||
|- | |||
|[[GetNthModDependency - Game|Int '''GetNthModDependency'''(Int ''modIndex'', Int ''n'')]] | |||
|Returns the mod index of the specified Dependency. | |||
|- | |||
|[[GetCameraState - Game|Int '''GetCameraState'''()]] | |||
|Returns the character's current camera state.(0 - first person;1 - auto vanity;2 - VATS;3 - free;4 - iron sights;5 - furniture;6 - transition;7 - tweenmenu;8 - third person 1;9 - third person 2;10 - horse;11 - bleedout;12 - dragon) | |||
|- | |||
|[[SaveGame - Game|'''SaveGame'''(String ''name'')]] | |||
|Saves the game with the specified name. | |||
|- | |||
|[[LoadGame - Game|'''LoadGame'''(String ''name'')]] | |||
|Loads the save with the specified name. | |||
|- | |||
|[[GetNumTintMasks - Game|Int '''GetNumTintMasks'''()]] | |||
|Returns the total number of tints for the player. | |||
|- | |||
|[[GetNthTintMaskColor - Game|Int '''GetNthTintMaskColor'''(Int ''n'')]] | |||
|Returns the color of the Nth tint mask. | |||
|- | |||
|[[GetNthTintMaskType - Game|Int '''GetNthTintMaskType'''(Int ''n'')]] | |||
|Returns the type of the Nth tint mask. | |||
|- | |||
|[[SetNthTintMaskColor - Game|Int '''SetNthTintMaskColor'''(Int ''n'', Int ''color'')]] | |||
|Sets the color of the Nth tint mask. | |||
|- | |||
|[[GetNthTintMaskTexturePath - Game|String '''GetNthTintMaskTexturePath'''(Int ''n'')]] | |||
|Returns the texture path of the Nth tint mask. | |||
|- | |||
|[[SetNthTintMaskTexturePath - Game|'''SetNthTintMaskTexturePath'''(Int ''n'')]] | |||
|Sets the texturepath of the Nth tint mask. | |||
|- | |||
|[[GetNumTintsByType - Game|Int '''GetNumTintsByType'''(Int ''type'')]] | |||
|Returns how many indexes there are for this type. | |||
|- | |||
|[[GetTintMaskColor - Game|Int '''GetTintMaskColor'''(Int ''type'', Int ''index'')]] | |||
|Returns the color for the particular tintMask type and index. | |||
|- | |||
|[[SetTintMaskColor - Game|'''SetTintMaskColor'''(Int ''color'', Int ''type'', Int ''index'')]] | |||
|Sets the tintMask color for the particular type and index | |||
|- | |||
|[[UpdateHairColor - Game|'''UpdateHairColor'''()]] | |||
|Instantly updates the player's hair color. | |||
|- | |||
|[[GetSkillLegendaryLevel - Game|Int '''GetSkillLegendaryLevel'''(String ''actorValue'')]] | |||
|Returns the legendary level for the skill | |||
|- | |||
|[[SetSkillLegendaryLevel - Game|'''SetSkillLegendaryLevel'''(String ''actorValue'', Int ''level'')]] | |||
|Sets the legendary level for the skill. | |||
|- | |||
|} | |||
[[Category:Scripting]] | |||
[[Category:Papyrus]] | |||
[[Category:Script Objects]] | |||
[[Category:SKSE]] | |||
[[Category:SKSE Script Objects]] |