Bedrock UI Navigator

A VS Code extension that provides intelligent navigation for Minecraft Bedrock Edition UI JSON files. Navigate between UI namespaces and panels with clickable links.

Features

• Smart Link Detection: Automatically detects UI references in JSON files
• Two-Part Navigation: Click namespace or panel parts separately
• Multiple Format Support: Handles both namespace.panel and [email protected]_name formats
• Workspace Integration: Searches local workspace first, then falls back to CDN
• Caching: Downloads are cached to avoid repeated fetching
• Tab Management: Reuses already opened files instead of duplicates

Supported Formats

The extension recognizes these UI reference patterns:

1. Standard Format: namespace.panel

   • Click namespace → Go to namespace file
   • Click panel → Go to specific panel definition

2. Extended Format: [email protected]_name

   • Click namespace → Go to namespace file
   • Click panel_name → Go to specific panel definition

3. With Extensions: namespace.panel@extension or [email protected]_name@extension

Usage

1. Install the extension
2. Open any Bedrock UI JSON file containing UI references
3. Hover over the references - they'll appear as clickable links
4. Ctrl+Click (or Cmd+Click on Mac) to navigate
5. Links are only shown in files that contain a "namespace" declaration

Example

{
  "namespace": "my_ui",
  "button": {
    "panel": "common.base_panel"
  },
  "chest": {
    "screen": "[email protected]_screen_common"
  }
}

In this example:

• common.base_panel creates links for common and base_panel
• [email protected]_screen_common creates links for common and inventory_screen_common

How It Works

1. Local Search First: Searches your workspace for files with matching namespaces
2. CDN Fallback: If not found locally, fetches from Mojang's Bedrock samples CDN
3. Smart Caching: Downloaded files are cached in your temp directory
4. Tab Awareness: Reuses existing tabs instead of opening duplicates

Requirements

• VS Code 1.85.0 or higher
• JSON/JSONC files with "namespace" declarations

Extension Settings

This extension contributes no settings currently.

Commands

This extension contributes the following commands (automatically triggered by clicking links):

• bedrockUI.gotoNamespace - Navigate to a namespace file
• bedrockUI.gotoPanel - Navigate to a specific panel within a namespace

Troubleshooting

Links Not Appearing

• Ensure your JSON file contains a "namespace" declaration
• Check that you're in a JSON or JSONC file
• Try restarting VS Code after installation

Extension Not Activating

• Open VS Code Developer Tools (Help → Toggle Developer Tools)
• Check console for error messages
• Ensure the extension is properly installed

Performance Issues

• The extension caches downloaded files automatically
• Large workspaces may take a moment to search initially

Development

Building

npm install
npm run compile
npm run package

Testing

1. Install the packaged VSIX: code --install-extension bedrock-ui-navigator-1.0.0.vsix
2. Open test JSON files with UI references
3. Verify links appear and navigate correctly

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

License

MIT License - see LICENSE file for details.

Changelog

1.0.0

• Initial release
• Support for namespace.panel and [email protected]_name formats
• Workspace search with CDN fallback
• File caching and tab management
• Smart link detection in JSON files with namespace declarations

Credits

• Uses UI mappings from Mojang's Bedrock Samples
• Built with TypeScript for VS Code extension API