██████╗ ██╗ ██╗ ██████╗██████╗ █████╗ ███████╗████████╗██╗ ██╗██╗ ██╗██████╗
██╔══██╗╚██╗ ██╔╝██╔════╝██╔══██╗██╔══██╗██╔════╝╚══██╔══╝██║ ██║██║ ██║██╔══██╗
██████╔╝ ╚████╔╝ ██║ ██████╔╝███████║█████╗ ██║ ███████║██║ ██║██████╔╝
██╔═══╝ ╚██╔╝ ██║ ██╔══██╗██╔══██║██╔══╝ ██║ ██╔══██║██║ ██║██╔══██╗
██║ ██║ ╚██████╗██║ ██║██║ ██║██║ ██║ ██║ ██║╚██████╔╝██████╔╝
╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝
Python-powered Minecraft server management. Create, monitor, and control — all from your terminal.
PyCraftHub is an open-source terminal-based Minecraft server manager built in Python. Instead of downloading separate tools, editing config files by hand, or fighting the command line — you get a single guided interface that handles everything: server creation, plugin installs, live monitoring, and Discord alerts.
No prior server experience needed. Just run the .bat file and follow the menus.
| Type | Description | Best For |
|---|---|---|
| ⚡ Paper | High-performance fork, best plugin compat | Survival, SMP |
| 💜 Purpur | Paper fork with extra gameplay tweaks | Custom SMP |
| 🌐 Vanilla | Pure, unmodified Minecraft | Authentic play |
| 🧵 Fabric | Lightweight, fast-updating mod loader | Performance mods |
| 🔧 Forge | Classic modding platform, largest ecosystem | Heavy modpacks |
- Guided setup wizard — RAM, world seed, difficulty, server type, all in one flow
- Live performance monitor — real-time CPU, RAM, and TPS via
psutil - Modrinth integration — search and install plugins/mods directly, auto-resolves dependencies
- Discord webhook alerts — get notified on start, stop, crashes, and player joins
- World import & seed config — bring your existing worlds or generate with a specific seed
- 6 color themes — switch the terminal interface theme from settings anytime
- JSON-based config — clean, human-readable settings with automatic backups
- Python
3.10+ - Java
17+ - Windows OS
- Internet connection (for initial JAR downloads)
# 1. Clone the repo
git clone https://github.com/saransh-ops/PyCraftHub.git
cd PyCraftHub
# 2. Run the launcher — installs dependencies automatically
PyCraftHub launcher.batOr just download the latest release, extract, and double-click PyCraftHub launcher.bat. That's it.
[1] Create New Server ← Pick this first
[2] Manage Servers
[3] Settings
[4] Help
- Select Create New Server
- Choose your server type (Paper, Purpur, Vanilla, Fabric, or Forge)
- Set your RAM allocation and world seed
- Hit Start — your local IP is displayed instantly
- Share the IP with friends and connect
PyCraftHub/
├── main.py # Entry point & main menu
├── notifications.py # Discord webhook system
├── server_watcher.py # Live performance monitoring
├── settings_module.py # Settings & theme management
├── requirements.txt # Python dependencies
├── PyCraftHub launcher.bat # Windows launcher (auto-installs deps)
├── core/
│ └── server_manager.py # Server create / start / stop / edit
├── data/ # Server JARs, configs, cached data
└── utils/ # Shared utilities
requests # API calls (Modrinth, download JARs)
psutil # Live CPU / RAM monitoring
colorama # Colored terminal outputAll installed automatically on first launch.
- Added Purpur server support
- Added Forge server support
- New colored CLI interface with 6 switchable themes
- Live performance monitoring (CPU, RAM, TPS)
- Discord webhook notifications
- Full settings system
- World seed & import configuration
- Fabric server support
- Modrinth API integration
- Plugin/mod installer with dependency resolution
- Improved server management flow
Contributions are welcome. Open an issue first to discuss what you'd like to change, then submit a PR.
# Fork → clone → create branch → make changes → PR
git checkout -b feature/your-feature-name- 🐛 Bug reports → GitHub Issues
- 💬 Discord →
godkiller_saransh - 📖 Built-in docs → select
[4] Helpfrom the main menu
MIT — free to use, modify, and distribute. See LICENSE for details.
Made with 🩵 by Saransh Gupta
If this helped you, drop a ⭐ — it means a lot!