Repolode
Infinidoge

Infinidoge/nix-minecraft

一个 Nix flake,用于打包 Minecraft 服务端、模组加载器和 Velocity 代理,并支持在 NixOS 上声明式部署。

Star
632
Fork
93
未关闭 Issue
45
最近提交
昨天

这是什么?

nix-minecraft 为 Nix 生态打包 Minecraft 服务端软件,主要面向服务端。它提供所有原版服务端版本的派生,以及 Fabric、Legacy Fabric、Quilt、Paper、Purpur、NeoForge 的受支持版本,还包括 Velocity 代理。

除了服务端包,该 flake 还提供 NixOS 模块 services.minecraft-servers,可同时运行多个服务器。数据目录、server.properties、白名单、管理员、JVM 参数、防火墙和重启策略都以声明式方式配置。模组、插件和配置文件可通过 symlinks 与 files 选项链接或生成。

项目还包含整合包相关工具:fetchPackwizModpack 用于 packwiz 整合包,fetchModrinthModpack 用于 .mrpack 文件,nix-modrinth-prefetch 可将 Modrinth 版本 ID 转为 fetchurl 表达式。

核心功能

  • 01打包原版、Fabric、Quilt、Paper、Purpur、NeoForge 和 Velocity 的服务端版本
  • 02提供 NixOS 模块,通过 systemd 托管多个 Minecraft 服务器
  • 03以声明式方式管理 server.properties、白名单、管理员和封禁列表
  • 04通过 symlinks 和 files 选项将模组与配置文件链接或生成到服务器目录
  • 05将 packwiz 与 Modrinth 整合包构建为 Nix 派生

适用场景

  • 在 NixOS 上以可复现的配置托管 Minecraft 服务器
  • 使用按哈希固定版本的整合包运行 Paper 或 Fabric 服务器
  • 在多台后端服务器前部署 Velocity 代理
  • 在同一台机器上通过声明式配置管理多个 Minecraft 服务器

快速上手

  1. 1

    在 flake.nix 中将 nix-minecraft 添加为 flake 输入

  2. 2

    在系统配置中导入 NixOS 模块并应用 overlay

  3. 3

    在临时 shell 中试用 modrinth 预取工具

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

使用前须知

  • 仅以 Nix flake 形式提供,flake-compat 方式未经积极测试。
  • 面向由 NixOS 管理的服务器部署,在 Nix 生态之外用处有限。

标签

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

常见问题

nix-minecraft 是什么?
一个 Nix flake,用于打包 Minecraft 服务端、模组加载器和 Velocity 代理,并支持在 NixOS 上声明式部署。 nix-minecraft 为 Nix 生态打包 Minecraft 服务端软件,主要面向服务端。它提供所有原版服务端版本的派生,以及 Fabric、Legacy Fabric、Quilt、Paper、Purpur、NeoForge 的受支持版本,还包括 Velocity 代理。
nix-minecraft 可以免费使用吗?用的什么许可证?
nix-minecraft 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
nix-minecraft 还在维护吗?
活跃维护中。nix-minecraft 最近一次提交是在 2026年11月6日。
nix-minecraft 适合用来做什么?
在 NixOS 上以可复现的配置托管 Minecraft 服务器 使用按哈希固定版本的整合包运行 Paper 或 Fabric 服务器 在多台后端服务器前部署 Velocity 代理 在同一台机器上通过声明式配置管理多个 Minecraft 服务器
nix-minecraft 怎么安装和运行?
在 flake.nix 中将 nix-minecraft 添加为 flake 输入 在系统配置中导入 NixOS 模块并应用 overlay 在临时 shell 中试用 modrinth 预取工具: nix shell github:Infinidoge/nix-minecraft#nix-modrinth-prefetch
在哪里获取 nix-minecraft?
源代码和安装说明在 GitHub 上:https://github.com/Infinidoge/nix-minecraft

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目