Skip to content
Kweebedia logo Kweebedia
Quick Start: Your First Pack

Quick Start: Your First Pack

Create a custom block that you can place in-game using the Asset Editor.

What You’ll Build

Section titled “What You’ll Build”

A simple custom block with:

  • A unique texture
  • Basic block properties
  • Placeable in-game

Time: ~5 minutes

Before You Start

Section titled “Before You Start”

Make sure you have:

  • Hytale installed with the Asset Editor
  • A server running (setup guide)

Step 1: Open the Asset Editor

Section titled “Step 1: Open the Asset Editor”
  1. Launch Hytale
  2. From the main menu, open the Asset Editor
  3. Create a new pack or open an existing one

Step 2: Create a Block

Section titled “Step 2: Create a Block”
  1. In the Asset Editor, navigate to Blocks
  2. Click Create New Block
  3. Name your block (e.g., “My Custom Block”)

Step 3: Configure Block Properties

Section titled “Step 3: Configure Block Properties”

Set basic properties:

  • Display Name: The name shown in-game
  • Category: Which creative menu tab it appears in
  • Hardness: How long it takes to break

Step 4: Add a Texture

Section titled “Step 4: Add a Texture”
  1. Select your block
  2. Go to the Appearance tab
  3. Either:
    • Use an existing texture from the library
    • Import your own texture (PNG, 16x16 or 32x32)

Step 5: Export Your Pack

Section titled “Step 5: Export Your Pack”
  1. Click Save to save your pack
  2. The pack is automatically placed in the correct location

Step 6: Test In-Game

Section titled “Step 6: Test In-Game”
  1. Start or restart your server
  2. Join the server
  3. Open creative mode
  4. Find your block in the category you selected
  5. Place it in the world!

Understanding Pack Files

Section titled “Understanding Pack Files”

When you save, the Asset Editor creates files like:

YourPackName/
├── manifest.json           # Pack metadata
├── Common/
│   └── BlockTextures/
│       └── my_custom_block.png
└── Server/
    └── Block/
        └── my_custom_block.json

The block definition (my_custom_block.json) might look like:

{
  "identifier": "mypack:my_custom_block",
  "displayName": "My Custom Block",
  "category": "building",
  "hardness": 1.0,
  "texture": "mypack:my_custom_block"
}

Troubleshooting

Section titled “Troubleshooting”

Block not appearing?

Section titled “Block not appearing?”
  • Restart the server after adding the pack
  • Check that the pack is in the mods/ folder
  • Verify manifest.json has no syntax errors

Texture not showing?

Section titled “Texture not showing?”
  • Ensure texture is PNG format
  • Check file is in the correct folder
  • Verify the texture reference in block definition

Next Steps

Section titled “Next Steps”