Scripting Tutorial: My First Script
This article has been bylined by a contributor. Current rules do not allow bylines in mainspace articles, but articles written before August 2007 may have been bylined prior to the rules. If you are the original author, please comment on this in the Talk page.
If you are not the bylined author, please treat this article with respect. While this is a Wiki and this article is considered open for editing, courtesy is expected. If at all possible, please contact the bylined author about any changes you would like to make.
As always, see the Edit History to see who has contributed to the page, and use the Talk page if you have any questions regarding its content.
This is a short tutorial which will give you a quick walkthrough for making your first script. It will detail step-by-step the script making process and should take a total of about 5-10 minutes.
So let's get started:
- Open The Elder Scrolls Construction Set.
- Go to File --> Data and a window will pop up. Double click Oblivion.esm to check it and click OK. (Then wait for it to load.)
- In the Object Window, navigate through and find Lockpicks. You'll find this under Items --> Misc Item. (If you don't have a lockpick, any common item will work, like an apple or something.) Double click the item.
- A window will pop up with the item's properties. Where it says Script: NONE, click the 3 little dots next to it. This will open the Script Editor.
- Go to Script --> New, to start a new script.
- Cut and paste the following:
- ScriptName HelloWorld
- Begin OnAdd
- Message "Hello World!", 10
- end
- Info about the script itself:
- - The first line is the name of your script. Make sure it is unique.
- - "Begin OnAdd" means that this script will fire each time you pick up this item. The end command ends the section of script related to "OnAdd". You can have a separate begin/end block for every blocktype - see Begin
- - And lastly, the message line controls what will be displayed, with the "10" as how long the message will stay on screen. Check here for more info about the message command: Message
- ScriptName HelloWorld
- Save the script and then close the Script Editor and the subject's(In this case, the lockpick's) property window, your script will not appear until this is done.
- Go back to the item properties and "HelloWorld" should appear as an option in the dropdown menu for Scripts. (You may have to close the item properties window and re-open it for the HelloWorld script to appear in the dropdown menu.)
- Hit ok to save and close the window.
- Go up to the top and hit File --> Save; name it HelloWorld (it will be an esp file, HelloWorld.esp)
- Open the Oblivion start menu (the splash screen), and click on Data Files.
- Double click on your HelloWorld.esp to check / enable it and click ok to save and close.
- Now go into the game and you should be set! Drop a lockpick on the ground and pick it back up and a message should say "Hello World!". And with that, welcome to scripting!
-Page by Tyrrael, and some helpful people: TitusFrost, Mmmpld, Tellin, Talith, Kyne, Mojo892, Elster
For a more advanced scripting tutorial, see My Second Script.