How accurate is the validation?

For blocks, items, and NPCs, this tool validates JSON syntax and checks against known field names and types. However, Hytale files have varying structures that change between versions. For plugin manifests, it validates against the known plugin schema. Always test your content in-game as Hytale is in Early Access.

What do errors vs warnings mean?

Errors are critical issues that will prevent your JSON from working correctly (e.g., invalid syntax, missing required fields in strict schemas). Warnings are recommendations or potential issues (e.g., unusual values, missing recommended fields) that may not prevent functionality but could cause unexpected behavior.

Can I validate custom JSON structures?

The validator is designed specifically for Hytale JSON structures (blocks, items, NPCs, manifests). While it will check JSON syntax for any input, schema validation is limited to these four types. For custom structures, only basic JSON syntax validation will apply.

JSON Validator - Validate Hytale JSON Files

What is the JSON Validator?

The JSON Validator is a tool designed to help Hytale modders and server owners validate their JSON configuration files. It checks your JSON syntax and validates against known schemas for Block definitions, Item definitions, NPC/Entity definitions, and Plugin manifest files. This helps catch errors before you test your content in-game, saving time and preventing configuration issues.

Understanding Hytale JSON structures

Hytale uses JSON files extensively for defining game content. These files control everything from block properties to item behaviors, NPC configurations, and plugin metadata. Each type has specific fields and structures that must be followed for the game to recognize and use your content correctly.

Block Definitions

BlockType definitions control how blocks appear and behave in-game:

Required fields: DrawType, Material, Opacity
Common fields: Textures, BlockSoundSetId, HitboxType, IsUsable
Use case: Creating custom blocks for your mod or server

Item Definitions

Item definitions specify properties for in-game items:

Common fields: id, icon, maxStack, itemLevel
Type fields: weapon, armor, tool, consumable
Use case: Adding custom weapons, tools, or consumables

NPC/Entity Definitions

NPC definitions use an ECS-based structure for entities:

Common fields: id, name, type, health, speed
Components: ai, combat, behaviors
Use case: Creating custom creatures or NPCs

Plugin Manifests

Plugin manifest files define plugin metadata:

Required fields: Group, Name, Version, Main
Optional fields: Description, Authors, Dependencies
Use case: Creating Hytale plugins

How to use the JSON Validator

Using the JSON Validator is straightforward: select the schema type you're working with, paste or type your JSON, and click Validate. The tool will check syntax, required fields, and field types, then display any errors or warnings. You can load example JSON for each type to see the expected structure.

Step 1: Choose schema type

Select the type of JSON you're validating: Block, Item, NPC, or Manifest. This determines which validation rules are applied.

Step 2: Enter your JSON

Paste your JSON into the input field, or click "Load Example" to see a sample structure for the selected schema type.

Step 3: Validate and review

Click "Validate JSON" to check your file. Review errors (critical issues) and warnings (recommendations), then fix any issues before using your JSON in-game.

Frequently Asked Questions

You can validate four types of Hytale JSON files: Block definitions (BlockType), Item definitions, NPC/Entity definitions, and Plugin manifest files. Each type has its own schema with specific required fields and validation rules.

←Back to Server & Developer Tools

★

Other server & dev tools

Use these tools together to generate configs, whitelists, and project structures that work well with your validated JSON.

MOTD GeneratorDesign your server MOTD with color codes and formatting, with live preview and server.properties format.Server Config GeneratorGenerate server & world config.json files with presets, live JSON preview, and one-click download.Whitelist GeneratorCreate whitelist.json for your server by adding player usernames one by one or in bulk.Server Requirements CalculatorEstimate recommended RAM, CPU, storage, and bandwidth for your expected players and view distance.Hytale Username CheckerCheck whether a Hytale username is currently taken or appears available.Plugin & Mod Project GeneratorGenerate Hytale plugin or content project structures with Gradle, manifest, and example files.

JSON Validator