MCTools Validation Rules Reference

This reference documents all validation rules used by Minecraft Creator Tools to check your add-on content. Each rule helps identify potential issues in your Minecraft content before deployment.

Validation Categories

Category	Description	Rules
Base Game Version	Validates base_game_version in world template manifests and checks that it...	9
Blocks Catalog	Validates blocks.json catalog files in resource packs. Checks for unused block...	4
Coop Item Naming	Validates individual content items against Cooperative Add-On naming...	17
Coop Add-On Requirements	A set of requirements for cooperative Add-On projects. See...	17
Beta Features	Validates that add-on content does not use beta features flags. The...	3
Deprecated Features	Checks for deprecated features, blocks, and textures that may be removed in...	4
Manifest Validation	Comprehensive validation of pack manifest.json files. Validates format version,...	35
Community JSON Schema Validation	Validates JSON files against their corresponding schemas based on item type....	1
Pack Icon	Validates behavior and resource pack icons (pack_icon.png) for correct format,...	4
Particle Identifiers	Validates particle effect identifiers for proper namespace formatting. Particle...	3
Skin Pack	Validates skin pack content including skins.json structure, skin textures,...	18
World Icon	Validates world template icons (world_icon.jpeg) for correct format, size, and...	4
Entity Type	Validates entity type definitions in behavior packs. Checks format_version...	12
Experimental Flags	Validates experimental flags in world templates. Experiments that were enabled...	3
Forbidden Files	Validates that packs only contain files with allowed extensions and do not...	4
Format Version	Validates format_version fields across various Minecraft JSON definition files...	45
Geometry Format	Validates model geometry files for format compatibility and restricted...	2
Model Geometry	Validates and analyzes model geometry files (.geo.json) for blocks, entities,...	4
Content Counts	Provides counts of various content types found in the project including packs,...	2
Item Types	Validates behavior pack item type definitions including format versions,...	12
JSON Schema Validation	Validates JSON files against official JSON schemas located at public/schemas....	1
JSON Form Structure Validation	Validates JSON files against Minecraft documentation-derived form schemas....	17
Content Tags	Tracks content types and component usage across JSON files in the project. Used...	11
Language Files	Validates that localization files (.lang) and the languages.json catalog are...	5
File Size/Lines	Aggregates file size and line count statistics for all project items, broken...	0
MC Functions	Validates .mcfunction files for correct command syntax and formatting....	2
Min Engine Version	Validates and updates the min_engine_version field in pack manifests. This...	18
BOM Validation	Validates that JSON files do not contain byte order marks (BOM). BOMs can cause...	1
Pack Manifest Info	Extracts and validates information from behavior pack and resource pack...	18
Pack Metadata Info	Extracts and validates a project summary.	23
Pack Size	Analyzes pack file sizes and counts to ensure content fits within platform...	9
Path Length	Validates file paths for length and format compatibility across platforms. Long...	3
Project Integrity	Validates the structural integrity of the project, checking for orphaned files...	2
Animation Analysis	Analyzes resource pack animation files to count animations and bone references....	2
Resource Pack Deps	Validates that resource pack dependencies declared in behavior pack manifests...	3
Script Analysis	Analyzes JavaScript/TypeScript script files to identify Minecraft Script API...	1
Script Modules	Validates script module dependencies in behavior pack manifests and...	6
Sharing Validation	Validates content for sharing and marketplace requirements. Identifies custom...	2
Sounds Definition	Validates sound_definitions.json files that define custom sounds for the...	4
Platform Validation	Validates content against strict platform requirements. Identifies cases where...	3
Project Summary	Provides high-level summary information about the project's manifests and pack...	2
Texture Validation	Validates texture references across entities, blocks, items, particles, and UI...	2
Texture Images	Analyzes texture image files (PNG, JPG, TGA) for dimensions, memory usage, and...	20
Texture References	Collects and aggregates all texture references from across the project...	1
Content Types	Aggregates information about all content types defined in the project including...	1
Unknown Files	Identifies files with unrecognized extensions that are not standard Minecraft...	1
Unknown JSON	Identifies JSON files that don't match any known Minecraft content schema....	1
Unlinked Items	Identifies content items that are defined but not referenced anywhere in the...	2
File Validation	Validates that content files are properly formatted and parseable. Catches JSON...	3
Vanilla Duplicates	Detects content that duplicates vanilla Minecraft files. Unnecessary copies...	2
VS Code Files	Validates VS Code configuration files (tasks.json, launch.json) in projects....	2
World Validation	Validates world-level settings including experiments, version requirements, and...	6
World Data	Analyzes world data including LevelDB chunks, command blocks, level.dat...	18
World Pack Refs	Validates pack references in world templates. Ensures that behavior_packs.json...	7

Understanding Severity Levels

Validation rules have different severity levels:

• 🔴 Error: Must be fixed. These issues will cause problems in Minecraft.
• 🟡 Warning: Should be reviewed. These may cause issues or indicate problems.
• 🔵 Recommendation: Consider addressing. These are best practices.
• ℹ️ Info: Informational. Aggregated data or neutral status.