Enhance resourcepack/texture/missing.md with full diagnostic documentation

[Copilot]

resourcepack/texture/missing.md was a stub with only the error code. This fills it out with everything needed to understand, locate, and fix the diagnostic.

Changes

• Severity — explicitly stated as Error
• Error message — documents the exact emitted string: Cannot find file: <texture_path>
• Description — explains how the diagnoser resolves texture paths (glob scan, extension stripping, vanilla texture allowlist)
• Contexts — all five triggering file types documented: Texture Atlas (terrain_texture.json, item_texture.json), Flipbook Texture Atlas (flipbook_textures.json), Resource Pack Entities (.entity.json), Attachables, and Particles
• Example — terrain_texture.json snippet with a missing texture path
• How to fix — reference paths must omit the file extension; accepted formats are .tga, .png, .jpg, .jpeg

Original prompt

Enhance the resourcepack/texture/missing.md document

The current file at resourcepack/texture/missing.md (blob SHA: 3e132a1488364341fee4d2a09479889cfe50d1de) is a stub:

# Texture - Missing

`resourcepack.texture.missing`

It needs to be enhanced with detailed documentation based on the source code in Blockception/minecraft-bedrock-language-server. Here is what the research of the source code revealed:

What triggers this diagnostic

The diagnostic code resourcepack.texture.missing is an error-level diagnostic emitted by the texture_files_diagnose function in packages/bedrock-diagnoser/src/diagnostics/resource-pack/texture-atlas/entry.ts.

The error message is: Cannot find file: {texture_path}

The diagnostic is raised when a texture path referenced in a resource pack definition cannot be resolved to an actual texture file on disk. The diagnoser scans for files matching **/textures/**/*.{tga,png,jpg,jpeg} within the resource pack folder, strips file extensions for comparison, and checks if any file path ends with the referenced texture path (also stripped of its extension and URI-encoded). If no match is found and the texture is not a known vanilla/education-edition built-in texture, the error is reported.

Contexts where this diagnostic is triggered

The texture_files_diagnose function is called from five different resource pack diagnostic contexts:

1. Texture Atlas files (terrain_texture.json, item_texture.json) — Each entry in texture_data is checked. Supports string paths, arrays of paths, and detailed texture specs with path and variations fields.

2. Flipbook Texture Atlas (flipbook_textures.json) — Each flipbook_texture path in the array is verified against actual texture files.

3. Resource Pack Entities (.entity.json) — All texture definitions in minecraft:client_entity.description.textures are checked to ensure the referenced texture files exist.

4. Attachables — All texture definitions in minecraft:attachable.description.textures are verified against actual files.

5. Particles — The basic_render_parameters.texture path in particle definitions is checked against texture files in the pack.

How to fix

Ensure the referenced texture file actually exists at the specified path within the resource pack's textures/ folder. Accepted file formats are .tga, .png, .jpg, and .jpeg. The path should be specified without the file extension (e.g., textures/blocks/stone not textures/blocks/stone.png).

---

Please update the file resourcepack/texture/missing.md with comprehensive documentation following the patterns used by other error code documents in this repository. The document should include:

• The error code
• A description of what the diagnostic means
• The contexts / file types where it can appear (listed above)
• An example of the error message (Cannot find file: <texture_path>)
• How to fix it (ensure the texture file exists at the referenced path, use correct format, no file extension in the path reference)
• The severity level (error)
• Supported texture file formats (.tga, .png, .jpg, .jpeg)

The following is the prior conversation context from the user's chat exploration (may be truncated):

User: Can you enchance this document, using the source code as reference

Assistant:

Let me start by researching the source code to understand how this error code is used, so I can enhance the documentation accurately.

Assistant: Now let me also look at the entity document diagnostics to see the texture checking there:

Assistant: Now I have a thorough understanding of the diagnostic code. Let me prepare the enhanced document and create the PR.

Assistant: I've kicked off a pull request to enhance the resourcepack/texture/missing.md document in Blockception/Minecraft-Error-Codes. We're waiting for your confirmation to proceed with creating the PR. Please accept or reject the pending tool call to continue.

This pull request was created from Copilot chat.