Table of contents
Table of contents
Namespaces are identifiers that marks content ownership. You can think of them as folders. Namespaces are useful, because they keep naming conflicts from happening.
Namespaces in addon creation can essentially be thought of as “the part to the left of the colon”. For example,
minecraft is the namespace of
minecraft:zombie. The general form is
As a really specific example of why namespaces are useful, lets imagine you create a new Mob. You name it
minecraft:shark, not aware that you should create your own namespace for custom content. Next year, Mojang decides to add sharks into the game! Now there is a naming conflict, since there are two definitions of
minecraft:shark. Your addon will break.
If you had instead used
your_namespace:shark, the naming conflict wouldn’t have happened.
A good namespace is completely unique to you. Something like
custom would be a bad namespace, since another developer might come up with the same namespace as you.
A good namespace is short. You will be writing your namespace a LOT, so the shorter the better.
george_carlin_the_comedian would be a bad namespace for this reason.
For personal projects, I recommend a convenient version of your player name, and for commercial projects, I recommend a convenient version of the company name.
Some good examples:
DO NOT USE
minecon as a namespace unless editing a vanilla file. Not only is it a terrible idea but Minecraft reserves these and it won’t even work.
In short, you should use name-spaces as often as you can.
For starters, you should use a namespace when adding custom entities to the game.
sirlich:shark is much better than
You should also use namespaces for components, and events. Just like Mojang uses
minecraft:pig_saddled you should use
You should also use namespaces in animation controllers, render controllers, and animations.
controller.animation.namespace.entity_name.action is better than
The actual file structure does not need namespaces.
animations/namespace/my_entity/animation is more confusing than