Runtime Log Monitoring (h2) - Revision history

AFRLme at 14:41, 5 August 2016

2016-08-05T14:41:12Z

AFRLme at 17:30, 21 July 2015

2015-07-21T17:30:23Z

AFRLme at 17:26, 21 July 2015

2015-07-21T17:26:28Z

AFRLme at 17:23, 21 July 2015

2015-07-21T17:23:53Z

AFRLme at 15:41, 21 July 2015

2015-07-21T15:41:47Z

AFRLme at 15:37, 21 July 2015

2015-07-21T15:37:30Z

AFRLme: Created page with "{| class="ts" style="width:100%" |- ! style="text-align:left" | Name !! style="text-align:left;width:10%" | By |- | Runtime Log Monitoring (auto-update) || AFRLme |} This ti..."

2015-07-21T14:46:52Z

Created page with "{| class="ts" style="width:100%" |- ! style="text-align:left" | Name !! style="text-align:left;width:10%" | By |- | Runtime Log Monitoring (auto-update) || AFRLme |} This ti..."

New page

{| class="ts" style="width:100%"
|-
! style="text-align:left" | Name !! style="text-align:left;width:10%" | By
|-
| Runtime Log Monitoring (auto-update) || AFRLme
|}

This tip shows you how to setup real-time automatic log updates, so that you don't have to keep typing '''PRINT LOG''' into the developers console or opening & closing the '''messages.log''' file each time you want to check for new log messages, errors & warnings, which is extremely useful for developers working on scripting a new feature or debugging their games. ''This tutorial is for Windows. I'm sure there are some mac alternatives for Snaketail available. Essentially it's just an app that mirrors the -tail command for Linux machines.''

{| class="ts"
|-
| ''I tried a few other apps including the silent update function of Notepad++, but none of the other programs wanted to run silently in the background. They needed the application window to be active (selected) in order to update the data retrieved from any linked log files, which wasn't much different to opening & closing the log files manually or using the print log command in the developer console.''
|}

== Tutorial ==
1. First things first, you should make sure the log level for Visionaire Studio is set to '''info'''. To do this go to ''extras > options > player: set log level to info.'' The info setting will print out errors, warnings & messages generated by the print() command.

[[File:rtlog_01.png|400px]]

2. Next you are going to need to download Snaketail from [[https://github.com/snakefoot/snaketail-net/releases/latest here]]. Snaketail is an open source app for windows that emulates the -tail command of Linux. In other words it will automatically update any txt / log files you open automatically on file change or after every x amount of time.

[[File:rtlog_01.png|400px]]

3. And now we need a script, that plays our sounds depending on the underground. We add a new script (type '''Called by other action''' again) with the name '''footsteps'''. In this script we call the corresponding script to the current underground...

[[File:footsteps_4-v2.png|800px]]

4. Now we have to trigger the '''footsteps''' script every time our character touches the ground. We go to the walk animation, select one of the '''contact''' (this being the frame which should trigger a footstep sound) frames and call the action '''footsteps''' inside of the frame...

[[File:footsteps_5.png|800px]]

5. Repeat step 4 for each walk direction of the character. Repeat steps 1 to 4 for any characters you want to apply dynamic footstep sounds to.

== Resources ==
{| class="ts"
|-
! style="text-align:left" | Name !! style="text-align:left" | Description
|-
| ''n/a'' || ...
|}{{toc}}

@@ Line 26: / Line 26: @@
 {| class="ts"
 |-
-| '' To find the localAppDir where your projects save game files & log messages are stored, you should run your game through the editor. Press TAB on your keyboard to open up the developer console & then type: '''exec print( localAppDir )'''. Press '''enter''', then type '''PRINT LOG''', then press enter again to show the log. Navigate through the log pages using PAGE UP & DOWN keys on your keyboard & look for a line containing something like c:/users/... & that will be where the localAppDir for your game is located.''
+| '' To find the '''localAppDir''' where your projects save game files & log messages are stored, you should run your game through the editor. Press '''TAB''' on your keyboard to open up the developer console & then type: '''exec print( localAppDir )'''. Press '''enter''', then type '''PRINT LOG''', then press '''enter''' again to show the log. Navigate through the log pages using the '''PAGE UP''' & '''PAGE DOWN''' keys on your keyboard & look for a line containing something like '''c:/users/...''' & that will be where the '''localAppDir''' for your game is located.''
 |}

@@ Line 18: / Line 18: @@
 [[File:rtlog_01.png|400px]]
 a. Next you are going to need to download Snaketail from [https://github.com/snakefoot/snaketail-net/releases/latest here]. Snaketail is an open source app for windows that emulates the -tail command of Linux. In other words it will automatically update any txt / log files you open automatically on file change or after every x amount of time.
@@ Line 25: / Line 26: @@
 {| class="ts"
 |-
-| '' To find the localAppDir where your projects save game files & log messages are stored, you should run your game through the editor. Press TAB on your keyboard to open up the developer console & then type...''
+| '' To find the localAppDir where your projects save game files & log messages are stored, you should run your game through the editor. Press TAB on your keyboard to open up the developer console & then type: '''exec print( localAppDir )'''. Press '''enter''', then type '''PRINT LOG''', then press enter again to show the log. Navigate through the log pages using PAGE UP & DOWN keys on your keyboard & look for a line containing something like c:/users/... & that will be where the localAppDir for your game is located.''
 |}
 [[File:rtlog_02.png|800px]]
 . To display both files at the same time you should use either: the '''Tile windows horizontally''' or the '''Tile windows vertically''' options found under the '''Windows''' menu. Once done you should have something like this...
 [[File:rtlog_03.png|800px]]
 . Snaketail does not automatically remember the last session when you open it. The simplest method for getting it to remember the last session is to use '''Save session''', '''load session''' & '''recent files''' in the '''File''' menu.

@@ Line 19: / Line 19: @@
 [[File:rtlog_01.png|400px]]
-a. Next you are going to need to download Snaketail from [[https://github.com/snakefoot/snaketail-net/releases/latest here]]. Snaketail is an open source app for windows that emulates the -tail command of Linux. In other words it will automatically update any txt / log files you open automatically on file change or after every x amount of time.
+a. Next you are going to need to download Snaketail from [https://github.com/snakefoot/snaketail-net/releases/latest here]. Snaketail is an open source app for windows that emulates the -tail command of Linux. In other words it will automatically update any txt / log files you open automatically on file change or after every x amount of time.
 b. Once you have downloaded & extracted or installed whichever version of Snaketail you need (x64, x86, portable), open it. Next we need to locate two files; one being the log file for the Visionaire Studio editor (viseditor.log) & the other being the log file associated with the project you are currently working on (messages.log). These two files will update you on various issues generated by the editor (development) or the player (runtime). Both files are located somewhere in c:/users/username/appdata/local/... Once done you will end up with 2 tabs.

@@ Line 4: / Line 4: @@
 |-
 | Runtime Log Monitoring (auto-update) || AFRLme
-|}
+|}{{AFRLme_Patreon}}
 This tip shows you how to setup real-time automatic log updates, so that you don't have to keep typing '''PRINT LOG''' into the developers console or opening & closing the '''messages.log''' file each time you want to check for new log messages, errors & warnings, which is extremely useful for developers working on scripting a new feature or debugging their games. ''This tutorial is for Windows. I'm sure there are some mac alternatives for Snaketail available. Essentially it's just an app that mirrors the -tail command for Linux machines.''

@@ Line 48: / Line 48: @@
 ! style="text-align:left" | Name !! style="text-align:left" | Description
 |-
-| ''n/a'' || ...
+| [https://github.com/snakefoot/snaketail-net/releases/latest Snaketail] || The application that we will be using to monitor the messages.log & viseditor.log files.
 |}{{toc}}