Help:Moving Content - Revision history

Capdiamont: Updated Mac instructions for Trains 2019 and 2022

2022-10-01T18:31:00Z

Updated Mac instructions for Trains 2019 and 2022

← Older revision		Revision as of 18:31, 1 October 2022
Line 17:		Line 17:

	==Mac OS X==		==Mac OS X==
	In Mac OS X, the local data folder is stored by default at a subfolder of "/Users/<username>/Library/Containers/com.n3vgames.tane" (where "<username>" is the username of the logged-in Mac OS X user account.)		In Mac OS X, the local data folder is stored by default at a subfolder of "/Users/<username>/Library/Containers/com.n3vgames.tane" (where "<username>" is the username of the logged-in Mac OS X user account.) Trainz 2019 uses trs19 instead of tane. Similarly Trainz 2022 uses trs22 for the folder name.

	You may access this location in Finder by using "Go To" (command-shift-G) and then entering the address "~/Library/Containers/com.n3vgames.tane/Data". At this location you will see one or more local data folders, corresponding with your various Trainz installations. The name of each folder here includes a random character string which has no meaning but simply allows for multiple installs to coexist without overwriting each other's data files.		You may access this location in Finder by using "Go To" (command-shift-G) and then entering the address "~/Library/Containers/com.n3vgames.tane/Data". At this location you will see one or more local data folders, corresponding with your various Trainz installations. The name of each folder here includes a random character string which has no meaning but simply allows for multiple installs to coexist without overwriting each other's data files.

Zikchil: /* Creating a New Local Data Folder */

2020-05-20T16:20:25Z

Creating a New Local Data Folder

← Older revision		Revision as of 16:20, 20 May 2020
Line 74:		Line 74:
	#:*...the default path is C:\Users\<username>\AppData\Local\N3V Games\<version>\build folder		#:*...the default path is C:\Users\<username>\AppData\Local\N3V Games\<version>\build folder
	#::*The default build folder uses an alphanumeric system generated name. The next steps are important to make sure you are looking at the correct folder if you have more than one		#::*The default build folder uses an alphanumeric system generated name. The next steps are important to make sure you are looking at the correct folder if you have more than one
	#Highlight the full path and use ~~Ctrl-~~C to copy it.		#Highlight the full path and use CTRL+C to copy it.
	#Open Windows Explorer and paste the path into the Explorer address dropdown (usually opens to "this PC")		#Open Windows Explorer and paste (CTRL+V) the path into the Explorer address dropdown (usually opens to "this PC")
	#:*Key-press <Enter>.		#:*Key-press <Enter>.
	#:*You are now in your games current data directory.		#:*You are now in your games current data directory.

Zikchil: /* Creating a New Local Data Folder */

2019-08-19T21:41:30Z

Creating a New Local Data Folder

← Older revision		Revision as of 21:41, 19 August 2019
Line 74:		Line 74:
	#:*...the default path is C:\Users\<username>\AppData\Local\N3V Games\<version>\build folder		#:*...the default path is C:\Users\<username>\AppData\Local\N3V Games\<version>\build folder
	#::*The default build folder uses an alphanumeric system generated name. The next steps are important to make sure you are looking at the correct folder if you have more than one		#::*The default build folder uses an alphanumeric system generated name. The next steps are important to make sure you are looking at the correct folder if you have more than one
	# Highlight the full path and use Ctrl-C to copy it.		#Highlight the full path and use Ctrl-C to copy it.
	# Open Windows Explorer and paste the path into the Explorer address dropdown (usually opens to "this PC")		#Open Windows Explorer and paste the path into the Explorer address dropdown (usually opens to "this PC")
	#:* Key-press <Enter>.		#:*Key-press <Enter>.
	#:* You are now in your games current data directory.		#:*You are now in your games current data directory.
	# Navigate up one directory level (you can use the little "up arrow" on the left of of the address dropdown)		#Navigate up one directory level (you can use the little "up arrow" on the left of of the address dropdown)
	# Create a new folder and give it a name		#Create a new folder and give it a name
	# Now double-click into this new folder (it will be empty), and copy the path just like you did in the above step #2.		#Now double-click into this new folder (it will be empty), and copy the path just like you did in the above step #2.
	# Now go back to Launcher > Trainz Settings > Install tab, paste the new path, replacing the current path, in the "Local Data Folder" field		#Now go back to Launcher > Trainz Settings > Install tab, paste the new path, replacing the current path, in the "Local Data Folder" field
	# Close the Trainz Settings form (a message will appear saying the game needs a restart, click OK, then close the Launcher too)		#Close the Trainz Settings form (a message will appear saying the game needs a restart, click OK, then close the Launcher too)
	# Restart the game. A few things will happen		#Restart the game. A few things will happen
			#:*...(if TRS19), you'll see the "Trainz Performance Configuration" dialog. you can select an option or click "Skip..." on the lower right.
	#:*...in Explorer you'll see the folder get populated with some new sub-folders and files.		#:*...in Explorer you'll see the folder get populated with some new sub-folders and files.
	~~#:*...the "Trainz Performance Configuration" form will open (you can set these parameter here\now or skip is and do it later on the Performance tab)~~
	#:*...you'll need to provide your user name\password in Trainz Settings > Internet (tab)		#:*...you'll need to provide your user name\password in Trainz Settings > Internet (tab)
	# Click Start Trainz and complete the database build		#Click Start Trainz and complete the database build. Now your game is pointing to a "clean data directory".

	* Now your application is pointing to a "clean data directory".		NOTES:
			*This process does not copy any of your local content across, this mirrors a first time installation with built-in content only. You may hear this referred to as "baseline".
	~~NOTE~~:		*This is applicable to TANE & TRS19 (minus the performance config), and may be used to easily swap between testing & working folders.
	* This process does not copy any of your local content across.
	* This ~~process~~ is applicable to ~~both~~ TANE and TRS19		Return to [[Help:TRS19\|TRS19 Help Page]]<br>
			Additional Info: [[Help:Importing Content\|Importing Content]]

	~~Return to [[Help:TRS19\|TRS19 Help Page]]~~
	[[Category:TRS19]]		[[Category:TRS19]]
	[[Category: Help]]		[[Category: Help]]

	~~Additional Info: [[Help:Importing Content\|Importing Content]]~~

