Difference between revisions of "FAQ: My Script Doesn't Work!"

Acclimating to [[:Category:Papyrus|Papyrus]] can be a difficult process - this page is here to help!  The goal of this page is to collect the most common stumbling blocks and hurdles we all encounter when trying to work with Papyrus scripts, especially early on.   

Acclimating to [[:Category:Papyrus|Papyrus]] can be a difficult process - this page is here to help!  The goal of this page is to collect the most common stumbling blocks and hurdles we all encounter when trying to work with Papyrus scripts, especially early on.   

Your contributions matter!  If you've found a way around some sticking point, please add to this FAQ.  Links are strongly encouraged here as are code fragments to demonstrate what you're talking about.

Your contributions matter!  If you've found a way around some sticking point, please add to this FAQ.  Links are strongly encouraged here as are code fragments to demonstrate what you're talking about.

==General==

==General==

===My Script compiles, but doesn't work!  How can I debug this?===

===My Script compiles, but doesn't work!  How can I debug this?===

When you begin working with Papyrus, you'll want to activate script logging.  This feature is disabled by default - most users don't need it, and logging consumes a small amount of your PC performance in-game.   

When you begin working with Papyrus, you'll want to activate script logging.  This feature is disabled by default - most users don't need it, and logging consumes a small amount of your PC performance in-game.   

(GetLinkedRef() as Actor).IsInFaction(BanditFaction)

(GetLinkedRef() as Actor).IsInFaction(BanditFaction)

</source>

</source>

==Items==

==Items==

===I can't remove an item from a player===

===I can't remove an item from a player===

*If you are using AddItem with a negative value, that does not seem to work (even though it works in the console). Use RemoveItem instead and check for the sign with a conditional.

*If you are using AddItem with a negative value, that does not seem to work (even though it works in the console). Use RemoveItem instead and check for the sign with a conditional.

===I can't get a script to run on an item, and I'm sure that the script works properly===

===I can't get a script to run on an item, and I'm sure that the script works properly===

*Adding or renaming new scripts on items that already exist as ObjectReferences in game ''does not work properly''. More details for reading [[Save_File_Notes_(Papyrus)#Scripts|here]].

*Adding or renaming new scripts on items that already exist as ObjectReferences in game ''does not work properly''. More details for reading [[Save_File_Notes_(Papyrus)#Scripts|here]].

==Object Creation==

==Object Creation==

=== I Cannot create a new object ===

=== I Cannot create a new object ===

*Problem: I can't create a new object.

*Problem: I can't create a new object.

*Explanation: Casting will only work if the reference casted actually has its script attached. For instance, the TestReference base object needs to have the TestReference script attached in the editor form window for it to be castable from ObjectReference to TestReference.

*Explanation: Casting will only work if the reference casted actually has its script attached. For instance, the TestReference base object needs to have the TestReference script attached in the editor form window for it to be castable from ObjectReference to TestReference.

*Solution: Use the editor and attach the script to the object you're actually casting. For instance, if TestReference is supposed to refer to a book, open up the book you want to cast in the editor window, goto the scripts section, and attach the TestReference script from there.

*Solution: Use the editor and attach the script to the object you're actually casting. For instance, if TestReference is supposed to refer to a book, open up the book you want to cast in the editor window, goto the scripts section, and attach the TestReference script from there.

==Quests==

==Quests==

===I can't get my alias to point to a reference ===

===I can't get my alias to point to a reference ===

*Several possibilities here:

*Several possibilities here:

**'''You may need to rename the script to get the Properties window to work. Go to the "Advanced" tab and click "Rename Script" and give it a new name.'''

**'''You may need to rename the script to get the Properties window to work. Go to the "Advanced" tab and click "Rename Script" and give it a new name.'''

**Click on the properties window on the lower right side (next to TIF_ or whatever name you gave the script) to add the new property.

**Click on the properties window on the lower right side (next to TIF_ or whatever name you gave the script) to add the new property.

{{Languages}}

{{Languages}}

[[Category:Papyrus]]

[[Category:Papyrus]]

[[Category:Solutions]]

[[Category:Solutions]]