|
1 | 1 | # Minecraft-Error-Codes |
2 | | - |
3 | | -Documentation for error codes generated by the [Blockception Minecraft Bedrock Language Server](https://github.com/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. |
4 | | - |
5 | | -## How Error Code URLs Work |
6 | | - |
7 | | -String error codes use dots as separators and map directly to file paths in this repository: |
8 | | - |
9 | | -``` |
10 | | -behaviorpack.entity.event.missing |
11 | | -→ behaviorpack/entity/event/missing.md |
12 | | -``` |
13 | | - |
14 | | -Numeric error codes link to the [codes/main.md](./codes/main.md) page with a fragment anchor. |
15 | | - |
16 | | -## Error Code Naming Convention |
17 | | - |
18 | | -Error codes follow the pattern `<category>.<subcategory>.<type>.<detail>`: |
19 | | - |
20 | | -- **category** — The top-level area: `behaviorpack`, `resourcepack`, `minecraft`, `general`, `json`, `molang`, `project`, `debugger` |
21 | | -- **subcategory** — The specific pack section or feature area (e.g., `entity`, `block`, `mcfunction`) |
22 | | -- **type** — The kind of issue (e.g., `missing`, `invalid`, `deprecated`) |
23 | | -- **detail** — Optional further specificity (e.g., `components`, `event`) |
24 | | - |
25 | | -## Severity Levels |
26 | | - |
27 | | -| Severity | Description | |
28 | | -|---|---| |
29 | | -| **error** | The content is invalid and will not work correctly in Minecraft | |
30 | | -| **warning** | The content uses deprecated or discouraged features that may stop working | |
31 | | -| **info** | Informational notice about the content | |
32 | | -| **hint** | A suggestion for improvement (e.g., performance optimizations) | |
| 2 | +The pages for errors codes that can be generated by a diagnoser and referenced |
33 | 3 |
|
34 | 4 | ## Categories |
35 | | - |
36 | | -- [behaviorpack](./behaviorpack/README.md) — Behavior pack errors (entities, blocks, functions, biomes, etc.) |
37 | | -- [codes](./codes/main.md) — Numeric diagnostic codes |
38 | | -- [debugger](./debugger/) — Internal language server diagnostic errors |
39 | | -- [diagnostics](./diagnostics/) — Diagnostic component errors |
40 | | -- [general](./general/) — General value type errors (strings, integers, floats, booleans) |
41 | | -- [json](./json/) — JSON parsing and structure errors |
42 | | -- [minecraft](./minecraft/) — Minecraft-specific errors (selectors, commands, modes, format versions) |
43 | | -- [molang](./molang/) — Molang expression errors and optimizations |
44 | | -- [project](./project/) — Project configuration errors |
45 | | -- [resourcepack](./resourcepack/README.md) — Resource pack errors (animations, entities, sounds, textures, etc.) |
46 | | - |
47 | | -## Common Error Codes Quick Reference |
48 | | - |
49 | | -### General |
50 | | -| Code | Description | |
51 | | -|---|---| |
52 | | -| [`general.string.invalid`](./general/string/invalid.md) | Invalid Minecraft string (e.g., unquoted spaces) | |
53 | | -| [`general.integer.invalid`](./general/integer/invalid.md) | Value is not a valid integer | |
54 | | -| [`general.integer.minimum`](./general/integer/minimum.md) | Integer below the minimum allowed value | |
55 | | -| [`general.integer.maximum`](./general/integer/maximum.md) | Integer above the maximum allowed value | |
56 | | -| [`general.float.invalid`](./general/float/invalid.md) | Value is not a valid float | |
57 | | -| [`general.boolean.invalid`](./general/boolean/invalid.md) | Value is not a valid boolean | |
58 | | - |
59 | | -### JSON |
60 | | -| Code | Description | |
61 | | -|---|---| |
62 | | -| [`json.invalid`](./json/invalid.md) | Invalid JSON structure or syntax | |
63 | | - |
64 | | -### Minecraft |
65 | | -| Code | Description | |
66 | | -|---|---| |
67 | | -| [`minecraft.format_version`](./minecraft/format_version.md) | Format version is missing, invalid, or outdated | |
68 | | -| [`minecraft.selector.invalid`](./minecraft/selector/invalid.md) | Invalid target selector | |
69 | | -| [`minecraft.commands.<cmd>.syntax`](./minecraft/commands/syntax.md) | Command syntax error | |
70 | | -| [`minecraft.commands.<cmd>.obsolete`](./minecraft/commands/obsolete.md) | Obsolete command syntax | |
71 | | - |
72 | | -### Behavior Pack |
73 | | -| Code | Description | |
74 | | -|---|---| |
75 | | -| [`behaviorpack.mcfunction.empty`](./behaviorpack/mcfunction/empty.md) | Empty mcfunction file | |
76 | | -| [`behaviorpack.functions.missing`](./behaviorpack/functions/missing.md) | Cannot find function definition | |
77 | | -| [`behaviorpack.entities.missing`](./behaviorpack/entities/missing.md) | Cannot find entity definition | |
78 | | -| [`behaviorpack.entity.event.missing`](./behaviorpack/entity/event/missing.md) | Entity event not defined | |
79 | | -| [`behaviorpack.entity.permutations`](./behaviorpack/entity/permutations.md) | Deprecated entity permutations | |
80 | | -| [`behaviorpack.entity.aliases`](./behaviorpack/entity/aliases.md) | Deprecated entity aliases | |
81 | | -| [`behaviorpack.entity.components.deprecated`](./behaviorpack/entity/components/deprecated.md) | Deprecated entity component | |
82 | | -| [`behaviorpack.block.components.deprecated`](./behaviorpack/block/components/deprecated.md) | Deprecated block component | |
83 | | -| [`behaviorpack.biome.components.deprecated`](./behaviorpack/biome/components/deprecated.md) | Deprecated biome component | |
84 | | - |
85 | | -### Resource Pack |
86 | | -| Code | Description | |
87 | | -|---|---| |
88 | | -| [`resourcepack.animation.missing`](./resourcepack/animation/missing.md) | Cannot find animation definition | |
89 | | -| [`resourcepack.entities.missing`](./resourcepack/entities/missing.md) | Cannot find resource pack entity definition | |
90 | | - |
91 | | -### Molang |
92 | | -| Code | Description | |
93 | | -|---|---| |
94 | | -| [`molang.optimization.constant-folding`](./molang/optimization/constant-folding.md) | Constant expression can be pre-calculated | |
95 | | - |
96 | | -### Internal |
97 | | -| Code | Description | |
98 | | -|---|---| |
99 | | -| [`debugger.internal.exception`](./debugger/internal/exception.md) | Internal language server exception | |
100 | | -| [`project.settings`](./project/settings.md) | Project configuration issue | |
| 5 | +- [behaviorpack](./behaviorpack/README.md) |
| 6 | +- [codes](./codes/README.md) |
| 7 | +- [debugger](./debugger/README.md) |
| 8 | +- [diagnostics](./diagnostics/README.md) |
| 9 | +- [general](./general/README.md) |
| 10 | +- [json](./json/README.md) |
| 11 | +- [minecraft](./minecraft/README.md) |
| 12 | +- [molang](./molang/README.md) |
| 13 | +- [project](./project/README.md) |
| 14 | +- [resourcepack](./resourcepack/README.md) |
101 | 15 |
|
102 | 16 | ## Documents |
103 | | -- [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) |
104 | | -- [CONTRIBUTING](CONTRIBUTING.md) |
| 17 | +- [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) |
| 18 | +- [CONTRIBUTING](CONTRIBUTING.md) |
0 commit comments