pioneers-metaserver(6)

💖 pioneers-metaserver(6) — the Games Manual glow-up 💖

okay so bestie, gather round, because this is the manual page for pioneers-metaserver, living its best life in the Games Manual section. it's giving network infrastructure realness and honestly? iconic. 🎀

---

✨ NAME ✨

pioneers-metaserver — metaserver for Pioneers 🌸

---

✨ SYNOPSIS ✨

pioneers-metaserver [options]

---

✨ DESCRIPTION ✨

so Pioneers is an implementation of the popular, award-winning "Settlers of Catan" board game — yes, THAT one, the queen of board games 👑 — and it uses a client/server model for networked play.

This program right here provides a piece of network infrastructure that helps match pioneers clients to pioneers servers. basically it's the matchmaker, the wingman, the group chat admin that introduces everybody. 🦋

ngl though: casual players of pioneers probably do not need to run this program. this one's for the server-side girlies. 💅

---

✨ OPTIONS ✨

• -?, --help — print a short help text and dip out. bye! 👋
• -d, --daemon — run in daemon mode. spooky background energy, love that for it. 🌙
• -P, --pidfile pidfile — write the pid to pidfile. heads up: this implies -d, no cap. 📝
• -r, --redirect location — redirect to another metaserver running at location. passing the aux cord, respectfully. 🔀
• -s, --servername hostname — use hostname as the hostname when creating servers. 🏷️
• -p, --port-range from-to — use ports in the range from-to (inclusive, bestie, both ends count) to start servers. and listen: when this range is not specified, the metaserver will not be able to create new games. like, at all. zero. nada. 😭
• --debug — enable debug messages. the tea gets spilled to the console. 🍓
• --syslog-debug — duplicate the messages of the syslog to the console. double posting fr fr. 🫶
• --version — show version information. the classic. ⭐

---

✨ ENVIRONMENT ✨

the default settings of the metaserver can be influenced with the following three environment variables, bestie, so pay attention 💜:

• PIONEERS_METASERVER — the hostname the metaserver will use when creating new games. this should be a hostname that can be resolved by all clients that will connect. if your friends can't resolve it, it's giving unreachable 💀
• PIONEERS_SERVER_CONSOLE — the path (including the filename) to pioneers-server-console. if it contains only a filename and no path, or if it is not set, the PATH variable in the environment is used to locate the program. it'll go hunting. 🔍
• PIONEERS_DIR — the path to the game definition files. if it is not set, the default installation path will be used. 🗂️

---

✨ FILES ✨

• /usr/share/games/pioneers/*.game — game definitions. the lore. the canon. 📖

---

✨ SIGNALS ✨

• SIGINT — shutdown the metaserver gracefully (can also be used to check for memory leaks). polite exit, main character energy 🌈

---

✨ AUTHOR ✨

This manual page was written by Jeff Breidenbach <jab@debian.org>, and updated by Roland Clobus <rclobus@rclobus.nl> and Bas Wijnen <shevek@fmf.nl>.

Pioneers was written by Dave Cole <dave@dccs.com.au>, Andy Heroff <aheroff@mediaone.net>, and Roman Hodek <roman@hodek.net>, with contributions from many other developers on the Internet — see the AUTHORS file in the pioneers distribution or the help->about dialog in one of the graphical programs for a complete list of contributing authors. so many legends, we stan a collaborative queen 👑

---

✨ SEE ALSO ✨

pioneers(6), pioneers-server-gtk(6), pioneers-server-console(6) — go read those too, iykyk 🔥

---

and that's the whole vibe check, bestie 💖 this page is from the pioneers source, dated February 24, 2013, and it's filed under pioneers-metaserver(6) in the Games Manual. slay, go match some servers, mwah 🎀✨