Zikchil: /* Creating a New Local Data Folder */

2019-08-02T15:56:01Z

Creating a New Local Data Folder

← Older revision		Revision as of 15:56, 2 August 2019
Line 98:		Line 98:
	[[Category:TRS19]]		[[Category:TRS19]]
	[[Category: Help]]		[[Category: Help]]

			Additional Info: [[Help:Importing Content\|Importing Content]]

Zikchil: /* Creating a New Local Data Folder */

2018-11-26T20:39:50Z

Creating a New Local Data Folder

← Older revision		Revision as of 20:39, 26 November 2018
Line 70:		Line 70:
	Sometimes your Local Data Folder can end up with corrupt data. In this case, the solution is to create a new folder which contains no 3rd party content. From there, you can then IMPORT your old content and work out which items may be causing issues.		Sometimes your Local Data Folder can end up with corrupt data. In this case, the solution is to create a new folder which contains no 3rd party content. From there, you can then IMPORT your old content and work out which items may be causing issues.

	* Open the Launcher > Install tab ~~and check~~ the ~~path to your~~ Local Data Folder. ~~The~~ default path is C:\Users\<username>\AppData\Local\N3V Games\~~TANE~~\build ~~xxxxxxxx~~		# Open the Launcher > Trainz Settings > Install (tab).
	* Highlight the full path ~~name~~ and use Ctrl-C to copy		#:*...see the "Local Data Folder" field, this is the path for your game data.
	* Close TANE (~~and check in Task Manager that it has ended -~~ this ~~may take a few minutes in some circumstances~~)		#:*...the default path is C:\Users\<username>\AppData\Local\N3V Games\<version>\build folder
	* ~~Use Crtl~~-~~V to paste the path into Windows Explorer~~		#::*The default build folder uses an alphanumeric system generated name. The next steps are important to make sure you are looking at the correct folder if you have more than one
	* Go up one directory level ~~and rename~~ the ~~folder by adding~~ "~~-old~~" to the ~~name (this effectively creates a backup for you~~)		# Highlight the full path and use Ctrl-C to copy it.
	* Open a ~~NEW Windows Explorer window~~ and ~~create~~ a ~~Folder~~ in the ~~desired location (e.g~~. ~~D:\TANE_data)~~		# Open Windows Explorer and paste the path into the Explorer address dropdown (usually opens to "this PC")
	* Open Launcher > Trainz Settings > Install tab ~~and browse to find your~~ new ~~folder (D:\TANE_data) then click Select~~ Folder		#:* Key-press <Enter>.
	* Close ~~TANE~~ (a message will appear saying the game needs a restart)		#:* You are now in your games current data directory.
	* ~~Restart TANE~~ and ~~check your Install path~~ is ~~pointing to~~ the ~~new location~~.		# Navigate up one directory level (you can use the little "up arrow" on the left of of the address dropdown)
	* Click Start Trainz and ~~wait for TANE to~~ complete a database ~~rebuild (this should only take a few minutes)~~		# Create a new folder and give it a name
			# Now double-click into this new folder (it will be empty), and copy the path just like you did in the above step #2.
			# Now go back to Launcher > Trainz Settings > Install tab, paste the new path, replacing the current path, in the "Local Data Folder" field
			# Close the Trainz Settings form (a message will appear saying the game needs a restart, click OK, then close the Launcher too)
			# Restart the game. A few things will happen
			#:*...in Explorer you'll see the folder get populated with some new sub-folders and files.
			#:*...the "Trainz Performance Configuration" form will open (you can set these parameter here\now or skip is and do it later on the Performance tab)
			#:*...you'll need to provide your user name\password in Trainz Settings > Internet (tab)
			# Click Start Trainz and complete the database build

	Now your ~~TANE install points~~ to ~~the new Local Data Folder at the new location~~.		* Now your application is pointing to a "clean data directory".
	NOTE: This process does not copy any of your local content across.
			NOTE:
			* This process does not copy any of your local content across.
			* This process is applicable to both TANE and TRS19

	Return to [[Help:TRS19\|TRS19 Help Page]]		Return to [[Help:TRS19\|TRS19 Help Page]]
	[[Category:TRS19]]		[[Category:TRS19]]
	[[Category: Help]]		[[Category: Help]]

