# sammko/picomc architecture

> Architecture diagram of the GitHub repository sammko/picomc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sammko/picomc
- Repository: https://github.com/sammko/picomc

## Overview

##### Project type and purpose
- picomc is a cross-platform, CLI-only Minecraft launcher.
- It manages accounts, creates/runs multiple game instances, downloads game assets, and integrates with common mod installers.

##### File structure
- Top level:
- pyproject.toml, requirements*.lock – build/dependency config (Rye & pip).
- README.md, LICENSE – meta.
- src/picomc: core package
- __main__.py – entrypoint.
- cli/… – subcommands (account, config, instance, mod, play, version).
- account.py, config.py, instance.py, launcher.py, downloader.py, library.py, logging.py, rules.py, utils.py, version.py – core services.
- java/… – Java‐specific helpers.
- mod/curse.py, fabric.py, forge.py, ftb.py – adapters for mod platforms.
- msapi.py, yggdrasil.py – Minecraft/Mojang authentication & metadata APIs.
- osinfo.py, windows.py – OS abstraction layers.
- errors.py – error definitions.

##### README for additional insights
- Confirms CLI tool with subcommands.
- Mentions on-disk structure mimicking vanilla launcher.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% CLI Layer
    subgraph "CLI Layer"
        CMD["EntryPoint (__main__.py)"]:::cli
        PARSER["CLI Parser (cli/main.py)"]:::cli
        CAC["Account Cmd (cli/account.py)"]:::cli
        CCF["Config Cmd (cli/config.py)"]:::cli
        CIN["Instance Cmd (cli/instance.py)"]:::cli
        CMOD["Mod Cmd (cli/mod.py)"]:::cli
        CPLY["Play Cmd (cli/play.py)"]:::cli
        CVR["Version Cmd (cli/version.py)"]:::cli
        CUTIL["CLI Utils (cli/utils.py)"]:::cli
    end

    %% Core Engine
    subgraph "Core Engine"
        ACCT["Account Manager"]:::core
        CONF["Config Manager"]:::core
        INST["Instance Manager"]:::core
        DL["Downloader"]:::core
        MM["Mod Manager"]:::core
        JL["Java Launcher"]:::core
        LOG["Logging"]:::infra
        ERR["Error Handling"]:::infra
        UTIL["Core Utilities"]:::infra
    end

    %% Infrastructure
    subgraph "OS Abstraction" 
        OSI["OS Info (osinfo.py)"]:::infra
        WIN["Windows Support (windows.py)"]:::infra
    end

    %% External Services
    subgraph "External Services"
        YGG["Yggdrasil Auth API"]:::external
        MSAPI["Minecraft Metadata API"]:::external
        CF["CurseForge Repo"]:::external
        FAB["Fabric Repo"]:::external
        FRG["Forge Repo"]:::external
        FTB["FTB Repo"]:::external
        JRT["Java Runtime"]:::external
        DISK["Local Disk Filesystem"]:::infra
    end

    %% Connections
    CMD --> PARSER
    PARSER --> CAC
    PARSER --> CCF
    PARSER --> CIN
    PARSER --> CMOD
    PARSER --> CPLY
    PARSER --> CVR
    PARSER --> CUTIL

    CAC --> ACCT
    CCF --> CONF
    CIN --> INST
    CPLY --> INST
    CMOD --> MM
    CVR --> UTIL

    ACCT --> YGG
    ACCT --> MSAPI
    INST --> CONF
    INST --> DL
    INST --> UTIL
    DL --> DISK
    DL --> MSAPI
    DL --> CF
    DL --> FAB
    DL --> FRG
    DL --> FTB
    MM --> CF
    MM --> FAB
    MM --> FRG
    MM --> FTB
    JL --> OSI
    JL --> WIN
    JL --> DISK
    JL --> JRT
    ACCT --> LOG
    CONF --> LOG
    INST --> LOG
    DL --> LOG
    MM --> LOG
    JL --> LOG
    ERR -.-> CMD
    ERR -.-> ACCT
    ERR -.-> CONF
    ERR -.-> INST
    ERR -.-> DL
    ERR -.-> MM
    ERR -.-> JL

    %% Click Events
    click CMD "https://github.com/sammko/picomc/blob/master/src/picomc/__main__.py"
    click PARSER "https://github.com/sammko/picomc/blob/master/src/picomc/cli/main.py"
    click CAC "https://github.com/sammko/picomc/blob/master/src/picomc/cli/account.py"
    click CCF "https://github.com/sammko/picomc/blob/master/src/picomc/cli/config.py"
    click CIN "https://github.com/sammko/picomc/blob/master/src/picomc/cli/instance.py"
    click CMOD "https://github.com/sammko/picomc/blob/master/src/picomc/cli/mod.py"
    click CPLY "https://github.com/sammko/picomc/blob/master/src/picomc/cli/play.py"
    click CVR "https://github.com/sammko/picomc/blob/master/src/picomc/cli/version.py"
    click CUTIL "https://github.com/sammko/picomc/blob/master/src/picomc/cli/utils.py"

    click ACCT "https://github.com/sammko/picomc/blob/master/src/picomc/yggdrasil.py"
    click MSAPI "https://github.com/sammko/picomc/blob/master/src/picomc/msapi.py"
    click CONF "https://github.com/sammko/picomc/blob/master/src/picomc/config.py"
    click INST "https://github.com/sammko/picomc/blob/master/src/picomc/instance.py"
    click INST "https://github.com/sammko/picomc/blob/master/src/picomc/rules.py"
    click INST "https://github.com/sammko/picomc/blob/master/src/picomc/library.py"
    click DL "https://github.com/sammko/picomc/blob/master/src/picomc/downloader.py"
    click CF "https://github.com/sammko/picomc/blob/master/src/picomc/mod/curse.py"
    click FAB "https://github.com/sammko/picomc/blob/master/src/picomc/mod/fabric.py"
    click FRG "https://github.com/sammko/picomc/blob/master/src/picomc/mod/forge.py"
    click FTB "https://github.com/sammko/picomc/blob/master/src/picomc/mod/ftb.py"
    click JL "https://github.com/sammko/picomc/blob/master/src/picomc/launcher.py"
    click JL "https://github.com/sammko/picomc/blob/master/src/picomc/java/__init__.py"
    click OSI "https://github.com/sammko/picomc/blob/master/src/picomc/osinfo.py"
    click WIN "https://github.com/sammko/picomc/blob/master/src/picomc/windows.py"
    click LOG "https://github.com/sammko/picomc/blob/master/src/picomc/logging.py"
    click ERR "https://github.com/sammko/picomc/blob/master/src/picomc/errors.py"
    click UTIL "https://github.com/sammko/picomc/blob/master/src/picomc/utils.py"
    click UTIL "https://github.com/sammko/picomc/blob/master/src/picomc/version.py"

    %% Styles
    classDef cli fill:#D0E8FF,stroke:#0366D6,color:#0366D6
    classDef core fill:#E6FFEB,stroke:#28A745,color:#28A745
    classDef infra fill:#FFF5B1,stroke:#D39E00,color:#D39E00
    classDef external fill:#FFEFE6,stroke:#D73A49,color:#D73A49
```
