- Quick reference
- Add ‘scripting superpowers’ to your other applications
Even though the SkookumIDE is a GUI program it can be run with command-line arguments. In this way the command prompt and other applications such as Microsoft Visual Studio or Your Favourite EditorTM can communicate with the SkookumIDE. This can enable other applications to send script commands to a running game or world editor – giving the apps scripting superpowers.
Arguments can be sent to the SkookumIDE on its start-up or when it is already running. If it is already running, any call to a second instance of the IDE will pass any command-line arguments to the already-running IDE, shut down and then the already-running IDE will run the arguments.
Single argument: identifier or file/folder path
The IDE can be called with a single identifier or file/path argument, such as dragging a file to SkookumIDE.exe in Windows Explorer:
|Browse to class in SkookumIDE Browser. See the
member file path
|Browse to member in SkookumIDE Browser. See the
|other text file||Execute file contents as a script on the startup Mind object. See the
1 2 3 4 5 6 7 8 9 10 11 12 13 14
C:\Skookum is shorthand for your SkookumIDE plugin folder, such as D:\UnrealEngine\4.15\Engine\Plugins\SkookumScript\SkookumIDE.
The SkookumIDE can also be called with the following switches (options):
member file path
|Browse to specified member (coroutine or method) or class using its qualified name or file/path.|
||Execute specified expression(s) separated with whitespace on the startup
||file path||Execute specified file contents as a script on the startup
||Bring the SkookumIDE to foreground.
(Can be added prior to other switches.)
||Minimize the SkookumIDE on startup.
(Can be added prior to other switches.)
||Displays command-line help|
Here are some example commands to run on the command prompt. The SkookumIDE Log displays the results.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
SkookumIDE command-line prints to the SkookumIDE Log, not the command prompt
Output from running SkookumIDE.exe with command-line arguments will print to the SkookumIDE Log rather than the command prompt. SkookumIDE.exe is a GUI application rather than a console application, so it cannot print to the standard output and its results are not displayed by the command prompt.
Add ‘scripting superpowers’ to your other applications
The fun part of SkookumIDE command-line arguments is hooking up keyboard shortcuts (sometimes called hotkeys) in your other development tools so that they can interact with the scripting system and the running game engine/editor.
Some of the commands that you might want to hook up will help streamline your workflow. For example: since pressing Ctrl+E while editing a file in the SkookumIDE loads up the file in the application associated with the file extension (such as .sk), one keyboard shortcut that is useful is assigning Ctrl+E on the same associated editor to in turn load the file being edited back into the SkookumIDE. This makes it easy to toggle back and forth.
Some examples of game script commands that you could run from a different tool:
- simple or even fairly sophisticated math: turn any text editor into a powerful calculator
- toggle game settings: make it night or day, disable damage, make all the bad guys have low health, toggle mission achievement and completion flags, enable or disable trigger regions
- change the game progression: restart the level, jump to the end of a level
- have the camera orient to or focus on an object of interest
- teleport the player to another location
- teleport an object or character to the player
- create objects: spawn a vehicle, ammo, powerup, etc. near the player
- change stats: give the player limitless health or special abilities
- get a game character to path to an object such as the player
- commands that loop, take time, or display periodic statistics – basically anything you can think of!
Many of these commands could be in the comments above code that you are working on in the game for quick reference or in a handy scratch pad text file of script snippets. Just select it and run it with a key shortcut.
Some of the keyboard shortcuts that we suggest might already be mapped to other commands, in which case feel free to use another keyboard shortcut or replace the current mapping. We suggest adopting a keyboard shortcut standard for your team so when members help each other or swap desks, everyone will have the handy shortcuts that they expect.
Here are some interesting SkookumIDE commands that you can hook into Microsoft Visual Studio with our suggested keyboard shortcuts.
To add some handy script commands in Visual Studio, click the Tools tab, click External Tools…, and then click Add and enter the items in the table below. The Command field should be
\<your SkookumIDE dir>\SkookumIDE.exe.
You can find all the arguments/variables for External Tools here, or you can also click the triangle to the right of Arguments. Initial directory can be left empty. Prompt for arguments should be unchecked. When done, click Apply. You can then move the command up and down as you like – the External Tool order is important when you reference it to give it a keyboard shortcut.
||Skookum Browse File||
||Skookum Browse Selected||
||Skookum Run Selected||
||Skookum Run IDE Selected||
Any new External Tool commands added in this way will automatically be added to the Tools group in the Main Menu of Visual Studio. To run them, have the file open or text selected as needed for the command you want to run, click Tools and select the command.
Here are instructions on how to associate keyboard shortcuts. To find the external tool commands you have added, in the Show commands containing: box type
ExternalCommand. Note that each external command corresponds with its position in the list of external commands as described above.
If you have some favorite keyboard shortcuts for an application not yet listed, and you think that others would like to know about them, please let us know and we may add them to this page.
Switches may use the forward slash
/rather than the dash
SkookumIDE -?is the same as
SkookumIDE /?. Note that a dash must be preceded by a space, (such as
SkookumIDE -?), but a forward slash need not be preceded by a space (