HowTo/Upload a new asset to the DownloadStation

From TrainzOnline
< HowTo(Difference between revisions)
Jump to: navigation, search
m
(Review and update post TS2010 release)
Line 1: Line 1:
 +
The [[Download Station]] and [[Content Manager]] are designed to make it easy to share assets and maps for Trainz.
  
The [[Download Station]] combined with [[Content Manager]] makes it easy to retrieve assets and maps for Trainz. Asset dependencies are gathered automatically when downloading, and installed into your local Trainz installation. Assets with missing dependencies can be frustrating, when they are not included on the Download Station, and we are sure you would understand if we ask that creators upload their assets to assist others to easily find useful models, in one location.
+
[[Content Manager]] and [[Content Creator Plus]] aim to allow content creators to create and upload error free assets for Trainz. In previous builds errors in assets on the download station have created frustration for users. With [[Content Creator Plus]] we now have a utility to eliminate as many errors and problems as possible, and therefore we ask that the following procedures be used.
 
+
 
+
The aim of [[Content Manager]] and [[Content Creator Plus]] is to have fully functional and correct assets in Trainz. Errors in asset files for previous builds have created frustration for users. With [[Content Creator Plus]] we now have a utility to eliminate as many errors and problems as possible, and therefore we ask that the following procedures be used.
+
  
  
Line 9: Line 7:
 
== The Trainz Download Station ==
 
== The Trainz Download Station ==
  
With the introduction of [[Content Manager]], many aspects of the upload process have been changed since the TRS2004 days.
+
With the introduction of [[Content Manager]], many aspects of the upload process have been changed since the [[TRS2004]] days.
 
+
Unlike pre-[[TRS2006]] versions of Trainz, uploading and downloading are now fully encapsulated within the [[Content Manager]] program. Assets no longer need to be manually packaged in order to be uploaded, making the process much simpler.
+
 
+
To upload your content, you must have a valid Planet Auran profile, with a registered version of Trainz. You are also only able to upload your own custom content.
+
  
 +
Unlike pre-[[TRS2006]] versions of Trainz, uploading and downloading are now fully encapsulated within [[Content Manager]]. Assets no longer need to be manually packaged in order to be uploaded, making the process much simpler. To upload your content, you must have a valid Planet Auran profile, with a registered version of Trainz.
  
  
Line 20: Line 15:
 
== Steps to Upload ==
 
== Steps to Upload ==
  
You have completed your masterpiece and would like to share it with the Trainz community. Let's put it on the [[Download Station]].
+
You have completed your masterpiece and would like to share it with the Trainz community. Let's put it on the [[Download Station]].
 
+
  
 
===Verify Content is Error Free===
 
===Verify Content is Error Free===
  
Before uploading your new asset it must be verified and found error-free; a process which is rigorously enforced by the [[Content Manager]] program. This verification occurs automatically during committing into Trainz using [[Content Manager]].  Further checks are applied in the upload process in order to ensure a high standard of quality among download station assets.
+
Before uploading your new asset it must be verified and found error-free; a process which is rigorously enforced by [[Content Manager]]. This verification occurs automatically when committing assets in Trainz and is repeated on the [[Download Station]] server after upload.
  
Faulty assets are marked with a [[Image:Faulty001.jpg]] in [[Content Manager]].
+
Faulty assets are displayed with a [[Image:Faulty001.jpg]] icon in [[Content Manager]].
  
If an asset is faulty, it must be fixed with the [[Content Creator Plus]] program (or manually) and verified as error free before it is able to be uploaded.
+
If an asset is faulty it must be fixed before it is able to be uploaded, this can be done using [[Content Creator Plus]] or by manually editing the asset.
 
