This guide is OUTDATED, please follow this link to the current guide: https://github.com/NotAwesome2/MCGalaxy-CustomModels/wiki
You will use BlockBench to create/edit your model. You can find BlockBench here: https://blockbench.net/
If you want to create a model from scratch, use "free model" type. However, it is recommended to start with one of the templates found below.
These templates give you a starting point using the correct type of blockbench project (free model), as well as an example of player models. You can download them here: https://dl.dropbox.com/s/c8gdw0y7mtaolrr/customModelTemplates.zip It's a zip file, so extract it to get what's inside. There's three different types of human models:
- human with 64x32 skin resolution and thick arm (like Steve)
- human with 64x64 skin resolution and thick arm (like Steve, but more layers and unique left arm/leg)
- human with 64x64 skin resolution and thin arm (Like Alex)
It is highly recommended to use 64x64THICKarm as a base if you're making a human model edit, because if you keep the parts named correctly (the bits with "human" in the name, and "layer" in the name), it will automatically work with all skin types!
The .zip file also comes with a matching skin for each human model.
They are just examples to view using blockbench, but in-game you can apply whatever skin you want by changing your ClassiCube account skin or using /skin [url of .png file]
Once you're happy with your model in BlockBench, save it. DO NOT EXPORT IT! Exporting won't work! You must save your project to get a .bbmodel file. If BlockBench asks you to save the skin .png file, save that somewhere, then you will be able to save your .bbmodel too.
This step assumes you are using dropbox. After installing dropbox, put your .bbmodel file into one of your dropbox folders. Now go to https://www.dropbox.com/home (login if you haven't), and use the search bar to find the name of your file. After locating your file, hover over it and click the Share button on the right. Then click the "create link" text on the bottom right of the popup. Then click "copy link" to put it into your clipboard.
Then in-game, use /cm upload [yourname]+ [ctrl + v to paste url of .bbmodel here]
For example: /cm upload goodly+ https://www.dropbox.com/s/lkjig2uk5h1ir3n/64x64skinTHICKarm.bbmodel?dl=0
You can also use a service like put.nu, catbox.moe, or even discord. Anything that allows you to get a DIRECT link to the .bbmodel file (so, it has to end with .bbmodel) will also work.
After you've uploaded your model, you can wear your model in-game by using /model [yourname]+.
For example, if your name is goodlyay, you should use /model goodlyay+
That's it for the basics! Continue reading to understand more about editing your model.
The cubes in your model will animate based on the name of the cubes in BlockBench. Here is a list of all of the "key names" that make the cube animate in various ways. Only one animation key name will work on any given cube.
| name | effect |
|---|---|
| head | makes the cube rotate like a head does |
| rightarm | animates the way player's right arm does |
| leftarm | animates the way player's left arm does |
| rightleg | animates the way player's right leg does |
| leftleg | animated the way player's left leg does |
| spinx:1 | makes the cube always spin on the X axis |
| spiny:1 | makes the cube always spin on the Y axis |
| spinz:1 | makes the cube always spin on the Z axis |
| spinxvelocity:1 | makes the cube spin on the X axis only when you walk |
| spinyvelocity:1 | makes the cube spin on the Y axis only when you walk |
| spinzvelocity:1 | makes the cube spin on the Z axis only when you walk |
| hand | this is a special property. It doesn't have to do with animation, but tells the game to make this cube appear in first-person mode. |
You can combine this key name with another animation by putting both key names in a row, separated with a comma. For example: rightarm,hand.
You can also add your own names that are just for organization purposes, provided you properly separate them with commas. Consider a cube named "rightarm,layer,hand". "rightarm" gives it a right-arm type of animation, and "hand" tells the game to make this cube appear when you're in first-person view. "layer" doesn't do anything. It's here for our convenience and to identify which cube this is.
A note about the spin animations. You can change the "1" to be a bigger or smaller number to change its speed. Negative numbers also work (goes backwards).
The way a cube animates and rotates is based on the pivot point it has. Every cube has one.
If you want arms to rotate properly, you should make sure all the parts of the arm have the same pivot at the middle of the shoulder. If you want legs to rotate properly, you should make sure all the parts of the leg have the same pivot at the top-center of the leg.
If you want your head to pivot properly, you should make sure the pivot is set to the bottom-center of the head. If you have other parts that are "attached" to the head, you need to make sure that all of those parts have the exact same pivot, otherwise they will separate when you move in-game.
PIVOTS CAN GET TRICKY! The "move" tool in BlockBench AUTOMATICALLY moves the pivot as well, which is a common cause of wrongly-placed pivots. If you want to move or fix the pivot without moving the rest of the model, you should use the pivot tool, which has a crosshair icon.
Because BlockBench is first and foremost a Minecraft tool, there are quite a few features in it that aren't supported in ClassiCube.
- Any format other than "free model" DOES NOT work.
- The "Animate" tab on the top right DOES NOT work.
- Selecting a "group" folder to rotate multiple parts or change pivots DOES NOT work.
- As a general rule; don't select groups to do an action on multiple parts. You should instead hold ctrl and click to select each cube you want to change, then do the action.
- Multiple different textures DOES NOT work.
- This means that the option to set a face to "transparent" does not work because it relies on using a separate blank texture!
- Instead, you should drag the face to an empty area in your skin to make that face invisible.
- UV rotation DOES NOT work. (UV describes how the texture is applied to the face of a cube).
- You can, however, mirror the UV by changing the size of the UV to negative numbers.
- It is noteworthy that by default, the "top" face of a cube has a negative value for both width and height. The "bottom" face of a cube has a negative value for just width.