S301 at 04:54, 24 July 2018

2018-07-24T04:54:54Z

← Older revision		Revision as of 04:54, 24 July 2018
Line 83:		Line 83:
	Now your TANE install points to the new Local Data Folder at the new location.		Now your TANE install points to the new Local Data Folder at the new location.
	NOTE: This process does not copy any of your local content across.		NOTE: This process does not copy any of your local content across.

			Return to [[Help:TRS19\|TRS19 Help Page]]
			[[Category:TRS19]]
			[[Category: Help]]

S301 at 05:48, 23 July 2018

2018-07-23T05:48:32Z

← Older revision		Revision as of 05:48, 23 July 2018
Line 1:		Line 1:
	Trainz stores additional content and user settings separately from the Trainz installation folder. A platform-specific default path is used, which can be accessed in your platform-specific file manager as described below. This folder may grow to a substantial size over time. If required, you may specify an alternate location for storing your content.		Trainz stores additional content and user settings separately from the Trainz installation folder. A platform-specific default path is used, which can be accessed in your platform-specific file manager as described below. This folder may grow to a substantial size over time. If required, you may specify an alternate location for storing your content.

	These instructions apply to build 82340 and above.		These instructions apply to TANE build 82340 and above. The same steps can be used for TRS2019, just replace 'TANE' with 'TRS2019' for folder names!

	=Locating your Local Data Folder=		=Locating your Local Data Folder=

Zikchil: /* Copy\Move\Archive your Local Data Folder */

2018-06-04T14:10:16Z

Copy\Move\Archive your Local Data Folder

← Older revision		Revision as of 14:10, 4 June 2018
Line 56:		Line 56:
	* Creates a backup of the "old" content folder and optionally archive\delete the old folder to free up space.		* Creates a backup of the "old" content folder and optionally archive\delete the old folder to free up space.

	~~----~~

	'''WARNING:'''		'''WARNING:'''

Zikchil: /* Moving your Local Data Folder */

2018-03-12T19:30:13Z

Moving your Local Data Folder