+
Fixing faulty content can be quite complex.  Use the error messages in [[Content Manager]] and [[Content Creator Plus]] to correct any errors one by one. The error messages, though a little cryptic, do point to the errors allowing faulty assets to be repaired.  Search the [http://forums.auran.com/trainz/index.php Trainz forum] for help in repairing faults.  Keep in mind that, if you have correctly exported the mesh/s from 3dsMax or Blender, and you have the texture.txt and image files correctly located, [[Content Creator Plus]] should make a config.txt file clear of errors.  
+
  
 +
Fixing faulty content can be quite complex. Use the error messages in [[Content Manager]] and [[Content Creator Plus]] to correct any errors one by one. If you are having trouble search the [http://forums.auran.com/trainz/index.php Trainz forum] for help in repairing faults. Keep in mind that, if you have correctly exported the mesh(s) from 3dsMax or Blender, and you have the texture.txt and image files correctly located, [[Content Creator Plus]] should make a config.txt file clear of errors.
  
 
===Select Content to be Uploaded===
 
===Select Content to be Uploaded===
  
Next, you must select the assets to be uploaded. You needn't select the dependencies of an asset you wish to upload as these will be selected automatically by [[Content Manager]].
+
Once you have created your error free assets you can select them to be uploaded.
  
If some of your dependant content has been created by other authors, or if it is already present on the Download Station it will automatically be removed from your upload list.
+
To add your assets to the upload queue, first select them in the main list. You can use 'Shift' or 'Ctrl' click to select multiple assets. Right click on the selected assets and choose the "Upload" option. This will expand the upload helper and add the items to the list.
 
+
When a user downloads your content, any dependant assets which are present on the Download Station will also be queued for download.
+
 
+
To select for upload, highlight by left clicking on an item. If more than one need selection hold down the Ctrl key and left click. Then right click on one of the selected items, to bring up the contextual menu and select "Upload".  
+
  
 +
[[Content Manager]] may prompt you to automatically add asset dependencies. This is a good idea as missing dependencies can cause much frustration for other Trainz users who download your creations.
  
 
===Begin Uploading===
 
===Begin Uploading===
  
Once you've selected the appropriate assets to be uploaded, clicking the "Upload" button will bring up the Planet Auran License Agreement which details the legal issues regarding uploaded content.
+
Once you've added all the assets you wish to share you are ready to begin the upload. Click the "Upload" button on the upload helper side panel in [[Content Manager]].
 
+
Accepting this agreement will upload your content to the Download Station. On completion of the upload the Planet Auran "Your Content" page will open in your web browser. This page is part of your personal Planet Auran profile and allows you to manage your online content at any time.
+
 
+
You can access this section separately by visiting the Auran website and following the Planet Auran
+
[https://www.auran.com/planetauran/default.htm link].
+
 
+
  
 +
You must agree to the Planet Auran License Agreement before you can upload your assets, this is displayed automatically. Accepting the agreement will upload your content to the Download Station. On completion of the upload the Planet Auran "Your Content" page will open in your default web browser. This page is part of your personal Planet Auran profile and allows you to manage your online content at any time. You can access this page at any time by visiting the [https://www.auran.com/planetauran/default.htm Auran] website and following the links.
  
 
The "Your Content" section is divided into the following areas:  
 
The "Your Content" section is divided into the following areas:  
Line 62: Line 47:
  
  
'''Upload Content:''' You needn't utilize this section as CM2 now handles the entire upload process. It is recommended that you only use CM2 to upload TS2009/10 assets.
+
'''Upload Content:''' You needn't utilize this section as [[Content Manager]] now handles the entire upload process. It is recommended that you only use [[Content Manager]] to upload TS2009/10 assets.
  
  
'''Unprocessed:''' The "unprocessed" section shows the files you have uploaded which have not yet passed through the automated checking process.
+
'''Unprocessed:''' The "Unprocessed" section shows the files you have uploaded which have not yet been approved by Auran.
  
After uploading an asset via CMP you will find it in this section. Any files you upload using CMP will be packed into an "upload.cdp" file automatically. If you upload many files in one instance, they will be compiled into a single file before they are processed online.
+
After uploading an asset you will find it in this section. Any files uploaded using [[Content Manager]] will be packed into a file named "upload.cdp". If you upload multiple files in one instance they will be compiled into a single file before they are processed online.
  
Files are usually processed daily and will remain in this section until they are either verified as valid or rejected. If you have uploaded a file and decide that you no longer wish for it to be processed, you can mark the offending upload as "do not process". The file will remain in this area should you change your mind, and will be purged at the end of the day.
+
If you have uploaded a file and decide you no longer want it to be processed you can mark it as "do not process", but do not dally as uploads are processed quickly and may not remain in this section long.
  
  
'''Preview Area:''' The preview area acts as a temporary `holding bay' for previewing and testing your content before it is submitted for approval. The main features of the Preview Area are as follows:
+
'''Preview Area:''' The preview area acts as a temporary 'holding bay' for previewing and testing your content before it is made available for download. The main features of the Preview Area are as follows:
  
 
''a.'' You can review and approve your own content before the final approval process.
 
''a.'' You can review and approve your own content before the final approval process.
  
''b.'' You can send a link to your content to others for testing purposes. Only you have initial access as the content is not publicly available until you submit the content for approval, and approval is granted.
+
''b.'' You can send the private link to your content to others for testing purposes.
  
''c.'' You can re-check all the Download Station pack information before final approval, i.e. Pack contents, category, obsoletes, descriptions etc.
+
''c.'' You can re-check all the Download Station pack information before final approval, i.e. pack contents, category, obsoletes, descriptions etc.
  
''d.'' You may have multiple revision uploads for assets of the same KUID.
+
''d.'' You may delete the content if you change your mind.
  
''e.'' You may delete the content before it is made publicly available.
 
  
 +
''Important note: Preview Area content is only be held for 4 weeks since it was uploaded. All testing/revision must be done within this time. If you have (say) 4 assets for upload - A locomotive, an engine file, a bogey and a pantograph, and you only update ONE of these assets, the other 3 are still on the original 4 week period.''
  
''Important note: Preview Area content can only be held for 4 weeks since last revision. All testing/revisions must be done within this time.  If you have (say) 4 assets for upload - A locomotive, an engine file, a bogey and a pantograph, and you only update ONE of these assets, the other 3 are still on the original 4 week period.''
 
  
 +
'''Waiting Area:''' The waiting area contains assets which have successfully passed through the automated checks made by the Download Station and are awaiting visual confirmation from internal Auran staff. This is done for a number of reasons, including:
  
'''Waiting Area:''' The waiting area section houses that content which has successfully passed through the automated checks made by the Download Station system and is awaiting visual confirmation from internal Auran staff. This is done for a number of reasons, including:
 
 
- Verifying that the name and description are valid and appropriate
 
- Verifying that the name and description are valid and appropriate
- Verifying that the correct category is selected
 
- Verifying that the thumbnail image is visually acceptable You will receive an email to indicate if your content has been approved or declined. If approved, the content will be available on the Download Station approximately 8 hours after the email is sent.
 
 
 
'''Your Content:''' The "Your Content" section shows your content which is currently available for download on the Trainz Download Station.
 
 
 
 
 
== Download Station Checks ==
 
 
 
If your content fails any of the following checks, the content will be removed and you will be notified:
 
 
* File/s were extracted successfully.
 
 
* Compares the number of files to the number processed.
 
 
* Ensures that the User ID of the content belongs to the user uploading the content.
 
 
* If content was uploaded via a Group member, it checks that the User ID belongs to that Group.
 
 
* That the KUID is valid.
 
 
* Name for minimum length of 3 characters and no swear words.
 
 
* Description is present and free of swear words. If updating content, it checks that the content being updated is the latest version and not a previous version.
 
 
* The Region / Country codes are valid.
 
  
* The Eras are valid.
+
- Verifying that the correct category is selected
  
* Description for maximum length of 2048 characters, if over 2048, description is truncated.
+
- Verifying that the thumbnail image is visually acceptable.
  
* Name for maximum length of 64 characters, if over 64 the name is truncated.
+
You will receive an email to indicate if your content has been approved or declined. If approved, the content should be appear for download in [[Content Manager]] within 24 hours.
  
* Valid thumbnail tags and accompanying image are included.
 
  
* File size is below the maximum. The maximum file size will be stated on the Download Station upload page as this may be subject to revision.
+
'''Your Content:''' The "Your Content" section shows every asset you have previously uploaded to the Download Station.
  
  

Revision as of 02:03, 4 March 2010

The Download Station and Content Manager are designed to make it easy to share assets and maps for Trainz.

Content Manager and Content Creator Plus aim to allow content creators to create and upload error free assets for Trainz. In previous builds errors in assets on the download station have created frustration for users. With Content Creator Plus we now have a utility to eliminate as many errors and problems as possible, and therefore we ask that the following procedures be used.


Contents

The Trainz Download Station

With the introduction of Content Manager, many aspects of the upload process have been changed since the TRS2004 days.

Unlike pre-TRS2006 versions of Trainz, uploading and downloading are now fully encapsulated within Content Manager. Assets no longer need to be manually packaged in order to be uploaded, making the process much simpler. To upload your content, you must have a valid Planet Auran profile, with a registered version of Trainz.


Steps to Upload

You have completed your masterpiece and would like to share it with the Trainz community. Let's put it on the Download Station.

Verify Content is Error Free

Before uploading your new asset it must be verified and found error-free; a process which is rigorously enforced by Content Manager. This verification occurs automatically when committing assets in Trainz and is repeated on the Download Station server after upload.

Faulty assets are displayed with a Faulty001.jpg icon in Content Manager.

If an asset is faulty it must be fixed before it is able to be uploaded, this can be done using Content Creator Plus or by manually editing the asset.

Fixing faulty content can be quite complex. Use the error messages in Content Manager and Content Creator Plus to correct any errors one by one. If you are having trouble search the Trainz forum for help in repairing faults. Keep in mind that, if you have correctly exported the mesh(s) from 3dsMax or Blender, and you have the texture.txt and image files correctly located, Content Creator Plus should make a config.txt file clear of errors.

Select Content to be Uploaded

Once you have created your error free assets you can select them to be uploaded.

To add your assets to the upload queue, first select them in the main list. You can use 'Shift' or 'Ctrl' click to select multiple assets. Right click on the selected assets and choose the "Upload" option. This will expand the upload helper and add the items to the list.

Content Manager may prompt you to automatically add asset dependencies. This is a good idea as missing dependencies can cause much frustration for other Trainz users who download your creations.

Begin Uploading

Once you've added all the assets you wish to share you are ready to begin the upload. Click the "Upload" button on the upload helper side panel in Content Manager.

You must agree to the Planet Auran License Agreement before you can upload your assets, this is displayed automatically. Accepting the agreement will upload your content to the Download Station. On completion of the upload the Planet Auran "Your Content" page will open in your default web browser. This page is part of your personal Planet Auran profile and allows you to manage your online content at any time. You can access this page at any time by visiting the Auran website and following the links.

The "Your Content" section is divided into the following areas:

My content001.jpg


Upload Content: You needn't utilize this section as Content Manager now handles the entire upload process. It is recommended that you only use Content Manager to upload TS2009/10 assets.


Unprocessed: The "Unprocessed" section shows the files you have uploaded which have not yet been approved by Auran.

After uploading an asset you will find it in this section. Any files uploaded using Content Manager will be packed into a file named "upload.cdp". If you upload multiple files in one instance they will be compiled into a single file before they are processed online.

If you have uploaded a file and decide you no longer want it to be processed you can mark it as "do not process", but do not dally as uploads are processed quickly and may not remain in this section long.


Preview Area: The preview area acts as a temporary 'holding bay' for previewing and testing your content before it is made available for download. The main features of the Preview Area are as follows:

a. You can review and approve your own content before the final approval process.

b. You can send the private link to your content to others for testing purposes.

c. You can re-check all the Download Station pack information before final approval, i.e. pack contents, category, obsoletes, descriptions etc.

d. You may delete the content if you change your mind.


Important note: Preview Area content is only be held for 4 weeks since it was uploaded. All testing/revision must be done within this time. If you have (say) 4 assets for upload - A locomotive, an engine file, a bogey and a pantograph, and you only update ONE of these assets, the other 3 are still on the original 4 week period.


Waiting Area: The waiting area contains assets which have successfully passed through the automated checks made by the Download Station and are awaiting visual confirmation from internal Auran staff. This is done for a number of reasons, including:

- Verifying that the name and description are valid and appropriate

- Verifying that the correct category is selected

- Verifying that the thumbnail image is visually acceptable.

You will receive an email to indicate if your content has been approved or declined. If approved, the content should be appear for download in Content Manager within 24 hours.


Your Content: The "Your Content" section shows every asset you have previously uploaded to the Download Station.


Return to How To Index

HowToGuides

Personal tools