# toolbox4minecraft/amidst architecture

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

- Interactive diagram: https://gitdiagram.com/toolbox4minecraft/amidst
- Repository: https://github.com/toolbox4minecraft/amidst

## Overview

Amidst is a desktop Minecraft world-map explorer: a user selects a launcher profile or supplies seed/version options, then views a generated world overview and can inspect or export map information. The README documents biome, slime-chunk, End-island, structure, save-game, and image-export capabilities. The sampled sources show application setup and fragment/layer management, but not the complete world-generation and rendering call chain; those links are marked unverified rather than asserted.

Main entry points: [`src/main/java/amidst/Application.java`](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/Application.java) (Application startup), [`src/main/java/amidst/mojangapi/world/World.java`](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/world/World.java) (World model), [`src/main/java/amidst/gui/main/viewer/Viewer.java`](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/main/viewer/Viewer.java) (World viewer), [`src/main/java/amidst/mojangapi/LauncherProfileRunner.java`](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/LauncherProfileRunner.java) (Launcher profile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and profiles"]
  node_application["Application startup<br/>[Application.java]"]
  node_profileui["Profile selection"]
  node_profile["Launcher profile"]
  node_mainui["Main window<br/>[MainWindow.java]"]
end

subgraph group_world["World data and generation"]
  node_worldbuilder["World builder<br/>[WorldBuilder.java]"]
  node_minecraftinterface["Minecraft interface"]
  node_world["World model<br/>[World.java]"]
  node_structure["Structure producers"]
  node_oracles["Biome and chunk oracles"]
  node_savegame["Save game data"]
end

subgraph group_map["Map rendering"]
  node_viewer["World viewer<br/>[Viewer.java]"]
  node_translator["Screen translator"]
  node_fragmentmanager["Fragment manager"]
  node_fragment["Map fragments<br/>[Fragment.java]"]
  node_layers["Layer management<br/>[LayerManager.java]"]
  node_layerloaders["Layer loaders"]
  node_drawers["Map drawing"]
end

subgraph group_features["Map features and export"]
  node_biomeui["Biome display"]
  node_biomeexport["Biome export<br/>[BiomeExporter.java]"]
  node_settings["Biome profiles<br/>[BiomeProfile.java]"]
end

subgraph group_services["Supporting services"]
  node_playerinfo["Player information"]
  node_workers["Worker executor"]
  node_logging["Logging<br/>[AmidstLogger.java]"]
end

node_user(("User"))
node_mojang{{"Mojang web services"}}

node_user -.->|"starts"| node_application
node_application -->|"runs profile"| node_profile
node_application -->|"opens selector"| node_profileui
node_application -->|"opens window"| node_mainui
node_profile -.->|"builds world"| node_worldbuilder
node_worldbuilder -.->|"uses version adapter"| node_minecraftinterface
node_worldbuilder -.->|"creates model"| node_world
node_world -->|"holds producers"| node_structure
node_world -->|"holds oracles"| node_oracles
node_profile -.->|"uses save game"| node_savegame
node_user -.->|"views map"| node_viewer
node_viewer -.->|"converts coordinates"| node_translator
node_translator -->|"reads graph corner"| node_fragment
node_fragmentmanager -->|"requests fragments"| node_fragment
node_fragmentmanager -->|"creates processor"| node_layers
node_layers -->|"loads layers"| node_layerloaders
node_layers -->|"provides drawers"| node_drawers
node_viewer -.->|"requests map data"| node_fragmentmanager
node_fragment -.->|"supplies layer images"| node_drawers
node_world -.->|"renders overview"| node_viewer
node_user -.->|"inspects biomes"| node_biomeui
node_user -->|"exports map"| node_biomeexport
node_user -->|"opens save"| node_savegame
node_user -.->|"selects profile"| node_settings
node_playerinfo -.->|"fetches player data"| node_mojang
node_application -.->|"creates worker executor"| node_workers
node_application -.->|"uses logging"| node_logging

click node_application "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/Application.java"
click node_profileui "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/profileselect/ProfileSelectWindow.java"
click node_profile "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/LauncherProfileRunner.java"
click node_mainui "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/main/MainWindow.java"
click node_worldbuilder "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/world/WorldBuilder.java"
click node_minecraftinterface "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/minecraftinterface/MinecraftInterfaces.java"
click node_world "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/world/World.java"
click node_structure "https://github.com/toolbox4minecraft/amidst/tree/master/src/main/java/amidst/mojangapi/world/icon/producer"
click node_oracles "https://github.com/toolbox4minecraft/amidst/tree/master/src/main/java/amidst/mojangapi/world/oracle"
click node_savegame "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/file/service/SaveDirectoryService.java"
click node_viewer "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/main/viewer/Viewer.java"
click node_translator "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/main/viewer/FragmentGraphToScreenTranslator.java"
click node_fragmentmanager "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/fragment/FragmentManager.java"
click node_fragment "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/fragment/Fragment.java"
click node_layers "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/fragment/layer/LayerManager.java"
click node_layerloaders "https://github.com/toolbox4minecraft/amidst/tree/master/src/main/java/amidst/fragment/loader"
click node_drawers "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/fragment/drawer/FragmentDrawer.java"
click node_biomeui "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/main/viewer/BiomeSelection.java"
click node_biomeexport "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/export/BiomeExporter.java"
click node_settings "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/settings/biomeprofile/BiomeProfile.java"
click node_playerinfo "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/file/service/PlayerInformationService.java"
click node_workers "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/threading/WorkerExecutor.java"
click node_logging "https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/logging/AmidstLogger.java"

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_application,node_profileui,node_profile,node_mainui,node_user toneBlue
class node_worldbuilder,node_minecraftinterface,node_world,node_structure,node_oracles,node_savegame toneAmber
class node_viewer,node_translator,node_fragmentmanager,node_fragment,node_layers,node_layerloaders,node_drawers toneMint
class node_biomeui,node_biomeexport,node_settings toneRose
class node_playerinfo,node_workers,node_logging,node_mojang toneIndigo
```

## Components

### Application and profiles

- [Application startup](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/Application.java): `src/main/java/amidst/Application.java`
- [Profile selection](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/profileselect/ProfileSelectWindow.java): `src/main/java/amidst/gui/profileselect/ProfileSelectWindow.java`
- [Launcher profile](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/LauncherProfileRunner.java): `src/main/java/amidst/mojangapi/LauncherProfileRunner.java`
- [Main window](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/main/MainWindow.java): `src/main/java/amidst/gui/main/MainWindow.java`

### World data and generation

- [World builder](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/world/WorldBuilder.java): `src/main/java/amidst/mojangapi/world/WorldBuilder.java`
- [Minecraft interface](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/minecraftinterface/MinecraftInterfaces.java): `src/main/java/amidst/mojangapi/minecraftinterface/MinecraftInterfaces.java`
- [World model](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/world/World.java): `src/main/java/amidst/mojangapi/world/World.java`
- [Structure producers](https://github.com/toolbox4minecraft/amidst/tree/master/src/main/java/amidst/mojangapi/world/icon/producer): `src/main/java/amidst/mojangapi/world/icon/producer`
- [Biome and chunk oracles](https://github.com/toolbox4minecraft/amidst/tree/master/src/main/java/amidst/mojangapi/world/oracle): `src/main/java/amidst/mojangapi/world/oracle`
- [Save game data](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/file/service/SaveDirectoryService.java): `src/main/java/amidst/mojangapi/file/service/SaveDirectoryService.java`

### Map rendering

- [World viewer](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/main/viewer/Viewer.java): `src/main/java/amidst/gui/main/viewer/Viewer.java`
- [Screen translator](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/main/viewer/FragmentGraphToScreenTranslator.java): `src/main/java/amidst/gui/main/viewer/FragmentGraphToScreenTranslator.java`
- [Fragment manager](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/fragment/FragmentManager.java): `src/main/java/amidst/fragment/FragmentManager.java`
- [Map fragments](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/fragment/Fragment.java): `src/main/java/amidst/fragment/Fragment.java`
- [Layer management](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/fragment/layer/LayerManager.java): `src/main/java/amidst/fragment/layer/LayerManager.java`
- [Layer loaders](https://github.com/toolbox4minecraft/amidst/tree/master/src/main/java/amidst/fragment/loader): `src/main/java/amidst/fragment/loader`
- [Map drawing](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/fragment/drawer/FragmentDrawer.java): `src/main/java/amidst/fragment/drawer/FragmentDrawer.java`

### Map features and export

- [Biome display](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/main/viewer/BiomeSelection.java): `src/main/java/amidst/gui/main/viewer/BiomeSelection.java`
- [Biome export](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/gui/export/BiomeExporter.java): `src/main/java/amidst/gui/export/BiomeExporter.java`
- [Biome profiles](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/settings/biomeprofile/BiomeProfile.java): `src/main/java/amidst/settings/biomeprofile/BiomeProfile.java`

### Supporting services

- [Player information](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/mojangapi/file/service/PlayerInformationService.java): `src/main/java/amidst/mojangapi/file/service/PlayerInformationService.java`
- [Worker executor](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/threading/WorkerExecutor.java): `src/main/java/amidst/threading/WorkerExecutor.java`
- [Logging](https://github.com/toolbox4minecraft/amidst/blob/master/src/main/java/amidst/logging/AmidstLogger.java): `src/main/java/amidst/logging/AmidstLogger.java`

### Other components

- **User**
- **Mojang web services**

## Connections

- User → Application startup: starts
- Application startup → Launcher profile: runs profile (evidence: `src/main/java/amidst/Application.java`)
- Application startup → Profile selection: opens selector (evidence: `src/main/java/amidst/Application.java`)
- Application startup → Main window: opens window (evidence: `src/main/java/amidst/Application.java`)
- Launcher profile → World builder: builds world
- World builder → Minecraft interface: uses version adapter
- World builder → World model: creates model
- World model → Structure producers: holds producers (evidence: `src/main/java/amidst/mojangapi/world/World.java`)
- World model → Biome and chunk oracles: holds oracles (evidence: `src/main/java/amidst/mojangapi/world/World.java`)
- Launcher profile → Save game data: uses save game
- User → World viewer: views map
- World viewer → Screen translator: converts coordinates
- Screen translator → Map fragments: reads graph corner (evidence: `src/main/java/amidst/gui/main/viewer/FragmentGraphToScreenTranslator.java`)
- Fragment manager → Map fragments: requests fragments (evidence: `src/main/java/amidst/fragment/FragmentManager.java`)
- Fragment manager → Layer management: creates processor (evidence: `src/main/java/amidst/fragment/FragmentManager.java`)
- Layer management → Layer loaders: loads layers (evidence: `src/main/java/amidst/fragment/layer/LayerManager.java`)
- Layer management → Map drawing: provides drawers (evidence: `src/main/java/amidst/fragment/layer/LayerManager.java`)
- World viewer → Fragment manager: requests map data
- Map fragments → Map drawing: supplies layer images (evidence: `src/main/java/amidst/fragment/drawer/FragmentDrawer.java`)
- World model → World viewer: renders overview
- User → Biome display: inspects biomes
- User → Biome export: exports map
- User → Save game data: opens save
- User → Biome profiles: selects profile
- Player information → Mojang web services: fetches player data
- Application startup → Worker executor: creates worker executor
- Application startup → Logging: uses logging
