# honeypie3301/mcreator-java-to-block-translator architecture

> Architecture diagram of the GitHub repository honeypie3301/mcreator-java-to-block-translator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/honeypie3301/mcreator-java-to-block-translator
- Repository: https://github.com/honeypie3301/mcreator-java-to-block-translator

## Overview

This browser-based translator takes Java source plus an MCreator element type and NeoForge version, converts it into a visual block representation and Blockly XML, and lets users inspect mappings and export templates or images. Its principal stages are input/configuration, conversion, and review/export; the block catalog and element configuration are supporting internal layers. The README documents exports and conversion targets; unsampled wiring is not inferred beyond documented behavior.

Main entry points: [`src/App.tsx`](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/App.tsx) (Translator app), [`src/components/Header.tsx`](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/Header.tsx) (Target selectors), [`src/components/JavaEditorPanel.tsx`](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/JavaEditorPanel.tsx) (Java input), [`src/lib/mcreatorConverter.ts`](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/lib/mcreatorConverter.ts) (Java converter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Translation Workflow"]
  node_app["Translator app<br/>[App.tsx]"]
  node_java_editor["Java input"]
  node_header["Target selectors<br/>[Header.tsx]"]
  node_dropdown["Dropdown control<br/>[CustomDropdown.tsx]"]
  node_converter["Java converter"]
end

subgraph group_review["Review and Export"]
  node_visual["Visual block preview"]
  node_xml_viewer["Blockly XML view"]
  node_spec_panel["Element specification"]
  node_breakdown["Line mapping<br/>[BreakdownTable.tsx]"]
end

subgraph group_catalog["Block Catalog and Configuration"]
  node_element_config["Element formats<br/>[elementConfigs.ts]"]
  node_block_db[("MCreator block catalog")]
  node_block_library["Block registry browser"]
end

node_java_user(("Java author"))
node_mcreator(("MCreator workspace"))
node_template_export["Template files"]
node_image_export["Image files"]

node_java_user -->|"enters Java"| node_java_editor
node_java_editor -->|"submits input"| node_app
node_header -->|"sets target"| node_app
node_header -->|"uses selector"| node_dropdown
node_app -->|"invokes conversion"| node_converter
node_converter -->|"uses formats"| node_element_config
node_app -->|"renders preview"| node_visual
node_app -->|"renders XML"| node_xml_viewer
node_app -->|"renders specification"| node_spec_panel
node_app -->|"renders line mapping"| node_breakdown
node_app -->|"opens registry"| node_block_library
node_block_library -->|"searches catalog"| node_block_db
node_spec_panel -->|"references catalog"| node_block_db
node_app -->|"exports templates"| node_template_export
node_app -->|"exports images"| node_image_export
node_template_export -->|"imports into"| node_mcreator
node_xml_viewer -->|"copies XML to"| node_mcreator

click node_app "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/App.tsx"
click node_java_editor "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/JavaEditorPanel.tsx"
click node_header "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/Header.tsx"
click node_dropdown "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/CustomDropdown.tsx"
click node_converter "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/lib/mcreatorConverter.ts"
click node_element_config "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/data/elementConfigs.ts"
click node_block_db "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/data/mcreatorBlocksDatabase.ts"
click node_block_library "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/BlockLibraryModal.tsx"
click node_visual "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/VisualBlockCanvas.tsx"
click node_xml_viewer "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/BlocklyXmlViewer.tsx"
click node_spec_panel "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/ProcedureSpecPanel.tsx"
click node_breakdown "https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/BreakdownTable.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_java_editor,node_header,node_dropdown,node_converter toneBlue
class node_visual,node_xml_viewer,node_spec_panel,node_breakdown toneAmber
class node_element_config,node_block_db,node_block_library toneMint
class node_java_user,node_mcreator,node_template_export,node_image_export toneIndigo
```

## Components

### Translation Workflow

- [Translator app](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/App.tsx): `src/App.tsx`
- [Java input](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/JavaEditorPanel.tsx): `src/components/JavaEditorPanel.tsx`
- [Target selectors](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/Header.tsx): `src/components/Header.tsx`
- [Dropdown control](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/CustomDropdown.tsx): `src/components/CustomDropdown.tsx`
- [Java converter](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/lib/mcreatorConverter.ts): `src/lib/mcreatorConverter.ts`

### Review and Export

- [Visual block preview](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/VisualBlockCanvas.tsx): `src/components/VisualBlockCanvas.tsx`
- [Blockly XML view](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/BlocklyXmlViewer.tsx): `src/components/BlocklyXmlViewer.tsx`
- [Element specification](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/ProcedureSpecPanel.tsx): `src/components/ProcedureSpecPanel.tsx`
- [Line mapping](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/BreakdownTable.tsx): `src/components/BreakdownTable.tsx`

### Block Catalog and Configuration

- [Element formats](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/data/elementConfigs.ts): `src/data/elementConfigs.ts`
- [MCreator block catalog](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/data/mcreatorBlocksDatabase.ts): `src/data/mcreatorBlocksDatabase.ts`
- [Block registry browser](https://github.com/honeypie3301/mcreator-java-to-block-translator/blob/main/src/components/BlockLibraryModal.tsx): `src/components/BlockLibraryModal.tsx`

### Other components

- **Java author**
- **MCreator workspace**
- **Template files**
- **Image files**

## Connections

- Java author → Java input: enters Java (evidence: `README.md`)
- Java input → Translator app: submits input (evidence: `src/App.tsx`)
- Target selectors → Translator app: sets target (evidence: `src/App.tsx`)
- Target selectors → Dropdown control: uses selector (evidence: `src/components/Header.tsx`)
- Translator app → Java converter: invokes conversion (evidence: `src/App.tsx`)
- Java converter → Element formats: uses formats (evidence: `src/lib/mcreatorConverter.ts`)
- Translator app → Visual block preview: renders preview (evidence: `src/App.tsx`)
- Translator app → Blockly XML view: renders XML (evidence: `src/App.tsx`)
- Translator app → Element specification: renders specification (evidence: `src/App.tsx`)
- Translator app → Line mapping: renders line mapping (evidence: `src/App.tsx`)
- Translator app → Block registry browser: opens registry (evidence: `src/App.tsx`)
- Block registry browser → MCreator block catalog: searches catalog (evidence: `src/components/BlockLibraryModal.tsx`)
- Element specification → MCreator block catalog: references catalog (evidence: `src/components/ProcedureSpecPanel.tsx`)
- Translator app → Template files: exports templates (evidence: `README.md`)
- Translator app → Image files: exports images (evidence: `README.md`)
- Template files → MCreator workspace: imports into (evidence: `README.md`)
- Blockly XML view → MCreator workspace: copies XML to (evidence: `README.md`)
