Skip to content

README.md

Latest commit

 

History

History
104 lines (83 loc) · 5.24 KB

README.md

File metadata and controls

104 lines (83 loc) · 5.24 KB
Raw

Minecraft-Error-Codes

Documentation for error codes generated by the Blockception Minecraft Bedrock Language Server. When you click on an error code in your IDE, you are directed to the corresponding page in this repository.

How Error Code URLs Work

String error codes use dots as separators and map directly to file paths in this repository:

behaviorpack.entity.event.missing
→ behaviorpack/entity/event/missing.md

Numeric error codes link to the codes/main.md page with a fragment anchor.

Error Code Naming Convention

Error codes follow the pattern <category>.<subcategory>.<type>.<detail>:

  • category — The top-level area: behaviorpack, resourcepack, minecraft, general, json, molang, project, debugger
  • subcategory — The specific pack section or feature area (e.g., entity, block, mcfunction)
  • type — The kind of issue (e.g., missing, invalid, deprecated)
  • detail — Optional further specificity (e.g., components, event)

Severity Levels

Severity Description
error The content is invalid and will not work correctly in Minecraft
warning The content uses deprecated or discouraged features that may stop working
info Informational notice about the content
hint A suggestion for improvement (e.g., performance optimizations)

Categories

  • behaviorpack — Behavior pack errors (entities, blocks, functions, biomes, etc.)
  • codes — Numeric diagnostic codes
  • debugger — Internal language server diagnostic errors
  • diagnostics — Diagnostic component errors
  • general — General value type errors (strings, integers, floats, booleans)
  • json — JSON parsing and structure errors
  • minecraft — Minecraft-specific errors (selectors, commands, modes, format versions)
  • molang — Molang expression errors and optimizations
  • project — Project configuration errors
  • resourcepack — Resource pack errors (animations, entities, sounds, textures, etc.)

Common Error Codes Quick Reference

General

Code Description
general.string.invalid Invalid Minecraft string (e.g., unquoted spaces)
general.integer.invalid Value is not a valid integer
general.integer.minimum Integer below the minimum allowed value
general.integer.maximum Integer above the maximum allowed value
general.float.invalid Value is not a valid float
general.boolean.invalid Value is not a valid boolean

JSON

Code Description
json.invalid Invalid JSON structure or syntax

Minecraft

Code Description
minecraft.format_version Format version is missing, invalid, or outdated
minecraft.selector.invalid Invalid target selector
minecraft.commands.<cmd>.syntax Command syntax error
minecraft.commands.<cmd>.obsolete Obsolete command syntax

Behavior Pack

Code Description
behaviorpack.mcfunction.empty Empty mcfunction file
behaviorpack.functions.missing Cannot find function definition
behaviorpack.entities.missing Cannot find entity definition
behaviorpack.entity.event.missing Entity event not defined
behaviorpack.entity.permutations Deprecated entity permutations
behaviorpack.entity.aliases Deprecated entity aliases
behaviorpack.entity.components.deprecated Deprecated entity component
behaviorpack.block.components.deprecated Deprecated block component
behaviorpack.biome.components.deprecated Deprecated biome component

Resource Pack

Code Description
resourcepack.animation.missing Cannot find animation definition
resourcepack.entities.missing Cannot find resource pack entity definition

Molang

Code Description
molang.optimization.constant-folding Constant expression can be pre-calculated

Internal

Code Description
debugger.internal.exception Internal language server exception
project.settings Project configuration issue

Documents