Как использовать это руководство.
Если вы новичок в создании скриптов, вам следует начать с чтения этого вступления, и главное, с тщательной проработки обучающего курса.
Это моя самая удачная попытка объяснить по-простому, что такое скрипты, что они делают, и как их создавать.
Во-вторых, это руководство, справочник.
Его основу составляет описание доступных функций.
Эта часть написана не для начинающих, - предполагается, что вы уже овладели основами в создании скриптов.
Вместе с тем я постарался предоставить как можно больше информации, объяснений и примеров, чего недостает в оригинальном файле справки, что должно облегчить вам правильное использование функций в своих скриптах. Пользуйтесь предметным указателем в конце руководства для поиска материала по конкретным функциям.
Или можно обратиться к содержанию, чтобы отыскать нужную функцию для конкретной задачи.
Если вы столкнулись с ошибками или багами, раздел Решения проблем может вам помочь.
И, наконец, в Приложении вы найдете некоторые данные, которыми можно пользоваться как справкой.
И, наконец, убедительная просьба: не принимайте написанное здесь за евангелие.
Информация, собранная в данном руководстве, представляет собой самые глубокие из моих познаний в сочетании с опытом различных форумов, но это никак не исключает наличия ошибок, упущений и т.д.
Например, если я пишу, что данная функция не принимает переменные в качестве аргументов, значит, вероятно, не принимает.
Но если это важно для вашего мода, все равно проверьте сами.
Ведь положение дел с этой функцией могло измениться вместе с последним патчем, или, может быть, просто никто не проверял данное утверждение до вас.
Так что экспериментируйте, и если найдете что-то новое, дайте мне знать, - я добавлю это в будущий апдейт.
От себя заметим, что "устаревших мнение" и некоторых ошибок, здесь хватает.
А что удручает, за 20 лет, никто так и не удосужился все это поправить, или переписать за ново, согласно уже устоявшимся данным.
МСФД 9
Introduction
Using this guide.
If you are new to scripting, you should probably start by reading this introduction and especially do the tutorial. It is my best attempt at explaining scripts, what they do, and how to program one, in simple terms.
Secondly this is a manual, a reference, a handbook. The bulk of this document is a documentation of the available functions. This part is not written for the beginner, you are expected to know the basics of scripting already. I have however tried to provide a lot more info, explanations and sample scripts than the original helpfile, to make it easier to use these functions correctly in your scripts. Use the index at the end of the document to find info on a specific function, or the table of contents to find functions related to a general area of interest. If you run into errors, the Troubleshooting section may help you a bit. In the Appendix you find lists that may also come in handy as a reference.
Thirdly, as an advanced scripter you may find the Tips and Tricks section interesting that covers both basic advice and advanced scripting techniques.
Finally a word of advice: don't take what's written here as gospel. The info in this guide represents the best of my knowledge and forum wisdom, but that doesn't mean that there aren’t mistakes and oversights, etc. E.g. if I write that a function doesn't take variables as arguments it probably doesn't – but if it is important for your mod, by all means try anyway. It may have changed with a patch or maybe simply nobody checked before. So run a test, and if you find something new, let me know, and I will add the info in a possible future update.
