pioneers-server-console(6)

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

okay bestie, gather round, because this is the manual page for pioneers-server-console, and it lives in the Games Manual section (that's section 6, iykyk). it's giving "command-line game server for Pioneers" and honestly? iconic. ✨

---

🌸 NAME 🌸

pioneers-server-console — the command-line game server for Pioneers. yes, the whole thing. no GUI, no drama, just vibes and sockets. 💅

---

✨ SYNOPSIS ✨

pioneers-server-console [ OPTIONS ]

that's it. that's the whole summoning ritual. 🕯️

---

🦋 DESCRIPTION 🦋

so this manual page documents briefly the pioneers-server-console command. brief but cute, we love a concise queen. 💖

Pioneers is an implementation of the popular, award-winning "Settlers of Catan" board game for the GNOME desktop environment. award-winning!! we been knew. 🏆

it uses a client/server model for networked play of between two and eight players. two to eight. that's the range. no more, no fewer (well, the server will tell you).

and this program — the one you're reading about right now — provides a console-only server that pioneers clients can connect to. no windows, no buttons, just a terminal and your dreams. main character energy fr fr. 👑

---

🎀 OPTIONS 🎀

💫 Application options 💫

• -g, --game-title game title — load the ruleset specified by game title. the title can be found in the *.game files. ⚠️ you need quotes for titles with spaces, bestie, don't forget or the shell will eat your words.
• --filefilename — load the ruleset in the file filename.

yes, this one really is written as --filefilename in the source, and we are keeping it exactly as it is because the one rule that matters most is that every detail stays. 🫶 no cap.

• -p, --port port — use port for player connections. pick a good one. 💅
• -P, --players num — start a game for num total players (including computer players). so if you want 4 humans and 0 bots, that's 4. do the math, queen. 🧮
• -v, --points points — specify the number of "victory points" required to win the game. how many points till somebody wins? your call.
• -R, --seven-rule[0|1|2] — the "Sevens rule": specify gameplay behavior when a player rolls a seven. 🎲
  • a value of 0 (the default) means that rolling a seven always moves the robber.
  • a value of 1 requires the player to re-roll if a seven is rolled on the first two turns.
  • a value of 2 means the player always re-rolls.
• -T, --terrain[0|1] — choose a terrain type: 0 for the default, or 1 for random terrain. 🌍
• -c, --computer-players num — start up num computer players. bots! 🤖
• --version — show version information. always know what era of the codebase you're in. ⭐

🌈 Metaserver options 🌈

• -r, --register — register with a metaserver. the metaserver to use can be overridden with the -m option. default metaserver: pioneers.debian.net. 🛰️
• -m, --metaserver metaserver — register this server with the metaserver at the specified address. you get to choose your destiny.
• -n, --hostname hostname — use this hostname instead of the hostname reported by hostname(1). rename yourself, periodt. 💅

🍓 Miscellaneous options 🍓

• -x, --auto-quit — automatically exit after a player has won. bye bestie, you did great. 👋
• -k, --empty-timeout secs — automatically stop the server if no one has connected after secs seconds. a lonely server is a sad server. 😭
• -t, --tournament mins — tournament mode: add AI players after mins minutes. competitive era. 🔥
• -a, --admin-port port — listen for administrative commands on port port. (yes, "port port" — that's the original, and it's a whole mood.) 🎛️
• -s, --admin-wait — don't start the game immediately; wait for a command on the admin port (-a) instead. patience is a virtue, bestie. 🧘
• --fixed-seating-order — give players numbers according to the order they enter the game. first come, first seated. 🪑
• --debug — enable debug messages. the little spyglass into the server's soul. 🔍

---

🧚 ENVIRONMENT 🧚

the default settings of the server can be influenced with the following three environment variables (yes, three, we counted):

• PIONEERS_METASERVER — the hostname of the metaserver when no metaserver is specified on the command-line.
• PIONEERS_SERVER_NAME — the hostname of the server. if it is not set, the hostname is determined by hostname(1).
• 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 and $XDG_DATA_HOME/pioneers/*.game — game definitions.
• /usr/share/games/pioneers/computer_names — a list of names the computer player can use. the bots have lore. 🫶

---

👑 AUTHOR 👑

this manual page was written by Steve Langasek <vorlon@debian.org>, and updated by Roland Clobus <rclobus@rclobus.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 for a complete list of contributing authors. legends, every single one. 🏆

---

💜 SEE ALSO 💜

pioneers(6), pioneers-server-gtk(6), pioneersai(6), hostname(1)

---

and that's the whole page, bestie. this came out of the pioneers source, dated February 24, 2013, and yeah — the footer says pioneers and pioneers-server-console(6) too, so consider this your cute little sign-off. go start a server, you're gonna slay. 💅✨