navigate_before Prev Next navigate_next
An organised listing of all the possibilities within the config file!
Remember, that the hierarchy of the elements is always module/extension/modification > set > aspect > style > file. This is relevant because the value of many attributes is inherited. If you don't define the value for such an attribute, then the element will check its parent element (hierarchically speaking) for the value of the same attribute and use that.
Example: If a set has the attribute color defined with a value of "#FF0000" (red), then all aspects within this set will have the color red in their color picker when the config file is loaded, unless you specify a different color for the aspect, which would override the inherited color of the set. It may not make any sense to give a set a color, but it does save you having to define the color for all aspects within that set individually, which saves time!
mandatory - Not defining this value will cause errors.
required - This value must be defined eventually, but won't lead to errors if you don't do it right away.
recommended - Not defining these values may cause undesired effects or affect the popularity of the content negatively.
optional - If you don't need it, don't use it.
inherited - Also optional, but if you don't define this, then the corresponding value of an element higher up will be used instead. So the file will check its style, which will check its aspect, which will check the set.
|id||-||Unique identifier of any module/ext/mod or alternatively of any element within a config file. Makes sure that all relevant content/effects can be unmistakably associated with the correct element.|
|title||"unknown"||IDs are not very readable, so we use the title for describing elements and content to the user.|
|authorid||"unknown"||This should be the EMCCV community username of the person who created the module/ext/mod. This way users will be able to search for all content provided by a specific contributor or alternatively visit the profile of the contributor of their favourite content to see whether there is more!|
|sDesc||"no description"||short description. Used for the INFO tab within the EMCCV, as well as table listings of content within this website, once we have enough to make searches worthwhile. ^^|
|lDesc||"no description"||Will be used for the content page on the EMCCV website, once the module/ext/mod is listed (if you want it to be).|
|adultonly||false||Set the value to "true" to mark content as being for adults only (mandatory for things like anatomical details and gore). The EMCCV will detect such elements and ask the user to confirm their age to be over 18. If they are too young, then these adult only elements will simply not be shown.|
|color||"#FFFFFF"||The color must be in hexadecimal format. The default is white, which means that the colors of the files are preserved. Setting any other color will tint the files with that color.|
|opacity||"255"||A value from 0 to 255, where 255 is completely opaque.|
|layer||0||Files are printed onto the canvas in the order of their layer values from lowest to highest. If multiple files have the same layer then they are printed in the order they appear in the config file. You can use integers (whole numbers) or doubles (with up to two decimal spaces).|
|x||0||defines the horizontal position within the canvas where the file(s) are to be printed|
|y||0||defines the vertical position within the canvas where the file(s) are to be printed|
|w||0||Width of the file(s). The default value of 0 preserves the original width.|
|h||0||Height of the file(s). The default value of 0 preserves the original height.|
|relx||0||defines the horizontal position within the canvas relative to x where the file(s) are to be printed|
|rely||0||defines the vertical position within the canvas relative to y where the file(s) are to be printed|
|parent||-||(The default is empty.) This attribute can contain a logical expression made up of the id(s) of any element(s) that are also loaded in the EMCCV, separated by "and" and/or "or". The EMCCV Prototype ignores mathmatical rules and simply goes through the elements one by one.|
Any element with a parent will only be displayed (file) or be selectable (style/aspect), when the parent(s) are as well.
|colormaster||-||(The default is empty.) May contain exactly one aspect id. The file will use the color of this aspect and ignore the color of its actual parent aspect (hierarchically speaking). (SailorXv3 uses this to make sure the eyelids don't turn blue when the eyes are turned blue. Instead they keep matching the color of the head.)|
|opacitymaster||-||(The default is empty.) May contain exactly one aspect id. The file will use the opacity of this aspect and ignore the opacity of its actual parent aspect (hierarchically speaking). (AFH uses this for the shading files. One aspect "shading" controls all the shading files.)|
|alwayson||false||If you set the value to "true", then the checkbox of the aspect will always remain checked and disabled.|
|probability||75||Needed when randomizing. The value of 75 means that when randomizing, the aspect has a 75% chance of being visible afterwards. (An aspect that is alwayson will remain visible and ignore this attribute.)|
|colorizable||true||If you set this to "false", then |
1) an aspect will not have a color picker
2) a style or file will ignore the color of the parent aspect (hierarchically speaking)
|src||-||the location of the graphic file, starting from within the modules data folder.|
|stylegroup||"default"||By default all styles are part of the stylegroup "default". If you use any other value, then you create a new stylegroup within that aspect. |
All styles within a stylegroup are mutually exclusive. If you have multiple stylegroups within an aspect, then they will appear as multiple radiobutton groups, separated by a line.
You can use the same stylegroup for multiple aspects. Beware though: In the future there will be a tool called "SYMMETRY": When active, all stylegroups with the same name will be synchronized. That means that the style ids contained within identical stylegroups must be identical, too!
|visible||false||If you set this to "true", then the aspect will be visible when the config file is loaded. (Alwayson aspects are automatically visible.)|
|buttonwidth||70||This defines the with of the tab button, that contains the title of the set. If this is too narrow, then the title may not appear at all.|
|randomize||-||You can define a single letter like "a" to be the shortcut for randomizing the element. If a set is randomized, then the visibility and the styles of all contained aspects will be randomized. If you define this feature for an aspect, then only the styles of the aspect itself will be randomized. It will remain visible.|
|incognito||false||This element will be processed normally, but it won't appear in the EMCCV menu.|