action. Basic arguments include:
.TP
.B -h, --help
-display this help and exit
+Display this help and exit.
.br
.SH TIPS
.PP
.PP
There are a plethora of options available for tweaking various aspects of the
game. All options can be set either from a configuration file or by passing
-them as arguments. Some of the more common options can be set from within the
-game.
+them as arguments.
.PP
A
.B yoink
-configuration file ("yoinkrc") consists of key-value pairs organized in a
-logical hierarchy. The format of the file is human-readable, so you can get in
-there with your favorite text editor if you like to work under the hood.
+configuration file ("yoinkrc") consists of key-value pairs. The format is not
+unlike that of other configuration files you are already familiar with. The
+syntax used is lua.
.B yoink
-looks for configuration files and loads them in this order, with the options in
-prior configuration files taking precedence over the same options if they exist
-in multiple configuration files:
+looks for configuration files and loads them in this order, the options from
+each subsequent configuration files taking precedence over the same options from
+previous files.
.TP
-1. $YOINKRC
-This is an optional environment variable you can set to point to a configuration
-file.
-.TP
-2. $HOME/.yoinkrc
-This is a specific user's personal configuration file.
+1. @DATADIR@/yoinkrc
+This is the base configuration file which should be considered read-only. Look
+to this file as an example of the format used for configuration files.
.TP
-3. /etc/yoinkrc
+2. /etc/yoinkrc
This is the system-wide configuration file. Not available on Windows.
.TP
-4. @DATADIR@/yoinkrc
-This is the base configuration file which should be considered read-only. Look
-to this file as an example of the format used for configuration files.
+3. $HOME/.yoinkrc
+This is your own personal configuration file.
+.TP
+4. $YOINKRC
+This is an optional environment variable you can set to point to a configuration
+file.
.PP
Options that are passed as arguments take precedence over options loaded from
the configuration file(s). This mechanism is good for running the game with a
-temporary setting which you do not intend to retain. Keep in mind that if you
-edit and save options in-game, any options you have passed as arguments during
-the invocation of the game will be saved to the
-.I $HOME/.yoinkrc
-configuration file. If this is not what you intended, you may have to go into
-that file and remove any options you didn't intend to set. When passing options
-as arguments, you must use the fully qualified name of the option if it exists
-in a subgroup. For example:
+temporary setting which you do not intend to retain. Examples:
.PP
.TP
-yoink video.fullscreen=true
-Set the option
-.I video.fullscreen
-to true. This will run the game in full-screen mode.
+yoink fullscreen=true
+Run Yoink with the option
+.I fullscreen
+as true. This will run the game in full-screen mode.
.TP
-yoink video.maxfps=60
-Set the option
-.I video.maxfps
-to 60. This will cap the display rate at 60Hz.
+yoink maxfps=60
+Run Yoink with the option
+.I maxfps
+as 60. This will cap the display rate at 60Hz.
.PP
You can also set options with array values. Arrays can be passed on the command
-line by surrounding all the parts with square brackets and separating each part
-by a comma. For example:
+line by surrounding all the parts with curly brackets and separating each part
+by a comma. You may also have to quote the brackets so your shell doesn't parse
+them. For example:
.TP
-yoink video.mode=[1024,768]
-Set the option
-.I video.mode
-to an array with numbers 1024 and 768. The video size will be 1024x768.
+yoink videomode=\\{1024,768\\}
+Run Yoink with the top
+.I videomode
+as the numbers 1024 and 768. The video size will be 1024x768.
.PP
Here is a list of some of the options available:
.TP
-.B engine.rngseed
-The number value used as a seed for the random number generator. Set this to
-make the game more predictable. This is typically only useful for debugging.
-.TP
-.B engine.timestep
-The amount of time in seconds between each update of the physics state. A value
-of 0.01 or lower is ideal for accurate physics approximations. Values that are
-much higher cause the CPU to do less work, but accuracy will suffer. Errors
-could be introduced in the game with extremely high values.
-.TP
-.B game.detail
+.B detail
The level of detail. Possible values are high, medium, and low. This effects
the number of objects drawn to the screen. A high level of detail will draw
everything but could cause poor frame rates if the graphics driver can't keep up
playing the game with the benefit of higher frame rates. See the Notes for more
ways to get good performance.
.TP
-.B input.grab
-Takes a boolean (true or false). If true, the cursor pointer will be "stuck"
-within the area of the window, and many key combinations which would otherwise
-be handled by the window manager will instead be dropped. This is a low-level
-option of limited usefulness.
-.TP
-.B video.colorbuffers
-This takes an array of four number values which represent the number of bits to
-use for red, green, blue, and the alpha channel. This is a low-level option of
-limited usefulness. The default value is almost always preferable.
-.TP
-.B video.showcursor
-This option effects the visibility of the cursor while it is "hovering" over the
-window. If the value is true, the cursor will be visible. Otherwise, the
-cursor will be hidden.
-.TP
-.B video.doublebuffer
+.B doublebuffer
If true, double-buffering will be used to render animations with minimal
distortions. Otherwise, a single buffer will be used. The recommended value is
true.
.TP
-.B video.fullscreen
+.B fullscreen
If true, the window will capture the display and render the game in full screen
splendor. A value of false means the game will run in a window.
.TP
-.B video.maxfps
+.B maxfps
The maximum number of frames to be drawn per second. A value of 50 is pretty
good. If your computer is pretty old, can get away with decreasing this value
and still have reasonably smooth animation. You can set this to a very high
game may not be able to update the physics on schedule which could actually
significantly lower the quality of the animation.
.TP
-.B video.mode
-The resolution or size of the window. The value is an array with three number
-elements representing the width, height, and bits per pixel that make up the
-video mode. A typical value is [800,600] for a size of 800x600 pixels with
-millions of colors (the third number is optional).
-.TP
-.B video.multisamplebuffers
-The number of multisample buffers used.
-.TP
-.B video.multisamplesamples
-The number of multisample samples used.
-.TP
-.B video.printfps
+.B printfps
If true, the current number of frames being draw per second will be printed to
the console. This is usually off by default, but you can set this to true if
you're interested in the draw rate you're actually getting.
.TP
-.B video.resizable
+.B resizable
If true, the window will be resizable by the window manager. This option is
meaningless if the game is drawing to the full screen.
.TP
-.B video.swapcontrol
-If true, drawing will take place at a time which will minimize distortion caused
-by the vertical refreshing of displays. The recommended value is true.
+.B showcursor
+This option effects the visibility of the cursor while it is "hovering" over the
+window. If the value is true, the cursor will be visible. Otherwise, the
+cursor will be hidden.
+.TP
+.B timestep
+The amount of time in seconds between each update of the physics state. A value
+of 0.01 or lower is ideal for accurate physics approximations. Values that are
+much higher cause the CPU to do less work, but accuracy will suffer. Errors
+could be introduced in the game with extremely high values.
+.TP
+.B videomode
+The resolution or size of the window. The value is an array with three number
+elements representing the width, height, and bits per pixel that make up the
+video mode. A typical value is {800,600} for a size of 800x600 pixels with
+millions of colors (the third number is optional).
+.PP
+This is only a list of the more useful options. You'll have to use the source
+to find out about the more esoteric options, but you probably won't need to.
.br
.SH ENVIRONMENT
.PP
If set to a path of a valid configuration file,
.B yoink
will load the options from that file, and those options will take precedence
-over options loaded from other configuration files. Any in-game saving will
-cause this file to be over-written by the new options rather than the
-.I $HOME/.yoinkrc
-config file.
+over options loaded from other configuration files.
.br
.SH NOTES
.PP
is. Yoink is really not all that heavy on graphics, but it doesn't take much to
overload a software implementation. If you're stuck without hardware
acceleration, there are some things you can do to get better frame rates:
-.PP
-1. Decrease the resolution with the
-.I video.mode
-option. Due to the nature of the graphics in the game, you can go as low as
-320x240 and not notice a large reduction in image quality. You can take
-advantage of this by decreasing the resolution and running full-screen (so the
-window is not so itty bitty on your monitor). This will help out a lot. Try
-this:
.TP
-yoink video.mode=[320,240] video.fullscreen=true
-.PP
-2. Decrease the level of detail with the
-.I game.detail
-option.
+1. Decrease the resolution.
+Use the
+.I videomode
+option. This speeds up software renderers considerably.
+.TP
+2. Decrease the level of rendering detail.
+Use the
+.I detail
+option. The game world may look sparse or incomplete, but that may be better
+than choppy animation.
.PP
On the other hand, if you already get high frame rates, you may also want to cap
the rate so that your computer doesn't do more work than it really needs to.
-This may be useful when you run
-.B yoink
-on your production server at work. You can get reasonably smooth animation at
-around 30fps, but you can probably tell a difference between that and a higher
-rate like 50fps. The latter will look noticeably smoother and nice, while the
-former is just "acceptable." See the
-.I video.maxfps
+You can get reasonably smooth animation at around 30fps, but you can probably
+tell a difference between that and a higher rate like 50fps. The latter will
+look noticeably smoother and nice, while the former is just "okay." See
+the
+.I maxfps
option.
.br
.SH BUGS
projects / chaz / yoink / blobdiff