Infrastructure for Oyasai Minecraft Server
Build, deploy, and manage Minecraft server infrastructure with Nix flakes, custom plugins, and automated CI/CD workflows.
$ nix develop
🔨 Building development environment…
✓ Java 25, Gradle 9 ready
✓ 10 plugins available
Quick start
Get your development environment ready in minutes
Install Nix
Install Nix package manager with flakes support:curl -L https://nixos.org/nix/install | sh
mkdir -p ~/.config/nix
echo 'experimental-features = nix-command flakes' >> ~/.config/nix/nix.conf
Windows users should install WSL first and run all commands inside WSL.
Clone and enter devshell
Clone the repository and enter the development environment:git clone https://github.com/Oyasaiserver/platform.git
cd platform
nix develop
Build all plugins
Build all Minecraft plugins in parallel:Built plugins will be available in plugins/*/build/libs/. Run a test server
Launch a minimal test server with your plugins:nix run .#oyasai-minecraft-minimal
localhost:25565 with all custom plugins loaded. Explore the platform
Everything you need to build and deploy Minecraft infrastructure
Setup & deployment
Configure development environment and deploy to production
Architecture
Learn about the monorepo structure and Nix flake system
Plugins
Explore 10 custom Minecraft plugins built with Kotlin
Operations
Manage servers, monitor performance, and configure backups
Development
Build new plugins and contribute to the platform
API reference
Browse plugin APIs and server configuration modules
Key features
Modern infrastructure tools for Minecraft server management
Nix-based infrastructure
Reproducible builds with Nix flakes, lockfiles, and declarative server configurations
Custom Kotlin plugins
10 production-ready plugins for admin tools, pets, profiles, and player utilities
Automated CI/CD
Build validation with flake checks, parallel Gradle builds, and Docker image generation
Plugin registry
Version management for Purpur plugins including EssentialsX, Vault, and LuckPerms
Ready to start building?
Get your development environment set up and deploy your first Minecraft server with custom plugins.
