Parts Tracker Submit Validation Checks and Automatic Corrections
Policies and Procedures
This is an ratified, official LDraw.org document. Non-adminstrative changes can only be made with the approval of the maintainer.
Upon submission to the Parts Tracker, the following checks are run on the submitted file.
Error
Will result in file rejection.
- First line in the file is not
0 <description> - Description contains invisible control characters, unused code points, the line separator character (U+2028), or the paragraph separator character (U+2029)
- Description of a part does not start with
~and has aLDRAW_ORGtype ofSubpart - Description of a part does not start with
~and has aCATEGORYofMovedorObsolete - Description of a part does not start with
=and has aLDRAW_ORGoptional qualifierAlias - Description of a part does not start with
|or~|and has aNameof the formtNNNN.dat(Third Party Part) - Description ends with
(Obsolete)or starts with~Obsoletebut does not haveCATEGORYofObsolete - Missing or invalid
Authorstatement - Missing or invalid
Namestatement Namecontains characters other thana-z,0-9,_,-,.,\Namestarts withx(i.e. old style unknown part number)Nameof a part does not end withkNNif theLDRAW_ORGoptional qualifier isFlexible_Sectionand is not in theMovedorObsoletecategoryLDRAW_ORGtype isPartorShortcutandNameends withpNNNNorpXX(X)and Description does not end withPattern (<optional qualifier>)LDRAW_ORGtype isPartorShortcutandNameends withpNNNNorpXX(X)and does not have a "set"KEYWORD(as defined in the LDraw.org Official Parts Library Standard)- Directory in part
Namedoes not match the directory defined byLDRAW_ORGtype (e.g.Subpartdoes not begin withs\) - The submitted file filename does not match
Name - Missing or invalid
LDRAW_ORGstatement LDRAW_ORGoptional qualifier isAliasandLDRAW_ORGtype is notPartorShortcutLDRAW_ORGoptional qualifier isFlexible_SectionandLDRAW_ORGtype is notPart- Missing or invalid
LICENSEstatement LICENSEis not an approved license for the LDraw.org Official Parts Library- No
0 BFC CERTIFY CCWstatement in header CATEGORYis not in the valid category listCATEGORYisObsoleteand description does not end with(Obsolete)or start with~Obsolete- Invalid
HISTORYstatement(s) - Author listed in
HISTORYnot a registered author - Part body contains meta commands other than
0 //style comments,TEXMAPcommands, orBFC - Any number exceeds 5 decimal places in types 1-5 lines
- Any number contains leading or trailing zeros, except a single zero immediately before the decimal point
- Type 2 or 5 lines not color 24
- Type 1, 3, or 4 lines that are color 24
- Type 2-5 lines with identical vertexes
- Type 1 lines with a singular matrix
- Type 3, 4, or 5 lines with collinear vertexes
- Type 4 lines that exceed 3 degrees of planar deviation
- Type 4 lines that define concave or bowtie geometry
Warnings
- A number in the description that may not have the required leading spaces
- Numbers the exceed the decimal precision recommendation for the
LDRAW_ORGtype but do not exceed 5 decimal places. - An invalid
PREVIEWstatement for the LDraw.org Official Parts Library - The CC-BY-2.0 License is used
- The
CATEGORYisMinifig. This is a reviewer aid to ensure a more specific Minifig category is not warranted. - A sticker color or base part in a sticker shortcut is not color 16
- Type 4 lines that exceed 1 degree but do not exceed 3 degrees of planar deviation
Automatic Corrections
- Invalid UTF-8 encoding
- All legal, horizontal whitespace characters are converted to spaces
- With the exception of the first line (the description), multiple, consecutive spaces in a line are converted to 1 space
- Multiple, consecutive blank lines will be consolidated to 1 blank line
LDRAW_ORGtype is notUnofficial_<type>, "Unofficial_" will be added- An invalid
PREVIEWstatement for the LDraw.org Official Parts Library will be discarded - Non-critical invalid header commands are discarded
- Out of order header commands are placed in proper order