How to Make Your First Custom Block for Minecraft Bedrock in the GodCraft App

A custom block is the best first project in GodCraft. You see the result right away, there are only a few settings that really matter, and you end up with something you can build with. In this guide we'll make a glowing "Ruby Block" from scratch and get it into a world.

1. Create the add-on

1. Open the Workbench tab and tap the + button.
2. Choose Create Addon.
3. Give it a Name and a short Description. You can also set an Icon; it becomes the pack icon you see in Minecraft's pack list.
4. Tap the Items, Entities, ... row. This opens the Objects screen, where everything in your add-on lives.

The Minecraft version shown at the top of the add-on editor (for example "MC 1.21") is the game version you are making it for. Tap it to change it if your players are on an older version.

2. Add a custom block

1. On the Objects screen, tap Add Object.
2. Open Blocks.
3. Tap Custom Block at the top.

Under Custom Block you will also see shapes like Custom Slab, Custom Stairs, Custom Fence and Custom Door. They open the same editor with the right model already set up. Further down is the list of every vanilla block; picking one of those re-textures the existing block instead of adding a new one. For now, stick with Custom Block.

3. Give it a texture

The block editor opens with a 3D preview at the top. Tap the texture field to choose where the texture comes from:

• Select opens the built-in texture library, which you can search.
• Gallery or Files lets you use an image you already have.
• Paint 2D opens the pixel editor at 16x16, the same size as vanilla blocks.

Next to it is Texture Layout:

• All faces: one texture everywhere. Right for stone, ores and most decorative blocks.
• Top / Bottom / Sides: for things like logs, pillars or a grass-style block.
• Per face: a different texture on each of the six sides, useful for machines with a front face.

We usually start a block in Paint 2D by picking a vanilla texture as a base and recoloring it. It keeps the style close to Minecraft and is much faster than drawing from an empty grid.

4. Name and identifier

Type the Name players will see, such as "Ruby Block". The Identifier fills in from the name (for example ruby_block) and the app adds the godcraft: prefix. It must be lowercase and unique within your add-on; the editor warns you if another object already uses it.

Right below, a small card shows the command to get the block in game, like /give @s godcraft:ruby_block. Tap it to copy. You'll want it for testing.

Pick a Category too. It decides which tab of the creative inventory the block shows up in.

5. Set how it behaves

The collapsible sections below hold the block's properties. The ones worth setting for a first block:

• Destructible by Mining (seconds): how long it takes to break without tools. Stone is around 1.5, obsidian is 50. For a ruby block, 3 to 5 feels right.
• Explosion Resistance: higher means creepers and TNT struggle to break it.
• Friction: 0.6 is normal ground. Lower values make it slippery like ice.
• Light Emission (0 to 15): 15 is as bright as glowstone. We'll use 7 for a soft glow.
• Light Dampening (0 to 15): how much light it blocks. Leave it at 15 for a solid block.
• Map Color: the color it shows on maps.

6. Choose what it drops

In Drops, set "When mined, drop" to Itself, Custom item or Nothing. A custom item drop is how you make an ore: the block drops a gem, with a Drop count you choose. For more control (several items, random amounts) use Custom loot table.

Tap Save. The block now appears in your Objects list.

7. Add a recipe (optional)

Without a recipe, survival players can only get your block with commands. To add one, go back to Add Object > Recipes > Crafting Recipe. Choose Shaped or Shapeless, tap the grid slots to place ingredients, then tap the result slot and pick your block. Eight red dye around a diamond, for example.

8. Save and try it

1. Go back to the add-on editor and tap Save.
2. In Workbench, tap Install on your add-on and choose Minecraft.
3. Activate both packs on a test world with cheats on, then paste the /give command.

Saving and installing use a few gems; with Premium they are free.

Common problems

• The block is invisible or purple and black: the resource pack isn't active in the world. Check Resource Packs in the world settings.
• It breaks instantly: Destructible by Mining is 0. Raise it.
• The texture looks blurry: use a square image at 16x16 (or 32x32, 64x64). Odd sizes get scaled.
• The /give command says unknown item: the behavior pack isn't active, or you typed the identifier without the godcraft: prefix.

When you're comfortable with the basics, look at States & Permutations and Triggers & Events in the same editor. That's where blocks get directions, on/off states and actions when you interact with them.