Difference between revisions of "Documentation/Tools/SCS Workshop Uploader/Validation errors and solutions for them"

From SCS Modding Wiki
Jump to navigation Jump to search
(→‎Using SCS files is not allowed for Steam Workshop mods - please use normal .zip files or folders.)
(99 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
=00001 - Generic=
+
=00001=
 
===Description file has to be put inside the same directory as manifest.sii file.===
 
===Description file has to be put inside the same directory as manifest.sii file.===
−
 
−
The mod description file should be placed next to the manifest.sii file in the version package. You need to move it or create in case you have not done it yet.
 
−
 
 
===Description file must be TXT file (?)===
 
===Description file must be TXT file (?)===
−
 
−
The mod description must be a .txt file. The solution for this problem is to change the extension of the file to .txt.
 
−
 
 
===Icon file has to be put inside the same directory as manifest.sii file.===
 
===Icon file has to be put inside the same directory as manifest.sii file.===
−
 
−
The mod icon file should be placed next to the manifest.sii file in the version package. You need to move it or create in case you have not done it yet.
 
−
 
 
===Icon file must be JPG file (?)===
 
===Icon file must be JPG file (?)===
−
 
−
Icon file must be a valid .jpg file. The solution is to resave your icon file to .jpg format.
 
−
 
 
===Incorrect icon file dimmensions. Allowed dimmensions are ?x?px (the icon size: ?x?px)===
 
===Incorrect icon file dimmensions. Allowed dimmensions are ?x?px (the icon size: ?x?px)===
−
 
−
Mod icon file has incorrect dimensions. To fix it you need to have image with proper size.
 
−
 
−
For now the limit is: '''276px x 162px'''
 
−
 
 
===No animation frames found.===
 
===No animation frames found.===
−
 
−
The .pma file has no animation frames. You should try to run your mod data resource conversion again.
 
−
 
 
===No defined bones found.===
 
===No defined bones found.===
−
 
−
.pma file without any bone defined is incorrect. You should try to run your mod data resource conversion again.
 
−
 
 
===No description file specified!===
 
===No description file specified!===
−
 
−
All workshop mods data must have description files specified. Please add it.
 
−
 
 
===No icon specified.===
 
===No icon specified.===
−
 
−
All workshop mods must have icon specified. Please add it.
 
−
 
 
===No package versions defined.===
 
===No package versions defined.===
−
 
+
===No vertices defined for piece ?."===
−
In '''versions.sii''' there are no valid version info entries. Please add at least one.
 
−
 
 
−
Example versions.sii file:
 
−
<pre>
 
−
SiiNunit
 
−
{
 
−
package_version_info : .universal
 
−
{
 
−
    package_name: "universal"
 
−
}
 
−
}
 
−
</pre>
 
−
 
 
−
===No vertices defined for piece ?.===
 
−
 
 
−
One of the pieces in .pmg file has no vertices defined. Please run resource conversion of your mod data again.
 
−
 
 
−
===Referenced look (?) does not exists in the model.===
 
−
 
 
−
look referenced by definition file does not exists in the model. You should make sure that the model has the look - in case it has run again your mod data conversion.
 
−
 
 
−
===Referenced variant (?) does not exists in the model.===
 
−
 
 
−
variant referenced by definition file does not exists in the model. You should make sure that the model has the look - in case it has run again your mod data conversion.
 
−
 
 
 
===Unable to load model animation file.===
 
===Unable to load model animation file.===
−
 
−
The load of the animation file failed. Try to run resource converstion for your mod again - in case it won't help check [[Documentation/Tools/SCS Workshop Uploader/tool.log.txt|tool.log.txt]] file for more informations.
 
−
 
 
===Unable to load model collision file.===
 
===Unable to load model collision file.===
−
 
−
The load of the collision file failed. Try to run resource converstion for your mod again - in case it won't help check [[Documentation/Tools/SCS Workshop Uploader/tool.log.txt|tool.log.txt]] file for more informations.
 
−
 
 
===Unable to load model descriptor file.===
 
===Unable to load model descriptor file.===
−
 
−
The load of the descriptor file failed. Try to run resource converstion for your mod again - in case it won't help check [[Documentation/Tools/SCS Workshop Uploader/tool.log.txt|tool.log.txt]] file for more informations.
 
−
 
 
===Unable to load model geometry file.===
 
===Unable to load model geometry file.===
−
 
−
The load of the geometry file failed. Try to run resource converstion for your mod again - in case it won't help check [[Documentation/Tools/SCS Workshop Uploader/tool.log.txt|tool.log.txt]] file for more informations.
 
−
 
 
===Unable to load tobj file.===
 
===Unable to load tobj file.===
−
 
+
===Unable to load units from ? file.===
−
Failed to load .tobj file. Try running again mod data conversion - in case it did not check [[Documentation/Tools/SCS Workshop Uploader/tool.log.txt|tool.log.txt]] if there are no informations about the tobj problem.
 
−
 
 
−
===Unable to read units from file.===
 
−
 
 
−
Unable to deserialize units from sii file. All the parsing errors are printed out to the [[Documentation/Tools/SCS Workshop Uploader/tool.log.txt|tool.log.txt]] file. Check it for more info.
 
−
 
 
 
===Unable to mount version.===
 
===Unable to mount version.===
−
 
−
Unable to mount mod data package. Try compresing mod data again as it may be broken.
 
−
 
 
===Unable to open description file.===
 
===Unable to open description file.===
−
 
−
Failed to open mod description file. The reason may be invalid path it must be only the file name, also the problem may be not enough memory or some file system problem.
 
−
 
 
===Unable to open file.===
 
===Unable to open file.===
−
 
−
Failed to open a file. The reason may be invalid path, not enough memory or some problem with file system.
 
−
 
 
===Unable to open icon file.===
 
===Unable to open icon file.===
−
 
−
Failed to open mod icon file. The reason may be invalid path it must be only the file name, also the problem may be not enough memory or some file system problem.
 
−
 
 
===Unable to read content of description file.===
 
===Unable to read content of description file.===
−
 
−
The reading of the file data failed. The reason may be not enough memory to load the data file.
 
−
 
 
===Unable to retreive informations about material.===
 
===Unable to retreive informations about material.===
−
 
+
===Referenced look (?) does not exists in the model.===
−
Unable to get informations about material resource. Try to run again mod data conversion.
+
===Referenced variant (?) does not exists in the model.===
−
 
+
=00002=
−
=00002 - File not found=
 
 
===Description file (?) does not exists.===
 
===Description file (?) does not exists.===
−
 
−
Description file for your mod does not exists. Make sure if description file name in '''manifest.sii''' is correct and the description file exists in the same directory as '''manifest.sii'''.
 
−
 
 
===File is not present===
 
===File is not present===
−
 
−
<pre>ERROR [00002] (file_name): File is not present</pre>
 
−
 
−
Make sure that the '''file_name''' exists.
 
−
 
 
===Icon file (?) does not exists===
 
===Icon file (?) does not exists===
−
 
+
===The version folder/archive does not exists!===
−
Icon file for your mod does not exists. Make sure if icon file name in '''manifest.sii''' is correct and the icon file exists in the same directory as '''manifest.sii'''.
 
−
 
 
−
===The version package does not exists!===
 
−
 
 
−
Package specified in version info inside '''versions.sii''' file does not exists. Make sure you did not make any typo and the package really exists.
 
−
 
 
 
===Unable to find descriptor file for model geometry! (geometry: ?)===
 
===Unable to find descriptor file for model geometry! (geometry: ?)===
−
 
−
There is .pmg file but no .pmd file. If you are using some model from base you have to move both pmg and pmd files into your mod for better compatibility. In case the model is yours you have to run again mod data conversion. Remember .pmd and .pmg files must be in the same directory!
 
−
 
 
===Unable to find geometry file for model descriptor ?.===
 
===Unable to find geometry file for model descriptor ?.===
−
 
−
There is .pmd file but no .pmg file. If you are using some model from base you have to move both pmg and pmd files into your mod for better compatibility. In case the model is yours you have to run again mod data conversion. Remember .pmd and .pmg files must be in the same directory!
 
−
 
 
===Unable to find manifest file.===
 
===Unable to find manifest file.===
−
 
−
Unable to find '''manifest.sii''' in one of the mod data packages.
 
−
 
 
===Unable to find material file referenced by model descriptor ?. The material must be placed in mod folder.===
 
===Unable to find material file referenced by model descriptor ?. The material must be placed in mod folder.===
−
 
+
===Unable to get material===
−
Unable to find the material file which is referenced by model descriptor. In case you have a model and you are using some materials from the base.scs archive you '''have to''' copy them to your mod folder to keep compatibility in case we change the material.
 
−
 
 
 
===Unable to find model descriptor file referenced in addon hookup data definition (?).===
 
===Unable to find model descriptor file referenced in addon hookup data definition (?).===
−
 
−
There is no .pmd file with this name in both base.scs or your mod data package - make sure the name is correct and the file exists.
 
−
 
 
===Unable to find model geometry file for model descriptor (?) referenced by addon hookup data definition (?).===
 
===Unable to find model geometry file for model descriptor (?) referenced by addon hookup data definition (?).===
−
 
+
=00003=
−
There is no .pmg file with this name in both base.scs or your mod data package - make sure the name is correct and the file exists.
 
−
 
 
−
===Unable to find preview icon for ? defined in ?===
 
−
 
 
−
Unable to find preview icon for the accessory. Make sure it exists.
 
−
 
 
−
===Unable to get material===
 
−
 
 
−
Unable to get material data. The material file is probably malformed. Try converting your mod data again.
 
−
 
 
−
=00003 - Not allowed=
 
−
 
 
−
===Package name (?..) name is too long. Maximum length is ?.===
 
−
 
 
−
Package name is too long. Maximum length of the name is: '''256'''.
 
−
 
 
−
===Package name is not a valid string===
 
−
 
 
−
The package name is not valid string. Make sure that you are using of correct characters.
 
−
 
 
 
===File with the unsupported extension found in the mod. Please remove it before uploading the mod.===
 
===File with the unsupported extension found in the mod. Please remove it before uploading the mod.===
−
 
−
Mods supports only specified set of file types. Having file of the type that is not supported is forbidden and you have to remove it.
 
−
 
 
===Found second universal version entry. Please use only one.===
 
===Found second universal version entry. Please use only one.===
−
 
+
===In the mod root folder there can be only versions.sii file and version specific folders. Found ? not allowed entries:===
−
Universal version entry is an version definition inside '''versions.sii''' file without any compatible versions defined.
+
===Mod package has to be placed inside the manifest.sii files put in version specific content directory. For example: "/latest/manifest.sii". (path: ?, manifest: ?)===
−
 
 
−
For example:
 
−
<pre>
 
−
package_version_info : .universal
 
−
{
 
−
    package_name: "universal"
 
−
    // No compatible_versions[]: X here!
 
−
}
 
−
</pre>
 
−
 
 
−
In case there are more than one versions like that inside '''versions.sii''' file you will get this error. To fix this simply remove one of the definitions.
 
−
 
 
−
===In the mod root folder there can be only versions.sii file and version packages. Found ? not allowed entries:===
 
−
 
 
−
There must be only '''versions.sii''' file and version packages. Example workshop mod should be - for example:
 
−
<pre>
 
−
my_mod\
 
−
    my_mod\versions.sii    <-- Definition file containing informations about versions and mod packages.
 
−
    my_mod\universal        <-- Universal mod package (can be zip or archive)
 
−
    my_mod\122_content.zip  <-- Mod package for the 1.22 update. (can be zip archive)
 
−
</pre>
 
−
 
 
−
===Mod package unit has to be placed inside the manifest.sii files put in version specific mod package. For example: "/latest/manifest.sii". (path: ?, manifest: ?)===
 
−
 
 
−
The '''mod_package''' definition must be placed inside manifest.sii file.
 
−
 
 
−
Example mod layout:
 
−
<pre>my_mod/
 
−
    my_mod/versions.sii
 
−
    my_mod/universal
 
−
        my_mod/universal/manifest.sii        <-- mod_package can be defined here.
 
−
    my_mod/122_content.zip
 
−
        my_mod/122_content.zip/manifest.sii  <-- mod_package can be defined here.</pre>
 
−
 
 
 
===Path cannot contain '..'. (position: ?)===
 
===Path cannot contain '..'. (position: ?)===
−
 
−
Paths used in the mods cannot use two dots ("..").
 
−
 
−
'''Invalid:''' <code>../other_folder/file.txt</code>
 
−
 
−
'''Correct:''' <code>/other_folder/file.txt</code>
 
−
 
 
===Path cannot contain Windows-style path separator (\\) only Unix-style separators are allowed (/). (position: ?)===
 
===Path cannot contain Windows-style path separator (\\) only Unix-style separators are allowed (/). (position: ?)===
−
 
−
All the paths used by mods must use unix-style separators.
 
−
 
−
'''Invalid:''' <code>\folder\folder2\file.txt</code>
 
−
 
−
'''Correct:''' <code>/folder/folder2/file.txt</code>
 
−
 
 
===txt/.jpg files that are not referenced by any sii file are not allowed!===
 
===txt/.jpg files that are not referenced by any sii file are not allowed!===
−
 
−
Any .txt or .jpg file that is not referenced by any definition file is not allowed. You have to remove it.
 
−
 
−
Also it is possible that you are referencing this file but you made a typo either in file name or in the definition that references it. Please check it.
 
−
 
 
===Unable to find universal version defined.===
 
===Unable to find universal version defined.===
−
 
−
There is no universal version defined inside '''versions.sii''' file. You have to add one.
 
−
 
−
Universal version is:
 
−
<pre>
 
−
package_version_info : .universal  <-- .universal can be any text starting with . (up to 12 characters)
 
−
{
 
−
    package_name: "name"          <-- package_name is the folder or archive name where you store mod data.
 
−
}
 
−
</pre>
 
−
 
−
===Units of type ? are not allowed.===
 
−
 
−
This unit is not allowed to be placed inside the file. Please remove it.
 
−
 
−
===Units of type ? can be stored only inside the '?' file.===
 
−
 
−
This unit definition can be only stored only inside the file written in the error message. Please remove it or move it.
 
−
 
 
===Using SCS files is not allowed for Steam Workshop mods - please use normal .zip files or folders.===
 
===Using SCS files is not allowed for Steam Workshop mods - please use normal .zip files or folders.===
−
 
+
===Version folder name contains disallowed characters. Allowed [a-z0-9_].===
−
With Steam Workshop mods you are not able to use ZIP files renamed to .scs. Please use normal ZIP files with .zip extension or folders.
+
=00004=
−
 
 
−
You can however use .scs files if they are in the HashFS v2 format.
 
−
 
 
−
===Package name contains disallowed characters. Allowed [a-z0-9_].===
 
−
 
 
−
Package name can only contains characters from range a to z, 0 to 9 and underscore characters _.
 
−
 
 
−
Example:
 
−
{| class="wikitable"
 
−
! Correct? || Folder/archive name
 
−
|-
 
−
| yes      || universal
 
−
|-
 
−
| yes      || 122_content
 
−
|-
 
−
| yes      || 122_123_content
 
−
|-
 
−
| no      || Universal
 
−
|-
 
−
| no      || $FOLDERNAME$$
 
−
|}
 
−
 
 
−
===package_name attribute in version definition file must be set.===
 
−
 
 
−
The package_name value must be set in all version definitions.
 
−
 
 
−
=00004 - Malformed file=
 
−
===Unable to load data from model ? file. (file is probably malformed - please run resource conversion again)===
 
−
 
 
−
Model file is malformed and the validator was unable to load data from it please run resource conversion again to fix this problem.
 
−
 
 
−
===1D, 2D, 3D and Rect tobj can have only one map set! (map index: ?)===
 
−
 
 
−
The .tobj file is likely malformed. Run the conversion of your mod data again.
 
−
 
 
 
===Count of the parts does not match descriptor file ?. (desc: ?, geom: ?)===
 
===Count of the parts does not match descriptor file ?. (desc: ?, geom: ?)===
−
 
+
===Count of the parts does not match geometry file ?. (desc: ?, geom: ?)"===
−
There is some problem with the model you are using. Please try running conversion of mod data again.
 
−
 
 
−
===Count of the parts does not match geometry file ?. (desc: ?, geom: ?)===
 
−
 
 
−
There is some problem with the model you are using. Please try running conversion of mod data again.
 
−
 
 
−
===Incorrect map at index ?===
 
−
 
 
−
Incorrect map in .tobj file has been detected. Please try running conversion of mod data again
 
−
 
 
−
===Incorrect map type. (?)===
 
−
 
 
−
The .tobj file is likely malformed. Run the conversion of your mod data again.
 
−
 
 
−
===Incorrect texture sampler_name: "?".===
 
−
 
 
−
Material is corrupted. Please try running conversion of mod data again. In case it did not help please check all the paths in the material file.
 
−
 
 
 
===Malformed DDS file!===
 
===Malformed DDS file!===
−
 
−
The DDS file is malformed. Save it again using your graphic editor in case it's created by you - in case it's result of mod data conversion run it again.
 
−
 
 
===Malformed description file. The description file should be encoded in UTF-8!===
 
===Malformed description file. The description file should be encoded in UTF-8!===
−
 
−
The description file is not encoded in UTF-8 and contain invalid characters. Please resave it using your text editor using UTF-8 encoding. (In case your text editor is not supporting UTF-8 we recommend using [https://notepad-plus-plus.org/ Notepad++])
 
−
 
 
===Malformed OGG file. Please correct it before uploading the mod.===
 
===Malformed OGG file. Please correct it before uploading the mod.===
−
 
−
The audio OGG file is malformed. Please re-save it.
 
−
 
−
===Malformed tobj file.===
 
−
 
−
The .tobj file is malformed. Please run mod data conversion again.
 
−
 
 
===Unable to load icon likely malformed file.===
 
===Unable to load icon likely malformed file.===
−
 
−
Unable to load data from the mod package icon. The file is likely broken please save it again using your image editor.
 
−
 
 
===Unable to read magic SII mark from file.===
 
===Unable to read magic SII mark from file.===
−
 
+
===Incorrect texture sampler_name: "?".===
−
The .sii file does not contain magic SII mark ("SiiNunit"). The correct .sii file is:
+
=00005=
−
 
+
===interior_model or exterior_model must be set to valid and descriptor file.===
−
<pre>
+
=00006=
−
SiiNunit
 
−
{
 
−
// Content
 
−
}
 
−
</pre>
 
−
 
 
−
=00005 - Missing required attribute=
 
−
===At least interior_model or exterior_model must be set to valid model descriptor file.===
 
−
 
 
−
Make sure all the at least exterior_model or interior_model is set in your accessory definition file.
 
−
 
 
−
=00006 - Access denied=
 
 
===Unable to create validation log file.===
 
===Unable to create validation log file.===
−
 
+
=00008=
−
The tool is unable to create validation.log.txt file. The file is probably opened by some application. Make sure you close all applications using the file and restart the tool.
+
===Unable to load model descriptor referenced by accessory addon data definition (?)===
−
 
 
−
=00007 - Not supported=
 
−
===Cube texture maps must be pot textures. (texture_name: ?)===
 
−
 
 
−
All the maps inside cube texture must have size that is power of two. Correct maps size.
 
−
 
 
−
===Mipmapping is not supported for npot texture.===
 
−
 
 
−
Mip maps are not supported in case you have non power of two textures. To use mip maps you must change size of your texture to be power of two (e.g. 64, 128, 256, 512, 1024 etc).
 
−
 
 
−
===Unsupported tobj version. (version: ?)===
 
−
 
 
−
This .tobj file version is not supported. Run conversion of your mod data again.
 
−
 
 
−
=00008 - Unable to load=
 
 
===Unable to load file.===
 
===Unable to load file.===
−
 
+
=00009=
−
Unable to load the file. To solve this you should run mod data conversion again.
 
−
 
 
−
===Unable to load model descriptor referenced by accessory addon data definition (?)===
 
−
 
 
−
Make sure that the .pmd file exists. In case it exists run again mod data conversion.
 
−
 
 
−
=00009 - File is too big=
 
 
===Maximum size of description file is ? MB===
 
===Maximum size of description file is ? MB===
−
 
−
Mod description file is too big. Maximum size is: '''1 MB'''.
 
−
 
 
===Maximum size of icon file is ? MB===
 
===Maximum size of icon file is ? MB===
−
 
+
==
−
The mod icon is too big. Maximum allowed size for is: '''1 MB'''
+
[[Category:TODO]]
−
 
 
−
 
 
−
=00010 - IO Error=
 
−
This kind of error mostly happens when the application is not able to read/write information to the hard disk. Make sure you have enough space on your hard disk. If it happens during reading, it is possible that an anti-virus was blocking the file and application failed to read it - try disabling it for the time of application use.
 

Revision as of 10:44, 27 January 2016

Contents

00001

Description file has to be put inside the same directory as manifest.sii file.

Description file must be TXT file (?)

Icon file has to be put inside the same directory as manifest.sii file.

Icon file must be JPG file (?)

Incorrect icon file dimmensions. Allowed dimmensions are ?x?px (the icon size: ?x?px)

No animation frames found.

No defined bones found.

No description file specified!

No icon specified.

No package versions defined.

No vertices defined for piece ?."

Unable to load model animation file.

Unable to load model collision file.

Unable to load model descriptor file.

Unable to load model geometry file.

Unable to load tobj file.

Unable to load units from ? file.

Unable to mount version.

Unable to open description file.

Unable to open file.

Unable to open icon file.

Unable to read content of description file.

Unable to retreive informations about material.

Referenced look (?) does not exists in the model.

Referenced variant (?) does not exists in the model.

00002

Description file (?) does not exists.

File is not present

Icon file (?) does not exists

The version folder/archive does not exists!

Unable to find descriptor file for model geometry! (geometry: ?)

Unable to find geometry file for model descriptor ?.

Unable to find manifest file.

Unable to find material file referenced by model descriptor ?. The material must be placed in mod folder.

Unable to get material

Unable to find model descriptor file referenced in addon hookup data definition (?).

Unable to find model geometry file for model descriptor (?) referenced by addon hookup data definition (?).

00003

File with the unsupported extension found in the mod. Please remove it before uploading the mod.

Found second universal version entry. Please use only one.

In the mod root folder there can be only versions.sii file and version specific folders. Found ? not allowed entries:

Mod package has to be placed inside the manifest.sii files put in version specific content directory. For example: "/latest/manifest.sii". (path: ?, manifest: ?)

Path cannot contain '..'. (position: ?)

Path cannot contain Windows-style path separator (\\) only Unix-style separators are allowed (/). (position: ?)

txt/.jpg files that are not referenced by any sii file are not allowed!

Unable to find universal version defined.

Using SCS files is not allowed for Steam Workshop mods - please use normal .zip files or folders.

Version folder name contains disallowed characters. Allowed [a-z0-9_].

00004

Count of the parts does not match descriptor file ?. (desc: ?, geom: ?)

Count of the parts does not match geometry file ?. (desc: ?, geom: ?)"

Malformed DDS file!

Malformed description file. The description file should be encoded in UTF-8!

Malformed OGG file. Please correct it before uploading the mod.

Unable to load icon likely malformed file.

Unable to read magic SII mark from file.

Incorrect texture sampler_name: "?".

00005

interior_model or exterior_model must be set to valid and descriptor file.

00006

Unable to create validation log file.

00008

Unable to load model descriptor referenced by accessory addon data definition (?)

Unable to load file.

00009

Maximum size of description file is ? MB

Maximum size of icon file is ? MB

==

Retrieved from "https://modding.scssoft.com/index.php?title=Documentation/Tools/SCS_Workshop_Uploader/Validation_errors_and_solutions_for_them&oldid=604"