FOOBILLARD(6)

📦 version 3.0a, in fedora 43, fedora 44

🎱 FOOBILLARD 🎱

okay so bestie, welcome to the manual page for foobillard — it's a section 6 page, so it lives in the Games Manual corner of your system. Grab a snack, we're going through it all 💖

✨ NAME ✨

foobillard — an OpenGL billard game 🎱💅

✨ SYNOPSIS ✨

foobillard [options]

✨ DESCRIPTION ✨

So here's the tea: FooBillard is an OpenGL billard game for Linux 🐧✨. It's still under development, but the main physics are already implemented. And like — if you're a billard-pro and you're sitting there like "um where are the physics I need", please, contact the author. They want to hear from you 🫶

✨ OPTIONS ✨

  • --p1 ai|human, --player1 ai|human — sets player1 to be an ai (that's the computer, bestie 🤖) or a human player.
  • --p2 ai|human, --player2 ai|human — same deal, but for player2. ai or human, your call 💅
  • --name1 NAME — sets player1's name to NAME. Give them main character energy 👑
  • --name2 NAME — sets player2's name to NAME. Yes, they get one too 💖
  • --8ball — play a game of 8-ball.
  • --9ball — play a game of 9-ball.
  • --carambol — play a game of carambol.
  • --snooker — play a game of snooker.
  • --tablecolor COLOR — table color, in C-style hex notation <0xrrggbb>.
  • --edgecolor COLOR — edge color, also in C-style hex notation <0xrrggbb>.
  • --chromeblue — blue table with chrome edges. It's giving very sleek ✨
  • --goldgreen — green table with gold edges. Fancy fr fr 💛
  • --goldred — red table with gold edges. Obsessed.
  • --blackwhite — black table with a white frame. Monochrome moment 🖤🤍
  • --blackbeige — beige table with black metal.
  • --tablesize NUM — sets the table size (that's the length) in foot to NUM. Default is 7.0 📏
  • --lensflare, --nolensflare — turns lensflare on or off. Sparkle toggle, basically ✨
  • --poslight — use positional light.
  • --dirlight — use directional light.
  • --ai1err NUM — sets the errorlevel of the 1st ai player to NUM (0..1).
  • --ai2err NUM — sets the errorlevel of the 2nd ai player to NUM (0..1).
  • --balldetail l|m|h — sets the ball detail to [l]ow, [m]edium or [h]igh.
  • --rgstereo — starts the game in stereo mode (red-green(cyan)) 🌈
  • --hostaddr HOST — play a network game with HOST as server. The NETWORK GAMES section down below has the details 👀
  • --portnum PORT — use PORT for the TCP connection. Again, NETWORK GAMES below, bestie.
  • --geometry ARG — sets the window geometry to ARG (WIDTHxHEIGHT).
  • --fullscreen — play in fullscreen mode. Immersive queen behavior 💅
  • --freemove ARG — turns free move in external view mode on or off.
  • --cuberef ARG — turns rendered cubemap reflections on or off.
  • --cuberes ARG — texture size for cuberef (has to be a power of 2 ⚠️ like, it has to).
  • --bumpref ARG — turns bumpmap reflections of edges on or off.
  • --balltraces ARG — turns balltraces on or off.
  • --help — shows an overview of available options. The classic 🫶

🎮 CONTROLS 🎮

Here's the whole rundown of the keyboard/mouse functions available in FooBillard, and yes, we're doing all of them:

  • Mouse moving + button1 — rotate
  • Mouse moving + button2 — zoom
  • Mouse moving + hold b2 after b1 — place cue ball
  • Mouse moving + hold b1 after b2 — adjust effet
  • No mouse move + b1 after b2 — toggle cue view on/off
  • Mouse moving + button2 + Ctrl — FOV - adjust
  • Mouse moving + button1 + Shift — place cue ball (when active)
  • Mouse moving + button2 + Shift — cue offset adjust
  • Mouse button 3 — shoot
  • <space> or <enter> — shoot
  • <up>, <down> — adjust strength
  • <pg up>, <pg down> — adjust strength
  • <left>, <right> — rotate
  • <ESC> — end game
  • <0> — suggest AI-shot
  • <a> — toggle current player AI/human
  • <n> — restart game
  • <b> — show FPS
  • <v> — turn vertical help-line on/off
  • <c>, <F3> — toggle cue view on/off
  • <f>, <F4> — toggle free move mode
  • <r> — toggle simpler reflections
  • <s> — toggle red/green stereo
  • <F1> — toggle help screen
  • <F2> — birdview (same as <F3>+<F4>+centered pos)

📁 CONFIG FILE 📁

Good news: you can place a config file named .foobillardrc in your home directory 🏠✨

That file can contain all possible commandline arguments — but without the preceding dashes, and one line for each argument.

And here's the important bit: commandline parameters are parsed after reading the config file, so they override the .foobillardrc settings. Commandline stays winning, periodt 💅

🌐 NETWORK GAMES 🌐

Wanna play over the network with your bestie? Here's how:

  1. Hit <ESC> to get to the menu,
  2. Select <Network Game>/<As Host> on one computer and <Network Game>/<Join>/<OK> on the other machine after having set the proper IP in <Network Game>/<Join>/<IP>.
  3. The <Network Game>/<Port> setting must be the same on both machines. Both. Same. No cap ⚠️

The IP of the host machine can also be set on the client machine (the joining one), by adding hostaddr=IP-ADDR in the config file (see below), or by passing it as commandline option: --hostaddr=IP-ADDR

Starting from menu, the host sends its gamestate variables to the client, so every clienside settings get overriden by the host (gametype, tablesize, player names, ...). Host is the main character here, sorry 💀

The data sent between the two computers are only the shot-data, like strength, cue offset and direction. So if the two machines have a different internal floating point accuracy, the games may drift apart after a certain amount of time. Yeah. That's a real caveat, not me being dramatic 😭

👀 SEE ALSO 👀

FooBillard homepage: http://foobillard.sunsite.dk/

💜 AUTHOR 💜

FooBillard was written by Florian Berger <harpin_floh@yahoo.de> 👑

This manpage was written by Wouter Eerdekens <retuow@xs4all.be> for the Debian GNU/Linux system (but may be used by others). Legend behavior, honestly 🫶

and that's the whole page bestie 💖 it's a section 6 Games Manual page, and the footer at the very bottom just says FOOBILLARD(6) all over again — no extra version or date tea in there, so that's genuinely all she wrote 🌸🎀🦋

📦 where this page comes from