Hypixel SkyBlock

A 1.21.11 Minestom-based recreation of Hypixel SkyBlock with a properly abstracted, scalable microservices architecture.

Note: This implementation is under active development and is not yet production-ready.

Documentation

Full documentation is available at opensource.swofty.net

• Getting Started
• Requirements
• Setup Guide
• Docker Deployment
• Server Types Reference
• Services Reference
• Troubleshooting

Quick Links

• Releases
• Javadocs
• Discord
• Video Guide

Features

• Multi-Server Architecture - 13 server types (SkyBlock + BedWars)
• Microservices - 8 independent services (Auctions, Bazaar, Party, etc.)
• Redis Communication - Real-time inter-service messaging
• MongoDB Storage - Persistent data storage
• Velocity Proxy - Load balancing and player routing
• Docker Support - Full Docker Compose deployment
• Java 25 - Modern Java with virtual threads

Requirements

• 16GB+ RAM
• 6+ CPU Cores
• Java 25
• MongoDB
• Redis

See the full requirements for details.

Quick Start

# Clone the repository
git clone https://github.com/Swofty-Developments/HypixelSkyBlock.git

# Docker deployment
docker-compose up --build

For manual setup, follow the documentation.

Related Projects

• HypixelForums - Web forum integration

Credits

Thanks to the Minestom community and all contributors.

License

See repository for license details.