Просмотр исходного текста страницы FAQ: Мой скрипт не работает!

[[Файл:Symbol_error.png]] '''Статья не закончена!'''
[[Category:Незаконченная статья]]

=Обзор=
This is a page for the community to document common pitfalls, mistakes, and best practices when working with Papyrus.

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.

=FAQ=

==Общие==

===Мой скрипт компилируется, но не работает!  Как мне его отладить?===
Когда вы начинаете работать со скриптами на Papyrus, желательно активировать логи скриптов.  По-умолчанию эта возможность выключена - потому что большинству пользователей она не нужна, и ведение лога чуточку снижает производительность ПК во время игры.  

Для того чтобы включить ведение лога, нужно изменить несколько параметров в ini-файле. Откройте (или создайте) ваш '''SkyrimCustom.ini''' файл, находящийся в '''.../My Documents/My Games/Skyrim'''.  Добавьте следующие строчки в этот файл (возможно вам придется изменить эти строчки и в файле Skyrim.ini, если они уже были там указаны).  Если какая-либо из этих строчек уже существует, то убедитесь, стоит ли у неё в значении "1" вместо "0".

 [Papyrus]
 bEnableLogging=1
 bEnableTrace=1
 bLoadDebugInformation = 1

'''bEnableLogging''' переключает всю систему ведения лога скриптов; '''bEnableTrace''' включает [[Trace_-_Debug|Debug.Trace]] и связанные с ней функции, а '''bLoadDebugInformation''' будет загружать информацию о номерах строк, таким образом вы можете точно определить место ошибки.

С этими включенными параметрами, игра создаст новую директорию в “...\My Documents\My Games\Skyrim\Logs\Script”. (''Если вы не видите папку Script, возможно нужно запустить игру ещё разок'') Ваши логи появится внутри этой директории, с именем ''Papyrus.#.log'', где # это номер от 0 до 3. Лог с номером 0 всегда является новейшим, в то время как более старые имеют цифры в порядке возрастания, и эти цифры обновляются в цикле, для перезаписи новых логов.

Теперь игра должна выводить некоторую базовую информацию, а также любые ошибки и отслеживание инструкций в файл Papyrus.0.log, когда игра запущена, так что у вас есть возможность следить за ним, используя любимый текстовый редактор.

Если игра обнаруживает ошибку в скрипте, то выведет её в следующем формате:
<source lang="papyrus">

<timestamp> <error message>
stack:
  <function 0> - "<filename>" Line <line number>
  <function 1> - "<filename>" Line <line number>
  <function 2> - "<filename>" Line <line number>
  ...
</source>

Function 0 - the one at the “top” of the stack list - is the function that caused or reported the error. Function 1 is the function that called Function 0. Function 2 called Function 1, and so on. This will help you track down what might be the cause of any issues that are reported.

But maybe you don’t see any errors. What do you do then? Well, you can take advantage of various Debug functions, for example Trace and TraceStack, to help figure out what your script is doing, and what values your various variables or properties have. For an example, take a look at the following function:
<source lang="papyrus">
Function MyFunction(int coolValue)
  Debug.Trace("My function called! Coolvalue = " + coolValue)
  If (coolValue == 20)
        Debug.Trace("Cool value is 20! Doing some neat stuff now!")
        ; Do neat stuff!
  EndIf
EndFunction
</source>
Once you’ve added trace statements to your function, you can now look at your log to try to pin down what is going wrong. Do you never see “My function called!” in the log? Then whatever is supposed to call your function isn’t happening, so you’ll have to keep looking. Do you see that line but you don’t see “Cool value is 20!”? Then you’ll have to figure out why the value isn’t what you wanted it to be. And you’ll note that in the example, we actually trace out the value of the variable by simply “concatenating” it with the “+” operator.

