HowTo/Debug Scripts - Revision history

Ek.skirl at 08:49, 15 July 2025

2025-07-15T08:49:18Z

← Older revision		Revision as of 08:49, 15 July 2025
Line 7:		Line 7:
	* Enable display of script exceptions in the Dev tab of the Trainz Settings.		* Enable display of script exceptions in the Dev tab of the Trainz Settings.
	* Restart the game if necessary.		* Restart the game if necessary.
	* Add Interface.Log() statements throughout your code so that you can determine what is being called, and in what order. Log the start of functions and any relevant control flow (if statements, return statements, etc.)		* Add Interface.Log() statements throughout your code so that you can determine what is being called, and in what order.
	* ~~If you start~~ your log texts with a unique sign group you may filter your logs in log window.		* Log the start of functions and any relevant control flow (if statements, return statements, etc.)
			* Start your log texts with a unique sign group. So you may filter your logs in log window.
	* Clear your logs.		* Clear your logs.
	* Launch directly into your session from CM to avoid unnecessary additional log entries.		* Launch directly into your session from CM to avoid unnecessary additional log entries.

Ek.skirl: Adding a hint (unique sign group)

2025-07-15T08:47:32Z

Adding a hint (unique sign group)

← Older revision		Revision as of 08:47, 15 July 2025
Line 8:		Line 8:
	* Restart the game if necessary.		* Restart the game if necessary.
	* Add Interface.Log() statements throughout your code so that you can determine what is being called, and in what order. Log the start of functions and any relevant control flow (if statements, return statements, etc.)		* Add Interface.Log() statements throughout your code so that you can determine what is being called, and in what order. Log the start of functions and any relevant control flow (if statements, return statements, etc.)
			* If you start your log texts with a unique sign group you may filter your logs in log window.
	* Clear your logs.		* Clear your logs.
	* Launch directly into your session from CM to avoid unnecessary additional log entries.		* Launch directly into your session from CM to avoid unnecessary additional log entries.

S301: Created page with "Some recommended steps to help with Debugging custom scripts for TRS19 can be found below: * Configure a minimal test session. * Enable developer mode in the Dev tab of the T..."

2018-09-21T03:47:06Z

Created page with "Some recommended steps to help with Debugging custom scripts for TRS19 can be found below: * Configure a minimal test session. * Enable developer mode in the Dev tab of the T..."

New page

Some recommended steps to help with Debugging custom scripts for TRS19 can be found below:

* Configure a minimal test session.
* Enable developer mode in the Dev tab of the Trainz Settings.
* Enable script logging in the Dev tab of the Trainz Settings.
* Enable script message logging in the Dev tab of the Trainz Settings.
* Enable display of script exceptions in the Dev tab of the Trainz Settings.
* Restart the game if necessary.
* Add Interface.Log() statements throughout your code so that you can determine what is being called, and in what order. Log the start of functions and any relevant control flow (if statements, return statements, etc.)
* Clear your logs.
* Launch directly into your session from CM to avoid unnecessary additional log entries.
* Proceed until the problem occurs (hopefully this is immediate).
* Pause the game.
* Open the logs window.
* Review the output, to see which of your logs have fired off and which messages have been dispatched.

Additionally for TRS19, with "Maximise Compatibility" enabled in the Dev tab of the Trainz Settings, the script environment will generally be very similar to T:ANE SP2/3 and you shouldn't need to make any real changes for.

If you run a route that is setup to run in 'maximise performance' mode (or have TRS19 set to 'maximise performance'), then you may need to make changes to your script. See [[HowTo/Asynchronous_Route_Streaming|Asynchronous Route Streaming]] for further information.