Packs (Data Assets)

Packs are the most accessible way to add content to Hytale. Using JSON files and the Asset Editor, you can create new blocks, items, NPCs, and world generation without writing any code.

What Can You Create?

Content Type	Examples
Blocks	Custom building materials, interactive blocks, decorations
Items	Weapons, tools, food, materials, consumables
NPCs	Creatures, monsters, villagers, animals
World Generation	Biomes, terrain features, structures
Drop Tables	Loot rewards, crafting materials
Behaviors	How entities act and respond

Why Start with Packs?

• No coding required - JSON files and visual editors
• Instant results - See your content in-game immediately
• Foundation for everything - Plugins and assets build on pack definitions
• Official workflow - Same tools Hypixel Studios uses

Quick Start

Ready to create your first content?

Create Your First Block - Build a custom block in 5 minutes

Tools You’ll Use

Tool	Purpose
Asset Editor	Visual editor for most asset types
Asset Graph Editor	Node-based editor for NPCs, world gen
Text editor	Direct JSON editing when needed

Pack Structure

Packs are stored in the server’s mods/ folder. A typical pack looks like:

YourPackName/
├── manifest.json       # Pack metadata (name, version, dependencies)
├── Common/
│   ├── BlockTextures/  # Textures for blocks
│   ├── Icons/          # UI icons
│   ├── Models/         # 3D models
│   ├── Blocks/         # Block definitions
│   └── Animations/     # Animation files
└── Server/
    ├── Item/           # Item definitions
    ├── Category/       # Category groupings
    └── Languages/      # Localization

Current Limitations

The Asset Editor has limitations around certain content types:

• NPCs (complex behavior trees)
• World generation (biome configuration)
• Interactions (trigger systems)

For these advanced features, use the Asset Graph Editor - a node-based visual tool.

Documentation In Progress

Detailed pack schemas and examples will be added as official documentation becomes available. The server is not obfuscated - you can decompile it to understand asset formats.

Tutorials

• Creating Blocks - Custom block types with textures and properties
• Creating Items - Weapons, tools, materials, and consumables

Combining Packs with Plugins

Packs define what exists (data). Plugins define how things behave (logic).

For example, a minigame might use:

• A pack to define custom items, blocks, and NPCs
• A plugin to handle game rules, scoring, and player management

For custom logic beyond what packs support, see Plugins (Java).