Repolode
Submit
Infinidoge

Infinidoge/nix-minecraft

A Nix flake that packages Minecraft server versions, mod loaders, Velocity proxy and modpack tools for NixOS-managed hosting.

View on GitHub
Stars
632
Forks
93
Open issues
45
Last commit
yesterday

What is it?

nix-minecraft packages Minecraft server software for the Nix ecosystem, focusing on the server side. It provides derivations for all vanilla server versions, plus supported versions of Fabric, Legacy Fabric, Quilt, Paper, Purpur and NeoForge, as well as the Velocity proxy.

Beyond server packages, the flake offers a NixOS module (services.minecraft-servers) for running multiple servers at once. Data directories, server.properties, whitelists, operators, JVM options, firewall rules and restart behavior are all configured declaratively. Mods, plugins and config files can be linked or generated through the symlinks and files options.

The project also includes helpers for modpacks: fetchPackwizModpack for packwiz packs, fetchModrinthModpack for .mrpack files, and nix-modrinth-prefetch for turning a Modrinth version ID into a fetchurl expression.

Key features

  • 01Packages vanilla, Fabric, Quilt, Paper, Purpur, NeoForge and Velocity server versions
  • 02Provides a NixOS module to host multiple Minecraft servers under systemd
  • 03Declaratively manages server.properties, whitelist, operators and banned players
  • 04Links mods and config files into server directories via symlinks and files options
  • 05Builds packwiz and Modrinth modpacks as Nix derivations

Use cases

  • Hosting a Minecraft server on NixOS with reproducible configuration
  • Running a Paper or Fabric server with a modpack pinned by hash
  • Operating a Velocity proxy in front of several backend servers
  • Managing multiple Minecraft servers on one machine with declarative config

Quick start

  1. 1

    Add nix-minecraft as a flake input in your flake.nix

  2. 2

    Import the NixOS module and apply the overlay in your system configuration

  3. 3

    Try the modrinth prefetch helper in a temporary shell

    nix shell github:Infinidoge/nix-minecraft#nix-modrinth-prefetch

Things to know

  • Built exclusively as a Nix flake; the flake-compat path is not actively tested.
  • Intended for NixOS-managed hosting, so it is of little use outside the Nix ecosystem.

Topics

#minecraft#nix#nixos#game-server#modpack#velocity#nixos-module

FAQ

What is nix-minecraft?
A Nix flake that packages Minecraft server versions, mod loaders, Velocity proxy and modpack tools for NixOS-managed hosting. nix-minecraft packages Minecraft server software for the Nix ecosystem, focusing on the server side. It provides derivations for all vanilla server versions, plus supported versions of Fabric, Legacy Fabric, Quilt, Paper, Purpur and NeoForge, as well as the Velocity proxy.
Is nix-minecraft free to use? What license does it have?
nix-minecraft is open source under the MIT license. Check the license terms before using it in commercial products.
Is nix-minecraft still maintained?
Actively maintained. The last commit to nix-minecraft was on Nov 6, 2026.
What can I use nix-minecraft for?
Hosting a Minecraft server on NixOS with reproducible configuration Running a Paper or Fabric server with a modpack pinned by hash Operating a Velocity proxy in front of several backend servers Managing multiple Minecraft servers on one machine with declarative config
How do I install nix-minecraft?
Add nix-minecraft as a flake input in your flake.nix Import the NixOS module and apply the overlay in your system configuration Try the modrinth prefetch helper in a temporary shell: nix shell github:Infinidoge/nix-minecraft#nix-modrinth-prefetch
Where can I get nix-minecraft?
The source code and installation instructions are on GitHub: https://github.com/Infinidoge/nix-minecraft

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects