Search the wiki
Model Naming Conventions
Part of your role as a modeller is to ensure your model is named accordingly. As painful as it may seem and as bland as the task is, it is essential to ensure others who pick up your asset are able to work with it effectively.
If you are unclear about any of the below information, please do contact your supervisor.
Naming the top level group node
This is essential and you should not use your imagination.
For every asset, everything should sit under a top-level group node. This group node should be named like so:
Object naming convention
We are using the following tokens for naming objects and each token should be seperated with an underscore:
The side token is optional and should be added to all objects to describe is the object is to the left, right or centred. Please note that the side token should be capitalised.
- L: for objects to the left of the centre line. For example, the left arm.
- R: for objects to the right of the centre line. For example, the right arm.
For objects at the centre of the centre line, you do not need to add a side token. And when you have multiple objects going from left to right (for example a row of windows), you can simply add a three padded number onto the end (as described in the object section of this doc). For example:
The Position token is optional and should be used to describe where the object lies in relation to other similar objects. When using this token, think about the naming of anatomical landmarks. For example, the anterior superior iliac spine or the inferior superior iliac spine. Like anatomy, you only need to include this token if the opposite exists. For example, if you have an object on the exterior, but there is no interior equivalent, then you do not need to add the interior token.
The available position tokens are:
- Int: for objects that are on the inside. For example, an interior wall.
- Ext: for objects that are on the outside. For example, an exterior wall.
- Fnt: for objects that are positioned on the front. For example, a front panel.
- Bck: for objects that are positioned on at the back. For example, a rear panel.
- Upp: for objects that are above another object. For example, upper pipe vent.
- Lwr: for objects that are below another object. For example, lower pipe vent.
- Btm: for objects that are at the bottom. For example, bottom panel.
- Top: for objects that are at the top. For example, top panel.
You can also mix and match. For example, IntFnt or ExtBck. Maybe later on, we’ll create a stricter set of rules for position, but for now, we’ll leave it up to you to use something the is easily readable and descriptive.
The Section token is optional and should be used to describe a part of the object. For example, the arm, leg, torso, etc.
Please note, we are using the anatomical classification for limbs and other body parts. For example, the ‘leg’ anatomically refers to the space between the knee and the foot, and the ‘thigh’ refers to the region between the hip and the knee. So NO UpperArm and LowerArm!
The ObjectName token is mandatory and should describe clearly the object. As mentioned above, if you have an object where you need multiple words to describe it please seperate the words with a Capital letter. When you have multiples of the same object or similar objects in the scene, please add a three padded number (###) onto the end of the ObjectName token, starting with 001.
Here are some examples:
Please try not make up random names. Do a little research and try to find the official name for the object. We do not want to see objects named Thing001 and Thing002, or Cylinder001, Sphere1, etc. Models with such names will get kicked back and not reviewed.
The material tag is to help look dev with shader assignment and should also be used to block out the initial look of the asset. Currently, we are keeping things very simple with the tags, but later on, we’ll be updating the list of materials and tags. Please note, the materialTag should be seperated with a double underscore (__). This makes it easier for filtering of the object names.
Later on, we will be building a tool and shader library for easy assignment of shaders and material tags.
For more details on the material tags, please see this document:
The TYPE token is mandatory and should describe the type of object. For example, is it geometry, a curve, a group node, etc. Please note that the type token should be capitalised.
- GEO: used to describe polygonal models.
- GRP: used to describe a group node.
- CRV: used to describe curves.
Avoid duplicate names
As mentioned above, when naming duplicate objects, please add a three padded number to the ObjectName. All objects in the scene should have a unique name, and not doing so can create issues later on, especially when pushing assets from one application to another.
Here is an example of approved naming of duplicate objects:
And an example of a model that would be declined:
Here are some more examples. Later on, we’ll look to have a tool created to manage help manage the naming of objects.
Support CAVE Academy
Here at CAVE Academy the beauty of giving and sharing is very close to our hearts. With that spirit, we gladly provide Masterclasses, Dailies, the Wiki, and many high-quality assets free of charge. To enable the team to create and release more free content, you can support us here: Support CAVE Academy