Nix-Luanti

Overview

Nix-Luanti is a NixOS module and package collection that simplifies the setup and management of Luanti servers on NixOS. It provides a declarative way to configure and run multiple Luanti servers, including the ability to manage games, mods, and other settings through a clean Nix interface.

Features

• Declarative Configuration: Easily define multiple Luanti server instances with different games and mods.
• Extensive Content Library: Leverage a comprehensive collection of Luanti games, mods, and texture packs sourced from the official ContentDB.
• Automatic Dependency Resolution: Automatically resolves and includes dependencies for mods, ensuring that your server configurations are correct and functional.
• Systemd Integration: Servers are managed using systemd

Installation

Before you can use Nix-Luanti, you'll need to add it to your NixOS configuration. If you're using Flakes, you can do this by importing the module in your flake.nix.

1. Add the Nix-Luanti Flake:

   Add the following to your flake.nix:

   {
     inputs = {
       nixpkgs.url = "github:nixos/nixpkgs";
       nix-luanti.url = "github:lomenzel/nix-luanti";
     };
   
     outputs = { self, nixpkgs, nix-luanti, ... }:
       let
         pkgs = import nixpkgs { system = "x86_64-linux"; };
       in {
         nixosConfigurations = {
           my-server = nixpkgs.lib.nixosSystem {
             system = "x86_64-linux";
             specialArgs = {
              # this will make nix-luanti a parameter for each imported module so you can use nix-luanti.games for example
              nix-luanti = inputs.nix-luanti.packages."x86_64-linux";
             };
             modules = [
               ./configuration.nix
               # this will make the services.luanti module available
               nix-luanti.nixosModules.default
             ];
           };
         };
       };
   }

2. Configure Your Servers:

   In your NixOS configuration (e.g., configuration.nix), use the nix-luanti module to set up your servers:

   { config, pkgs, nix-luanti, ... }:
   {
     services.luanti = {
       enable = true;
       servers = with nix-luanti; {
         cool-server = {
           # minetest_game is the default so this asignment can be left out
           game = games.minetest_game;
           mods = with mods; [
             animalia
             # add as many mods you want :)
           ];
           # port has no default so it must be set
           port = 30000;
         };
         other-cool-server = {
           game = games.mineclone2;
           # default mods is [] so if no mods are needed it can be left out
           port = 30001;
         };
       };
     };
   }

3. Rebuild and Start the Server:

   apply your configuration:

   Your Luanti servers should now be running with the specified configuration.

Usage

Adding a New Server

To add a new Luanti server, simply add a new entry under services.luanti.servers in your NixOS configuration. Specify the game, mods, and any other configuration options.

Managing Mods

Mods can be specified in the mods attribute of each server configuration. Dependencies will be automatically resolved. The mods are pulled from the nix-luanti.mods package set, which itself gets the mods from Luanti's contentDB

Advanced Configuration (not testet yet)

You can customize additional settings in services.luanti.servers.<your-server-name>.config. This config is directly passed to the luanti.conf configuration file.

Troubleshooting

The systemd service is named luanti-<your-server-name>.service so if you set up services.luanti.servers.adventure you can see the status of the server by running systemctl status luanti-adventure.service and all its files like the world file the .minetest directory and everything else will be placed in /var/lib/luanti-adventure

Contributing

This project is a work in progress, and contributions are highly welcome! If you encounter any issues or have suggestions, feel free to open an issue or a merge request.