Skyrim also includes [[:Category:Console_Commands|console commands]] that can help you track down what might be the problem. If your script is attached to a quest, type in “'''[[ShowQuestVars|sqv <quest>]]'''” into the console to get a list of every Papyrus script attached to the quest, and the contents of all its variables and properties. If your script is attached to a reference, target the reference with your mouse while the console is up (or use the “'''[[PickRefByID|prid <reference id>]]'''” command) and then type in “'''[[ShowVars|sv]]'''” to see the same amount of information, but for the reference. (PgUp and PgDown scroll the console output!) If your script is supposed to be registered for update events, type in “dpu” to have the game dump a list of every single updating form to the Papyrus log so you can see if your script is there. Or, if you think your script might actually be stuck inside an infinite while loop, or taking a while to respond, “dps” will dump everything Papyrus is currently doing to the log for your analysis.

===Мой скрипт не компилируется, а все, что я использую - это Editor ID!===
[[Переменные и Свойства|Свойства]]. Вот что вам нужно использовать. Почитайте о них.

===Мой мод у меня работает, но не у всех остальных!===
That sounds like a packaging problem. Consider the following:
*'''Did you accidentally leave out any meshes or textures?''' Textures might not cause an outright crash, but will definitely make things look weird (i.e. purple). Missing meshes may lead to graphical anomalities or outright crashes. Check also that the paths in your meshes are relative, not absolute (If you see "program files" or something in your textures, then something is wrong).
*'''Are you using a custom script that extends another custom script?''' There is a bug[http://forums.bethsoft.com/topic/1347451-serious-flaw-with-the-packaging-algorithm-for-bsa-creation/] in the .bsa packager where if the parent custom script is not actually present in a base form in the game, then it will not be listed in the file selector for the packager. The solution is to create a dummy mesh that has the parent script attached, or manually include it in the .bsa on build.

===У меня есть объект типа Actor (или какой-то ещё) и я не могу запустить на нем функцию. I'm getting the reference for this object from another function.===
Try [[Cast Reference|casting]] the object reference that you're returning from the function. E.g.
<source lang="papyrus">
(GetLinkedRef() as Actor).IsInFaction(BanditFaction)
</source>

==Предметы==

===Не могу удалить предмет у игрока===
*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, и я уверен, что скрипт работает правильно===
*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]].

==Создание объектов==

=== Не могу создать новый объект ===
*Проблема: Не могу создать новый объект.
*Разъяснение: Papyrus currently does not support the instantiation of objects within script; the '''new''' keyword only works for arrays, not objects (unlike Java, for example), and constructors do not seem to work.
*Решение: For a workaround, you could try casting a PlaceAtMe ObjectReference as your desired object. Of course your object must extend ObjectReference for this to work.

=== Can't cast an object as its child ===
*Problem: I can't cast an object as its child. For instance, casting an ObjectReference as a TestReference when TestReference extends ObjectReference.
*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.

==Квесты==

===I can't get my alias to point to a reference ===
*Several possibilities here:
**'''The reference doesn't actually exist.''' Did you make sure that a PlaceAtMe command actually generated a reference? Check using Debug.Trace(theReference).
**'''An alias is pointing to an object in a container.''' Evidently this does not work (creating a persistent reference using PlaceAtMe, and pointing the alias to the persistent reference). Solution: don't put the object in the container, or point to the container and get the object that way (not completely tested).
**'''You created an alias for a quest that is already running (i.e. dirty save)''' - even if you are simply adding an additional alias to an already running quest, you can't get the alias to actually point to anything (despite the fact that Debug.Trace happily shows that it exists, which is horribly misleading). Solution is to make a clean save and remove the quest, then add it back. Simply removing the quest via console and adding it back may also work (''unverified'').

===Не могу добавить свойство в script fragment! ===
*You need to define the property through the Properties window '''for a script fragment''' before it can work in the script. To do this:
**Remove all references of the property from your script and compile. Use a blank script if you need to:
<source lang="papyrus">
;comment
</source> 
**Make sure to '''Compile''' the script. No message box should pop up. Close and re-open the quest/dialogue window.
**'''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.

[[Category:Papyrus]]
[[Category:Решения]]