How yassine-jemi01/minecraft-status works
Minecraft Status is a desktop Python application that reads a local Minecraft Java world and publishes its current state as Discord Rich Presence. Its main runtime loop detects the active world, gathers player, biome, statistics, and advancement data, then updates Discord; separate CLI operations manage configuration, background processes, and optional OS auto-start. The README documents compatibility across legacy and modern world layouts. The graph follows documented behavior and indexed references; unsampled implementation details are not inferred beyond those references.
Main entry points: main.py CLI and Runtime · advancements.py Advancement Reader · biome.py Biome Reader · user_config.py User Configuration
Components 19
Runtime and Presence
- CLI and Runtime
src/minecraft_status/main.py - Discord Presence
src/minecraft_status/minecraft_reader/discord_presence.py
World Data Readers
- Active World Locator
src/minecraft_status/minecraft_reader/locator.py - Player and World Data
src/minecraft_status/minecraft_reader/player_data.py - Stats and Playtime
src/minecraft_status/minecraft_reader/stats.py - Advancement Reader
src/minecraft_status/minecraft_reader/advancements.py - Advancement Titles
src/minecraft_status/minecraft_reader/advancement_names.py - Biome Reader
src/minecraft_status/minecraft_reader/biome.py - Legacy Biome IDs
src/minecraft_status/minecraft_reader/legacy_biomes.py - World Format
src/minecraft_status/minecraft_reader/world_format.py
Configuration and Secrets
- Default Settings
src/minecraft_status/config.py - User Configuration
src/minecraft_status/user_config.py - Encrypted Config Store
src/minecraft_status/secure_store.py
Process and Auto-start
- Background Process Manager
src/minecraft_status/process_manager.py - Auto-start Manager
src/minecraft_status/autostart_manager.py
Other components
- User
- Discord Desktop
- Minecraft Save Files
- Operating System
Connections 27
- User → CLI and Runtime: runs commands
README.md - CLI and Runtime → Active World Locator: locates world
src/minecraft_status/main.py - CLI and Runtime → Player and World Data: reads player
src/minecraft_status/main.py - CLI and Runtime → Stats and Playtime: reads stats
src/minecraft_status/main.py - CLI and Runtime → Advancement Reader: reads advancements
src/minecraft_status/main.py - CLI and Runtime → Biome Reader: reads biome
src/minecraft_status/main.py - Advancement Reader → Stats and Playtime: uses legacy stats
src/minecraft_status/minecraft_reader/advancements.py - Advancement Reader → Player and World Data: gets player UUID
src/minecraft_status/minecraft_reader/advancements.py - Advancement Reader → Advancement Titles: formats titles
src/minecraft_status/minecraft_reader/advancements.py - Biome Reader → Legacy Biome IDs: maps legacy IDs
src/minecraft_status/minecraft_reader/biome.py - Biome Reader → World Format: uses format rules
src/minecraft_status/minecraft_reader/biome.py - CLI and Runtime → Discord Presence: updates presence
README.md - Discord Presence → Discord Desktop: publishes activity
README.md - CLI and Runtime → Default Settings: loads defaults
src/minecraft_status/main.py - CLI and Runtime → User Configuration: manages settings
src/minecraft_status/main.py - User Configuration → Default Settings: merges defaults
src/minecraft_status/user_config.py - User Configuration → Encrypted Config Store: loads and saves
src/minecraft_status/user_config.py - CLI and Runtime → Background Process Manager: controls background
src/minecraft_status/main.py - CLI and Runtime → Auto-start Manager: configures auto-start
src/minecraft_status/main.py - Auto-start Manager → User Configuration: checks client ID
src/minecraft_status/autostart_manager.py - Background Process Manager → Encrypted Config Store: gets config directory
src/minecraft_status/process_manager.py - Auto-start Manager → Operating System: registers startup
src/minecraft_status/autostart_manager.py - Active World Locator → Minecraft Save Files: checks session lock
README.md - Player and World Data → Minecraft Save Files: reads world files
README.md - Stats and Playtime → Minecraft Save Files: reads stats files
README.md - Advancement Reader → Minecraft Save Files: reads advancement files
README.md - Biome Reader → Minecraft Save Files: reads chunk data
README.md