The Asset Explorer allows you to browse, extract, and view Hytale game assets directly from the panel. Access it from Tools → Asset Explorer.
Hytale stores game assets (models, textures, sounds, etc.) in compressed archives. The Asset Explorer provides:
- Browse the complete asset hierarchy
- Extract individual files or folders
- Preview supported file types
- Search for specific assets
- Download extracted files
Before browsing, you need to extract the assets from the game archives.
- Go to Tools → Asset Explorer
- Click Extract Assets
- Wait for the extraction to complete (may take several minutes)
- Assets are extracted to
/opt/hytale/data/assets/
Using the server console:
Or via container:
docker exec hytale /opt/hytale/server/extract-assets.sh
- Folder Tree - Left sidebar shows the directory structure
- File List - Main area shows files in current folder
- Breadcrumbs - Top bar shows current path
- Back Button - Return to parent folder
| Folder | Contents |
|---|
models/ | 3D models (.hym, .obj) |
textures/ | Image textures (.png, .jpg) |
sounds/ | Audio files (.ogg, .wav) |
shaders/ | Shader programs |
prefabs/ | Prefab definitions |
scripts/ | Lua/behavior scripts |
ui/ | UI layouts and assets |
localization/ | Translation files |
- Click the Search icon or press
Ctrl+F
- Enter your search term
- Results show matching files across all folders
- Name:
name:sword - Files containing “sword”
- Extension:
ext:png - Only PNG files
- Path:
path:models/creatures - Within specific path
- Size:
size:>1MB - Files larger than 1MB
| Query | Results |
|---|
dragon | All files with “dragon” in name |
ext:ogg | All sound files |
path:textures name:grass | Grass textures only |
| Type | Formats | Preview |
|---|
| Images | PNG, JPG, TGA, BMP | Full preview |
| Text | JSON, TXT, XML, LUA | Syntax highlighted |
| Audio | OGG, WAV | Audio player |
| Models | HYM | Metadata only |
- Select a file in the file list
- Preview appears in the right panel
- Use zoom controls for images
- Click Open Full for larger view
- Select the file
- Click Download button
- File downloads to your browser
- Select multiple files (Ctrl+Click)
- Click Download Selected
- Files are zipped and downloaded
- Right-click on a folder
- Select Download as ZIP
- Folder contents are zipped and downloaded
| Method | Endpoint | Description |
|---|
| GET | /api/assets/status | Get extraction status |
| GET | /api/assets/browse?path= | List directory contents |
| GET | /api/assets/tree?path=&depth= | Get directory tree |
| GET | /api/assets/file?path= | Get file contents |
| POST | /api/assets/extract | Trigger asset extraction |
| DELETE | /api/assets/cache | Clear extracted assets |
| GET | /api/assets/search?q=&ext=&content=&limit= | Search assets |
| GET | /api/assets/download/* | Download file/folder |
| GET | /api/assets/items?q=&limit= | Search item list |
| GET | /api/assets/item-icon/:itemId | Get item icon (public) |
| GET | /api/assets/player-avatar | Get player avatar (public) |
| Parameter | Description | Example |
|---|
q | Search query | dragon |
ext | File extensions | png,jpg |
content | Search file contents | true |
limit | Max results | 100 |
regex | Use regex search | false |
glob | Use glob patterns | false |
"path": "/textures/blocks",
"modified": "2024-01-15T10:30:00Z"
| Permission | Description |
|---|
assets.view | Browse, view, and download assets |
assets.manage | Extract and manage assets |
- Extracted assets require approximately 2-3 GB of disk space
- Assets are stored in
/opt/hytale/data/assets/
- Re-extraction overwrites existing files
- Consider backup before major extractions
- Check available disk space
- Verify server files are complete
- Check container logs for errors:
docker-compose logs hytale
- Check file format is supported
- Large files may take time to load
- Clear browser cache
- Ensure assets are extracted
- Check search syntax
- Try broader search terms
