# codedinfinityflo/vextension architecture

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

- Interactive diagram: https://gitdiagram.com/codedinfinityflo/vextension
- Repository: https://github.com/codedinfinityflo/vextension

## Overview

Vextension is a modular JVM utility library for applications, command-line tools, and Minecraft server or proxy plugins. A user-facing command begins at a console or platform adapter, enters the shared command system, and is intended to be parsed and dispatched to registered handlers; the sampled abstract manager excerpt shows registration but leaves parseLine unimplemented. Common supplies reusable document, database, dependency, networking, and API utilities. The README documents the module capabilities; platform internals beyond sampled command adapters are represented at their exact enclosing directories, with no inferred call chains.

Main entry points: [`vextension-command/src/main/kotlin/eu/vironlab/vextension/command/AbstractCommandManager.kt`](https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/AbstractCommandManager.kt) (Command manager), [`vextension-command/src/main/kotlin/eu/vironlab/vextension/command/context/CommandContext.kt`](https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/context/CommandContext.kt) (Command context), [`vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/storage/JsonDocumentStorage.kt`](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/storage/JsonDocumentStorage.kt) (Document formats), [`vextension-common/src/main/kotlin/eu/vironlab/vextension/database/Database.kt`](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/database/Database.kt) (Database API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_commands["Command interfaces"]
  node_command_core["Command manager"]
  node_command_model["Command model<br/>[Command.kt]"]
  node_command_context["Command context<br/>[CommandContext.kt]"]
  node_command_source["Command source<br/>[CommandSource.kt]"]
end

subgraph group_common["Common utilities"]
  node_common_utils["Shared utilities<br/>[MultiReference.kt]"]
  node_documents["Documents<br/>[Document.kt]"]
  node_doc_management["Document management"]
  node_doc_storage["Document formats"]
  node_database["Database API<br/>[Database.kt]"]
  node_database_impl["Database backends"]
  node_dependencies["Dependency loading"]
  node_network["Network tasks<br/>[NetworkTask.kt]"]
  node_mojang["Mojang utilities<br/>[MojangWrapper.kt]"]
  node_vironlab_api["VironLab API<br/>[VironLabAPI.kt]"]
end

subgraph group_console["CLI"]
  node_console["Console input<br/>[Console.kt]"]
  node_cli_manager["CLI adapter"]
end

subgraph group_server["Minecraft server"]
  node_minecraft_server["Server utilities"]
  node_server_commands["Server commands"]
  node_server_ui["Inventory and UI<br/>[GUI.kt]"]
  node_server_items["Items and scoreboards<br/>[ItemStack.kt]"]
end

subgraph group_proxy["Minecraft proxy"]
  node_proxy["Proxy utilities"]
  node_proxy_commands["Proxy commands"]
end

node_user(("Console user"))

node_user -.->|"enters commands"| node_console
node_console -->|"provides input"| node_cli_manager
node_cli_manager -->|"adapts commands"| node_command_core
node_command_core -->|"registers commands"| node_command_model
node_command_core -->|"uses context"| node_command_context
node_command_core -->|"uses source"| node_command_source
node_command_context -->|"exposes source"| node_command_source
node_doc_management -->|"uses formats"| node_doc_storage
node_doc_storage -->|"reads and writes"| node_documents
node_database -->|"stores documents"| node_documents
node_database_impl -->|"implements API"| node_database
node_server_commands -->|"extends command system"| node_command_core
node_proxy_commands -->|"extends command system"| node_command_core

click node_console "https://github.com/codedinfinityflo/vextension/blob/main/vextension-cli/src/main/kotlin/eu/vironlab/vextension/console/Console.kt"
click node_cli_manager "https://github.com/codedinfinityflo/vextension/blob/main/vextension-cli/src/main/kotlin/eu/vironlab/vextension/command/ConsoleCommandManager.kt"
click node_command_core "https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/AbstractCommandManager.kt"
click node_command_model "https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/Command.kt"
click node_command_context "https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/context/CommandContext.kt"
click node_command_source "https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/source/CommandSource.kt"
click node_common_utils "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/collection/MultiReference.kt"
click node_documents "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/document/Document.kt"
click node_doc_management "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/DefaultDocumentManagement.kt"
click node_doc_storage "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/storage/JsonDocumentStorage.kt"
click node_database "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/database/Database.kt"
click node_database_impl "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/database/sql/AbstractSqlDatabase.kt"
click node_dependencies "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/dependency/DependencyLoader.kt"
click node_network "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/network/NetworkTask.kt"
click node_mojang "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/mojang/MojangWrapper.kt"
click node_vironlab_api "https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/vironlab/VironLabAPI.kt"
click node_minecraft_server "https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/bukkit/VextensionBukkit.kt"
click node_server_commands "https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/bukkit/command/BukkitCommandManager.kt"
click node_server_ui "https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/inventory/gui/GUI.kt"
click node_server_items "https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/item/ItemStack.kt"
click node_proxy "https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-proxy/src/main/kotlin/eu/vironlab/vextension/bungee/VextensionBungee.kt"
click node_proxy_commands "https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-proxy/src/main/kotlin/eu/vironlab/vextension/velocity/command/VelocityCommandManager.kt"

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_command_core,node_command_model,node_command_context,node_command_source,node_user toneBlue
class node_common_utils,node_documents,node_doc_management,node_doc_storage,node_database,node_database_impl,node_dependencies,node_network,node_mojang,node_vironlab_api toneAmber
class node_console,node_cli_manager toneMint
class node_minecraft_server,node_server_commands,node_server_ui,node_server_items toneRose
class node_proxy,node_proxy_commands toneIndigo
```

## Components

### Command interfaces

- [Command manager](https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/AbstractCommandManager.kt): `vextension-command/src/main/kotlin/eu/vironlab/vextension/command/AbstractCommandManager.kt`
- [Command model](https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/Command.kt): `vextension-command/src/main/kotlin/eu/vironlab/vextension/command/Command.kt`
- [Command context](https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/context/CommandContext.kt): `vextension-command/src/main/kotlin/eu/vironlab/vextension/command/context/CommandContext.kt`
- [Command source](https://github.com/codedinfinityflo/vextension/blob/main/vextension-command/src/main/kotlin/eu/vironlab/vextension/command/source/CommandSource.kt): `vextension-command/src/main/kotlin/eu/vironlab/vextension/command/source/CommandSource.kt`

### Common utilities

- [Shared utilities](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/collection/MultiReference.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/collection/MultiReference.kt`
- [Documents](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/document/Document.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/document/Document.kt`
- [Document management](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/DefaultDocumentManagement.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/DefaultDocumentManagement.kt`
- [Document formats](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/storage/JsonDocumentStorage.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/storage/JsonDocumentStorage.kt`
- [Database API](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/database/Database.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/database/Database.kt`
- [Database backends](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/database/sql/AbstractSqlDatabase.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/database/sql/AbstractSqlDatabase.kt`
- [Dependency loading](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/dependency/DependencyLoader.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/dependency/DependencyLoader.kt`
- [Network tasks](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/network/NetworkTask.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/network/NetworkTask.kt`
- [Mojang utilities](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/mojang/MojangWrapper.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/mojang/MojangWrapper.kt`
- [VironLab API](https://github.com/codedinfinityflo/vextension/blob/main/vextension-common/src/main/kotlin/eu/vironlab/vextension/vironlab/VironLabAPI.kt): `vextension-common/src/main/kotlin/eu/vironlab/vextension/vironlab/VironLabAPI.kt`

### CLI

- [Console input](https://github.com/codedinfinityflo/vextension/blob/main/vextension-cli/src/main/kotlin/eu/vironlab/vextension/console/Console.kt): `vextension-cli/src/main/kotlin/eu/vironlab/vextension/console/Console.kt`
- [CLI adapter](https://github.com/codedinfinityflo/vextension/blob/main/vextension-cli/src/main/kotlin/eu/vironlab/vextension/command/ConsoleCommandManager.kt): `vextension-cli/src/main/kotlin/eu/vironlab/vextension/command/ConsoleCommandManager.kt`

### Minecraft server

- [Server utilities](https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/bukkit/VextensionBukkit.kt): `vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/bukkit/VextensionBukkit.kt`
- [Server commands](https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/bukkit/command/BukkitCommandManager.kt): `vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/bukkit/command/BukkitCommandManager.kt`
- [Inventory and UI](https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/inventory/gui/GUI.kt): `vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/inventory/gui/GUI.kt`
- [Items and scoreboards](https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/item/ItemStack.kt): `vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/item/ItemStack.kt`

### Minecraft proxy

- [Proxy utilities](https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-proxy/src/main/kotlin/eu/vironlab/vextension/bungee/VextensionBungee.kt): `vextension-minecraft-proxy/src/main/kotlin/eu/vironlab/vextension/bungee/VextensionBungee.kt`
- [Proxy commands](https://github.com/codedinfinityflo/vextension/blob/main/vextension-minecraft-proxy/src/main/kotlin/eu/vironlab/vextension/velocity/command/VelocityCommandManager.kt): `vextension-minecraft-proxy/src/main/kotlin/eu/vironlab/vextension/velocity/command/VelocityCommandManager.kt`

### Other components

- **Console user**

## Connections

- Console user → Console input: enters commands
- Console input → CLI adapter: provides input (evidence: `vextension-cli/src/main/kotlin/eu/vironlab/vextension/command/ConsoleCommandManager.kt`)
- CLI adapter → Command manager: adapts commands (evidence: `vextension-cli/src/main/kotlin/eu/vironlab/vextension/command/ConsoleCommandManager.kt`)
- Command manager → Command model: registers commands (evidence: `vextension-command/src/main/kotlin/eu/vironlab/vextension/command/AbstractCommandManager.kt`)
- Command manager → Command context: uses context (evidence: `vextension-command/src/main/kotlin/eu/vironlab/vextension/command/AbstractCommandManager.kt`)
- Command manager → Command source: uses source (evidence: `vextension-command/src/main/kotlin/eu/vironlab/vextension/command/AbstractCommandManager.kt`)
- Command context → Command source: exposes source (evidence: `vextension-command/src/main/kotlin/eu/vironlab/vextension/command/context/CommandContext.kt`)
- Document management → Document formats: uses formats (evidence: `vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/storage/JsonDocumentStorage.kt`)
- Document formats → Documents: reads and writes (evidence: `vextension-common/src/main/kotlin/eu/vironlab/vextension/document/impl/storage/JsonDocumentStorage.kt`)
- Database API → Documents: stores documents (evidence: `vextension-common/src/main/kotlin/eu/vironlab/vextension/database/Database.kt`)
- Database backends → Database API: implements API (evidence: `vextension-common/src/main/kotlin/eu/vironlab/vextension/database/sql/AbstractSqlDatabase.kt`)
- Server commands → Command manager: extends command system (evidence: `vextension-minecraft-server/src/main/kotlin/eu/vironlab/vextension/bukkit/command/BukkitCommandManager.kt`)
- Proxy commands → Command manager: extends command system (evidence: `vextension-minecraft-proxy/src/main/kotlin/eu/vironlab/vextension/velocity/command/VelocityCommandManager.kt`)
