# navoei/myhomes architecture

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

- Interactive diagram: https://gitdiagram.com/navoei/myhomes
- Repository: https://github.com/navoei/myhomes

## Overview

MyHomes is a Minecraft homes plugin: players create, teleport to, list, and manage homes, while invitations and public/private access govern sharing; administrators can inspect and manage other players’ homes. The plugin registers command handlers and a respawn listener, with home and invite data persisted through SQLite. UUID lookup supports player-name-based operations and Mojang resolution. Command-to-storage details are only partly shown, so unverified command/storage links are dashed; unsampled modules are represented by their exact source directories.

Main entry points: [`src/main/java/me/navoei/myhomes/MyHomes.java`](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/MyHomes.java) (Plugin bootstrap), [`src/main/java/me/navoei/myhomes/storage/Database.java`](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/storage/Database.java) (Home and invite data), [`src/main/java/me/navoei/myhomes/uuid/UUIDFetcher.java`](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/uuid/UUIDFetcher.java) (UUID lookup and cache), [`src/main/java/me/navoei/myhomes/commands/admin/ManagePlayerHomeCommand.java`](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/commands/admin/ManagePlayerHomeCommand.java) (Admin home management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Plugin runtime"]
  node_plugin["Plugin bootstrap<br/>[MyHomes.java]"]
  node_respawn["Respawn handling<br/>[RespawnEvent.java]"]
  node_language["Localized messages<br/>[Lang.java]"]
end

subgraph group_player["Player home features"]
  node_playerhomes["Home commands"]
  node_sharing["Sharing commands"]
  node_listing["Home and invite lists"]
end

subgraph group_admin["Administration"]
  node_adminmanage["Admin home management"]
  node_adminlists["Admin listings"]
end

subgraph group_services["Identity and persistence"]
  node_database["Home and invite data<br/>[Database.java]"]
  node_sqlite[("SQLite persistence<br/>[SQLite.java]")]
  node_uuid["UUID lookup and cache<br/>[UUIDFetcher.java]"]
  node_mojanguuid["Mojang UUID lookup"]
  node_mojangname["Mojang name lookup"]
end

node_players(("Minecraft players"))
node_server["Minecraft server"]

node_plugin -->|"registers"| node_playerhomes
node_plugin -->|"registers"| node_adminmanage
node_plugin -->|"registers"| node_adminlists
node_plugin -->|"registers"| node_respawn
node_plugin -->|"initializes"| node_database
node_plugin -->|"loads cache"| node_uuid
node_plugin -->|"loads language"| node_language
node_respawn -->|"reads home"| node_database
node_respawn -->|"sets respawn"| node_server
node_players -.->|"issues commands"| node_playerhomes
node_players -.->|"manages sharing"| node_sharing
node_playerhomes -.->|"uses home data"| node_database
node_sharing -->|"updates invites"| node_database
node_playerhomes -->|"uses messages"| node_language
node_sharing -->|"uses messages"| node_language
node_adminmanage -.->|"manages homes"| node_database
node_adminmanage -->|"resolves players"| node_uuid
node_adminmanage -->|"uses messages"| node_language
node_adminlists -->|"resolves players"| node_uuid
node_adminlists -->|"queries lists"| node_database
node_database -->|"uses backend"| node_sqlite
node_database -->|"resolves identities"| node_uuid
node_uuid -->|"looks up UUID"| node_mojanguuid
node_uuid -->|"looks up names"| node_mojangname

click node_plugin "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/MyHomes.java"
click node_respawn "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/events/RespawnEvent.java"
click node_playerhomes "https://github.com/navoei/myhomes/tree/main/src/main/java/me/navoei/myhomes/commands/player"
click node_sharing "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/commands/player/ManageHomeCommand.java"
click node_listing "https://github.com/navoei/myhomes/tree/main/src/main/java/me/navoei/myhomes/commands/player"
click node_adminmanage "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/commands/admin/ManagePlayerHomeCommand.java"
click node_adminlists "https://github.com/navoei/myhomes/tree/main/src/main/java/me/navoei/myhomes/commands/admin"
click node_language "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/language/Lang.java"
click node_database "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/storage/Database.java"
click node_sqlite "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/storage/SQLite.java"
click node_uuid "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/uuid/UUIDFetcher.java"
click node_mojanguuid "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/uuid/MojangUUIDFetcher.java"
click node_mojangname "https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/uuid/MojangNameFetcher.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_plugin,node_respawn,node_language toneBlue
class node_playerhomes,node_sharing,node_listing toneAmber
class node_adminmanage,node_adminlists,node_server toneMint
class node_database,node_sqlite,node_uuid,node_mojanguuid,node_mojangname toneRose
class node_players toneIndigo
```

## Components

### Plugin runtime

- [Plugin bootstrap](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/MyHomes.java): `src/main/java/me/navoei/myhomes/MyHomes.java`
- [Respawn handling](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/events/RespawnEvent.java): `src/main/java/me/navoei/myhomes/events/RespawnEvent.java`
- [Localized messages](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/language/Lang.java): `src/main/java/me/navoei/myhomes/language/Lang.java`

### Player home features

- [Home commands](https://github.com/navoei/myhomes/tree/main/src/main/java/me/navoei/myhomes/commands/player): `src/main/java/me/navoei/myhomes/commands/player`
- [Sharing commands](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/commands/player/ManageHomeCommand.java): `src/main/java/me/navoei/myhomes/commands/player/ManageHomeCommand.java`
- [Home and invite lists](https://github.com/navoei/myhomes/tree/main/src/main/java/me/navoei/myhomes/commands/player): `src/main/java/me/navoei/myhomes/commands/player`

### Administration

- [Admin home management](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/commands/admin/ManagePlayerHomeCommand.java): `src/main/java/me/navoei/myhomes/commands/admin/ManagePlayerHomeCommand.java`
- [Admin listings](https://github.com/navoei/myhomes/tree/main/src/main/java/me/navoei/myhomes/commands/admin): `src/main/java/me/navoei/myhomes/commands/admin`

### Identity and persistence

- [Home and invite data](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/storage/Database.java): `src/main/java/me/navoei/myhomes/storage/Database.java`
- [SQLite persistence](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/storage/SQLite.java): `src/main/java/me/navoei/myhomes/storage/SQLite.java`
- [UUID lookup and cache](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/uuid/UUIDFetcher.java): `src/main/java/me/navoei/myhomes/uuid/UUIDFetcher.java`
- [Mojang UUID lookup](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/uuid/MojangUUIDFetcher.java): `src/main/java/me/navoei/myhomes/uuid/MojangUUIDFetcher.java`
- [Mojang name lookup](https://github.com/navoei/myhomes/blob/main/src/main/java/me/navoei/myhomes/uuid/MojangNameFetcher.java): `src/main/java/me/navoei/myhomes/uuid/MojangNameFetcher.java`

### Other components

- **Minecraft players**
- **Minecraft server**

## Connections

- Plugin bootstrap → Home commands: registers (evidence: `src/main/java/me/navoei/myhomes/MyHomes.java`)
- Plugin bootstrap → Admin home management: registers (evidence: `src/main/java/me/navoei/myhomes/MyHomes.java`)
- Plugin bootstrap → Admin listings: registers (evidence: `src/main/java/me/navoei/myhomes/MyHomes.java`)
- Plugin bootstrap → Respawn handling: registers (evidence: `src/main/java/me/navoei/myhomes/MyHomes.java`)
- Plugin bootstrap → Home and invite data: initializes (evidence: `src/main/java/me/navoei/myhomes/MyHomes.java`)
- Plugin bootstrap → UUID lookup and cache: loads cache (evidence: `src/main/java/me/navoei/myhomes/MyHomes.java`)
- Plugin bootstrap → Localized messages: loads language (evidence: `src/main/java/me/navoei/myhomes/MyHomes.java`)
- Respawn handling → Home and invite data: reads home (evidence: `src/main/java/me/navoei/myhomes/events/RespawnEvent.java`)
- Respawn handling → Minecraft server: sets respawn (evidence: `src/main/java/me/navoei/myhomes/events/RespawnEvent.java`)
- Minecraft players → Home commands: issues commands
- Minecraft players → Sharing commands: manages sharing
- Home commands → Home and invite data: uses home data
- Sharing commands → Home and invite data: updates invites (evidence: `src/main/java/me/navoei/myhomes/commands/player/ManageHomeCommand.java`)
- Home commands → Localized messages: uses messages (evidence: `src/main/java/me/navoei/myhomes/commands/player/HomeCommand.java`)
- Sharing commands → Localized messages: uses messages (evidence: `src/main/java/me/navoei/myhomes/commands/player/ManageHomeCommand.java`)
- Admin home management → Home and invite data: manages homes
- Admin home management → UUID lookup and cache: resolves players (evidence: `src/main/java/me/navoei/myhomes/commands/admin/ManagePlayerHomeCommand.java`)
- Admin home management → Localized messages: uses messages (evidence: `src/main/java/me/navoei/myhomes/commands/admin/ManagePlayerHomeCommand.java`)
- Admin listings → UUID lookup and cache: resolves players (evidence: `src/main/java/me/navoei/myhomes/commands/admin/ListPlayerHomesCommand.java`)
- Admin listings → Home and invite data: queries lists (evidence: `src/main/java/me/navoei/myhomes/commands/admin/ListPlayerInvitesCommand.java`)
- Home and invite data → SQLite persistence: uses backend (evidence: `src/main/java/me/navoei/myhomes/storage/SQLite.java`)
- Home and invite data → UUID lookup and cache: resolves identities (evidence: `src/main/java/me/navoei/myhomes/storage/Database.java`)
- UUID lookup and cache → Mojang UUID lookup: looks up UUID (evidence: `src/main/java/me/navoei/myhomes/uuid/UUIDFetcher.java`)
- UUID lookup and cache → Mojang name lookup: looks up names (evidence: `src/main/java/me/navoei/myhomes/uuid/UUIDFetcher.java`)
