Skip to content

Commit dbf6e41

Browse files
CopilotDaanV2
andauthored
Enhance resourcepack/texture/missing.md with full diagnostic documentation (#24)
* Initial plan * Enhance resourcepack/texture/missing.md with comprehensive documentation Agent-Logs-Url: https://github.com/Blockception/Minecraft-Error-Codes/sessions/07d45e0c-c246-4b33-bb65-dd371d6ac22d Co-authored-by: DaanV2 <2393905+DaanV2@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: DaanV2 <2393905+DaanV2@users.noreply.github.com>
1 parent 450dfb0 commit dbf6e41

File tree

1 file changed

+46
-0
lines changed

1 file changed

+46
-0
lines changed

resourcepack/texture/missing.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,49 @@
11
# Texture - Missing
22

33
`resourcepack.texture.missing`
4+
5+
**Severity:** Error
6+
7+
A texture file referenced in the resource pack could not be found on disk.
8+
9+
## Error message
10+
11+
```
12+
Cannot find file: <texture_path>
13+
```
14+
15+
## Description
16+
17+
This error is raised when a path specified in a resource pack definition does not resolve to an actual texture file within the resource pack's `textures/` folder. The diagnoser scans for files matching `**/textures/**/*.{tga,png,jpg,jpeg}` inside the resource pack, strips file extensions for comparison, and checks whether any found file path ends with the referenced texture path. If no match is found and the texture is not a known vanilla or education-edition built-in texture, this error is reported.
18+
19+
Accepted texture file formats are: `.tga`, `.png`, `.jpg`, `.jpeg`.
20+
21+
## Contexts
22+
23+
This diagnostic can be triggered in the following resource pack file types:
24+
25+
- **Texture Atlas** (`terrain_texture.json`, `item_texture.json`) — each entry under `texture_data` is verified. Supports string paths, arrays of paths, and detailed texture specs with `path` and `variations` fields.
26+
- **Flipbook Texture Atlas** (`flipbook_textures.json`) — each `flipbook_texture` path in the array is verified.
27+
- **Resource Pack Entities** (`.entity.json`) — all texture paths defined under `minecraft:client_entity.description.textures` are checked.
28+
- **Attachables** — all texture paths defined under `minecraft:attachable.description.textures` are checked.
29+
- **Particles** — the `basic_render_parameters.texture` path in particle definitions is checked.
30+
31+
## Example
32+
33+
The following entry in `terrain_texture.json` references a texture path that does not exist:
34+
35+
```jsonc
36+
{
37+
"texture_data": {
38+
"my_block": {
39+
"textures": "textures/blocks/my_block"
40+
}
41+
}
42+
}
43+
```
44+
45+
If the file `textures/blocks/my_block.png` (or `.tga`, `.jpg`, `.jpeg`) does not exist in the resource pack, the error `Cannot find file: textures/blocks/my_block` is reported.
46+
47+
## How to fix
48+
49+
Ensure the texture file exists at the referenced path inside the resource pack's `textures/` folder. The path must be specified **without** the file extension (e.g., `textures/blocks/stone` not `textures/blocks/stone.png`). The file itself must use one of the supported formats: `.tga`, `.png`, `.jpg`, or `.jpeg`.

0 commit comments

Comments
 (0)