Basic Commands



In this section you will find a description on how to use the basic commands in your script, but first, let's get an overview of how commands work on ssScriptMaker. Every script you make, will have a command list, and when the script is executed, the commands in its command list will be executed sequentially.



To add a command to your script you first need to go to the Script tab in the main panel. There you will be able to see a panel with all the commands that have been added to your script (It will be empty if you hadn't added any command yet), and another tabbed panel with several buttons on it aligned to the right, that from now on, we are going to call the command panel. In that panel you will find a button for each possible standard command ssScriptMaker offers to you to make your script, sorted by their type in several tabs. In this section we are going to focus on the commands that are in the Basic tab. To add a command to your script, you first need to select where it will be added, selecting a command from your script command list with a mouse click. The new command will be added just under the selected command in the list. If you want to add a command at the end of your script command list, you can either select the last command or select the very last blank line of the list. To add a new command you just need to click on the proper command button in the command panel, and if the chosen command needs some parameters, a new window will be opened with some fields you may fill, then click Ok, and the new command will be added to the list. To edit a command, double-click on it, and to delete a command, select it and press the delete key on your keyboard.



A lot of commands require you to input some text (eg, show message or wait for a button press). In this text fields you can use special characters to refer to things that may change from one execution to another of the command (eg $name will be replaced with the slave's name). To see a full list of the special characters you can use, click here.



When you add some commands (mainly the commands in the condition tab) a block will be opened captioned by that command. You can see the block as a green box on your command list. In this cases, the command that opens the block will refer to a condition, and all the commands you put inside the block will only be executed if the condition referred by the opening block command is met. (For example, if you add a 'if the slave is female' command from the condition tab, a new block will be opened, and all the commands you add inside this block will only execute if the slave running the script is female, and they won't be executed if the slave is male).



Show Message

This command sets the current message shown by SexScripts. You will have a text field labeled message where you can type the new message. This message will be shown until you change it for another message or the script ends. You can also select a wait checkbox for the command to wait a delay giving the slave a time to read the message before you replace the message shown with another show message command. This wait can be expressed in a number of seconds, where you have to fill the seconds to wait; a random time, where you have to express the minimum and the maximum amount of seconds, and the wait will be a random number of seconds between this two values; and wait for the slave to press a button, where you have to type the label of the button. To hide the current shown message simply leave empty the message field and uncheck the wait checkbox.



Wait

This command will wait a delay before the next command is executed. You have to input that delay as a number of seconds. You can also select a checkbox for this command to fill a gauge bar while waiting.



Wait for a button press

This command will show a button for the slave to press it. You can type the label the button will have. Usually this command will wait until the slave presses the button, but you can indicate a timeout as a number of seconds, and this command will wait until the slave presses the button or the timeout has elapsed. You can also check an option to add an 'is late' case, where you have to introduce the threshold in seconds to be late. If this option is selected, this command will open a block that will be executed if the slave doesn't press the button in time.



Show pop-up

This command will launch a pop-up window with some specified message in it and an Ok button, and will wait until the slave presses the Ok button in the pop-up window or closes it. You can also check an option to add an 'is late' case, where you have to introduce the threshold in seconds to be late. If this option is selected, this command will open a block that will be executed if the slave doesn't press the Ok button in the pop-up in time.



Show Image

This command will set the current image to be shown by SexScripts. You usually are going to use an image from your script resources, selecting it from the droplist. But you can select an option to use an image outside your script's resources, where then you will have to indicate the path to the image file relative to the images/ folder of SexScripts. You can use the browse button to easily retrieve that path.



Do not show any image

This command will hide the current image shown by SexScripts and no image will be shown until you show one with the show Image command.



Play Sound

This command will play a sound. You usually are going to use a sound from your script resources, selecting it from the droplist. But you can select an option to use a sound outside your script's resources, where then you will have to indicate the path to the sound file relative to the sounds/ folder of SexScripts. You can use the browse button to easily retrieve that path. Also, you can indicate this command to perform a wait, you can then indicate whether to wait until the sounds ends its playing or wait a specified number of seconds.



Ask a question

This command will ask a question to the slave, with two possible answers that the slave can choose. The answers will be shown in two buttons the slave can click. This command will wait until the slave's chooses an answer. Also this command will open a block that will execute if the slave chooses the first answer, and an else block that will execute if the slave chooses the second answer.



Put a comment

This is not really a command. You can add with this button a comment to your script command list as some text. All comments will be completely ignored by the script when executing, so you can use them to note what is happening in your script at some point in its command list. Comments will be very useful if you're writing a large script and help you to remember for what you put that command there.



Exit Script

This command will terminate the execution of the script. It's not mandatory to put it as the last command of your script, but you can. You can use it also inside some condition block to end the script prematurely if some condition is met.



Restart Script

This command will restart your script from the very beginning. Take care if you're using variables because they won't be saved, it will be a new execution of your script.



return to the contents page