luanti(6)

📦
version 5.17.0 · 4 versions
, in arch rolling, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

👑 luanti — the voxel game engine, bestie edition ✨

okay so like, first things first, this page is luanti(6) — that's the manual, that's the vibe, that's the whole thing. and it's all about Luanti (and its little sibling luantiserver) 🦋

🌸 SYNOPSIS 🌸

luanti [--server SERVER OPTIONS | CLIENT OPTIONS] [COMMON OPTIONS]

luantiserver [SERVER OPTIONS] [COMMON OPTIONS]

💖 DESCRIPTION 💖

so basically Luanti — which you might know as Minetest, its government name before the glow-up — is a voxel game engine 🎀 and the whole point is that modding and making your own games is easy. like, genuinely easy. no cap. ✨

✨ COMMON OPTIONS ✨

these ones work for everybody, no matter which mode you're in 💅

  • --help — prints all the allowed options and dips. bye! 👋
  • --version — tells you what version you're on, then peaces out.
  • --config <value> — load your config from the file you point at 📂
  • --logfile <value> — set where the logfile goes. pro tip: pass '' and you get no logging at all 🙈
  • --info — more info in the console. she's chatty now.
  • --verbose — even more info in the console. she's really chatty now.
  • --trace — enormous amounts of info. like, an unhinged amount. you have been warned 💀
  • --quiet — only errors, nothing else. introvert mode 🫶
  • --color always | never | auto — coloured logs. default is auto 🌈
  • --log-timestamp wall | relative | none — timestamped logs. default is wall ⏰
  • --gameid <value> | list — set the gameid, or pass list to see which ones you even have 👀
  • --worldname <value> — set the world path, but by name 🏷️
  • --world <value> — set the world path, normally.
  • --worldlist path | name | both — get a list of worlds. path gives you paths, name gives you names, both gives you both. iconic. ⭐
  • --map-dir <value> — same thing as --world. deprecated though, so maybe don't 👀
  • --port <value> — set the network port (UDP) to use 🔌
  • --run-unittests — run the unit tests and exit 🧪
  • --run-benchmarks — run the benchmarks and exit 🏃♀️

🎀 CLIENT OPTIONS 🎀

these are for when you're the one playing 💖

  • --address <value> — the address to connect to. pass '' for a local game 🏠
  • --go — skips the main menu and drops you straight in-game. main character energy, no waiting ✨
  • --name <value> — set your player name 🪪
  • --password <value> — set your password 🔐
  • --password-file <value> — set your password from the contents of a file 📄
  • --random-input — enables random user input, for testing 🎲

🔥 SERVER OPTIONS 🔥

server girlies, this section is yours 👑

  • --migrate <value> — migrate from your current map backend to another one. wanna know which backends are supported? --help has the tea ☕
  • --migrate-auth <value> — migrate from your current auth backend to another. again: --help for the supported list ☕
  • --migrate-players <value> — migrate from your current players backend to another. you already know where the list is (--help) ☕
  • --migrate-mod-storage <value> — migrate from your current mod storage backend to another. --help. supported backends. go look. ☕
  • --terminal — shows an interactive terminal over ncurses while it's running 🖥️

🌈 ENVIRONMENT VARIABLES 🌈

the invisible little settings that live in your shell 🐚

  • LUANTI_GAME_PATH — a colon delimited list of directories to search for games. use this instead of MINETEST_GAME_PATH, which is deprecated 🚫
  • LUANTI_MOD_PATH — a colon delimited list of directories to search for mods. use this instead of MINETEST_MOD_PATH, which is deprecated 🚫
  • LUANTI_USER_PATH — path to the Luanti user data directory. heads up: this one only exists on a RUN_IN_PLACE=0 build 👀
  • LOG_TIMESTAMP — literally just the environment-variable version of --log-timestamp 💫

💀 BUGS 💀

found a bug? don't suffer in silence, bestie. report all of them at https://github.com/luanti-org/luanti/issues 📝

🫶 AUTHORS 🫶

Perttu Ahola <celeron55@gmail.com> and contributors. we love a collaborative queen 💖

this man page was originally written by Juhani Numminen <juhaninumminen0@gmail.com>. credit where credit is due, periodt ✨

🌐 WWW 🌐

http://www.luanti.org/ — go say hi 🌸

and that's the whole page, babe 💅 this was the luanti manual as of 2025-10-16, and the footer's little luanti(6) tag is just the manual's name-and-section combo, so now you know 🎀 go build something iconic 👑

📦 where this page comes from