← Older revision		Revision as of 19:30, 12 March 2018
Line 25:		Line 25:


	=~~Moving~~ your Local Data Folder=		=Copy\Move\Archive your Local Data Folder=

	* Note the current ~~location of~~ your user content ~~by opening the Launcher~~ > ~~Trainz Settings~~ > ~~Install tab~~		# Open "Launcher > Trainz Settings > Install tab".
	* Open Windows Explorer and create a new empty folder at the desired location (e.g. D:\TANE_Content)		#:* Note the path displayed in the "Local Data Folder" field (this is your current data directory where your user content resides).
	* ~~In the Install tab, click on the "..." button~~ and ~~browse~~ to ~~find~~ your ~~newly created folder~~		#:* <i>Recommended...</i>
	* ~~Click Select~~ Folder ~~to change~~ the ~~path to your new location~~		#::* Highlight and Copy this path to Notepad.
	* ~~Exit~~ the ~~game and close all game windows~~		#::* Verify all other tabs contain the settings you want, including your authentication credentials.<br>
	* In Windows Explorer, ~~move your existing content~~ into the new folder (see below*)		# Open Windows Explorer and navigate to the current data folder (you may paste the path from step 1 to open directly).
	* Start ~~TANE and check~~ the ~~Install tab to confirm that~~ the ~~path has changed and is correct and that everything is working~~.		# Open a second instance of Windows Explorer and create a new empty folder at the desired location (e.g. D:\TANE_Content)
	* If ~~your~~ content is missing, or if a database repair commences, you have made a mistake and will need to re-check the ~~setting~~ above.		#:* Highlight and Copy this new path to your clipboard
	* ~~Move all~~ the ~~files~~ and ~~folders~~ from your ~~original Local Data Folder (from Step 1 above) into~~ your ~~NEW~~ folder ~~created in Step 2~~		#:* Paste this new path into the "Local Data Folder" field
	~~i.e. folders like~~ backup~~, cache, etc plus assets.tdx~~ and ~~keystore.tdx~~.		# Close the Settings dialog
			#:* ...there will be a prompt telling you about restarting, acknowledge it.
			#:* ...close the Launcher
			# Focus on the first instance of Windows Explorer, copy all files\folders here into the new folder (the 2nd instance of Explorer).
			#:* i.e. folders like backup, cache, etc plus assets.tdx and keystore.tdx.
			# Start the launcher
			#:* If you're watching the new directory in Explorer you'll see some changes occur (files added).
			# '''OPTIONAL''' - Access "Trainz Settings".
			#:* All settings verified in step 1 should be present on all tabs.
			# Click "Start Trainz"
			# Application will launch as expected.
			#:* If content is missing, or if a database repair commences, or you're prompted to login, you have made a mistake and will need to re-check the settings above.
			<br>
			'''Benefits of this process...'''
			* Provides a method for you to create data directories using naming conventions easily tracked by humans (as opposed to the machine name Trainz generates for its folders)
			* Allows you to move content between builds and patches without resorting to CDP export\import.
			* Allows you to work independently from your "source content" making changes without risk and...,
			* Point back to your old folder anytime you need a reference or to check "how it worked" before you started modifying content.
			* Creates a backup of the "old" content folder and optionally archive\delete the old folder to free up space.

	~~This process will leave the old content folder empty, and all of your content files under the new folder. You can then delete the old empty folder.~~		----

			'''WARNING:'''
			* DO NOT ever delete the C:\Users\<pc name>\AppData\Local\N3V Games\TANE folder OR the userdata-redirect-map.txt file in that folder.
			:* This file is required by TANE to ensure the Local Data Folder is found.
			:* If the redirect file does not exist, TANE will create a new one and create a new local data folder in the default location and you are back to your starting point.
			<br>
	'''TROUBLESHOOTING:'''		'''TROUBLESHOOTING:'''

	* DO NOT ever delete the C:\Users\<pc name>\AppData\Local\N3V Games\TANE folder OR the userdata-redirect-map.txt file in that folder. This file is required by TANE to ensure the Local Data Folder is found. If the redirect file does not exist, TANE will create a new one and create a new local data folder in the default location and you are back to your starting point.
	* If a new unused /build xxxxxxxx folder is created in the default location upon restarting, you have not followed the steps correctly - please review the steps again.		* If a new unused /build xxxxxxxx folder is created in the default location upon restarting, you have not followed the steps correctly - please review the steps again.
	* If you are asked to enter your username again, you have not followed the steps correctly - please review the steps again.		* If you are asked to enter your username again, you have not followed the steps correctly - please review the steps again.


	=Creating a New Local Data Folder=		=Creating a New Local Data Folder=

Windwalkr at 05:43, 14 June 2016

2016-06-14T05:43:44Z

← Older revision		Revision as of 05:43, 14 June 2016
Line 4:		Line 4:

	=Locating your Local Data Folder=		=Locating your Local Data Folder=

			From the launcher of any Trainz installation, you can click the "Trainz Settings" button and then switch to the "Install" tab to see the full path to that installation's local data folder. You can navigate directly to that path using your system's file manager, however please keep in mind that the parent folders of the default location may be hidden on some systems so simply starting at the top level of your computer and working your way down may not work.

			In order to navigate directly to the local data folder's default location, the following steps can be used:

	==Windows==		==Windows==
Line 11:		Line 15:

	You will also find a text file at this location named "userdata-redirect-map.txt" which lists the correlation between each Trainz installation and its local data folder. While it is possible to hand-edit this file using a program such as WordPad.exe, it is not recommended due to the potential for data loss.		You will also find a text file at this location named "userdata-redirect-map.txt" which lists the correlation between each Trainz installation and its local data folder. While it is possible to hand-edit this file using a program such as WordPad.exe, it is not recommended due to the potential for data loss.


	==Mac OS X==		==Mac OS X==