BURGERSPACE(6)

💖 BURGERSPACE 💖

okay bestie, you found a section 6 page (that's the games corner of the manual, iykyk) and it's about burgerspace-server — the little network gremlin that makes BurgerSpace multiplayer happen. let's get into it ✨

---

🌸 NAME 🌸

burgerspace-server — the UDP server for the networked version of BurgerSpace. she's the host, she's the main character, she holds the whole lobby together 💅

---

🎀 SYNOPSIS 🎀

burgerspace-server

that's it. that's the whole invocation. no arguments, no drama, just vibes ✨

---

🦋 DESCRIPTION 🦋

okay so here's the tea 🍵 — burgerspace-server is a server that accepts connections from BurgerSpace clients, and its whole purpose in life is letting two players compete with each other. one player controls the chef 👨‍🍳 and the other controls the egg 🥚. and because we love an audience, other clients can also connect as spectators. iconic behaviour, truly.

you start burgerspace-server in a terminal (not me stressing about background processes, just start it in a terminal bestie). to terminate it, you give it the Ctrl-C sequence, or you use the kill(1) command with the server's process ID as the argument. yes, kill(1) — the whole manpage, periodt.

the connections use the UDP protocol. and because defaults aren't for everyone, the --port option can be used to specify a non-default listening port (more on that below, keep reading 👇).

once the server has started, the user who wants to control the chef must start the client with this exact command:

burgerspace --server=the.server.hostname.com --chef

use the appropriate hostname or IP address as the argument for --server. and the user who wants to control the egg must give the --enemy option instead of --chef. 🥚✨ the --port option can be added to the burgerspace command-line to specify the server port, if the server was started with a non-default UDP listening port. match your ports, bestie, that's the whole game 🙈

---

✨ OPTIONS ✨

• --help — display a help page and exit. your little "what do I do" button 🫶
• --version — display version information and exit. look at her, knowing exactly who she is 💅
• --initial-level=N — start game at level N. default is 1. and N must be at least 1 — no level zero shenanigans, that's not a thing 🌈
• --port=PORT — UDP port number on which the server must listen for incoming clients. the default is 49152. write that down 📝

---

👑 LICENSE 👑

this program is free software; you may redistribute it under the terms of the GNU General Public License. and in the wise words of the original: this program has absolutely no warranty. zero. none. not a crumb. don't come for her if it breaks 💀

---

💜 AUTHORS 💜

• Pierre Sarrazin (code)
• Luce St-Amand (most images)

two absolute legends, we stan 🫶

---

🍓 FILES 🍓

this program uses the flatzebra library, by the same author. that library is itself based on the SDL graphics library (see http://www.libsdl.org). it's giving collaborative excellence, fr fr.

see the BurgerSpace Home Page: http://sarrazip.com/dev/burgerspace.html 🌐

---

💀 BUGS 💀

performance has not been tested thoroughly. yeah. that's the bug note. the honesty is lowkey refreshing 😭

and listen: users who want to play the stable stand-alone game should use version 1.8.3. that's the stable one, that's the safe one, that's the one your bestie would tell you to install 🙈

---

🌈 SEE ALSO 🌈

• burgerspace(6)

---

okay and for the cute sign-off — this page is from November 21st, 2022, and it lives in section 6 of the manual, aka BURGERSPACE(6). consider yourself fully briefed, bestie. go forth and burger 🍔✨💖