Zenith
Player's Guide: Commands

Contents

Command Console

The console is not needed to play the game, and is only for players who want to see what's happening 'behind the scenes', or, dare I say it, cheat! Bear in mind that if you cheat, your satisfaction should be dampened for any wins that you do achieve!

See the Command Reference below for a full list of commands.

Using the Command Console

Viewing the Command Console

To show the Command Console, press F9 while playing the game. Note that the game will continue playing when you are using the Command Console, but if you press ESC in the game window, the game will pause.

Running commands in the Command Console

The command window has two parts:

  • At the bottom is the command line, where you enter commands. Just type a command, and press ENTER. The drop-down box maintains a history of commands, and any previously-entered commands will be used to auto-complete any typing you have started.
  • The remainder of the Command Console shows the responses to your commands. You can copy these to the clipboard if you wish. To clear the window, press the Clear button. See also the LOG command.

Scripting

Zenith is able to run very simple scripts (just text files in the scripts subfolder where Zenith is stored, having one command per line, with no flow control).

Run scripts using the RUN or EXECUTE command, followed by the filename of the script. Scripts can run other scripts, but take care to avoid 'circular references'. Some scripts have special uses:

  • DefaultStartGame.zsc will be run after a landscape has been built at the start of each game.
  • UserPreferences.zsc will be run after Zenith starts, and after Preferences.zsc is loaded. Use this file to tweak performance options, or set any scriptable option.
  • Preferences.zsc is used by Zenith to store the game's configuration, and is overwritten every time Zenith exits. If you need customisations, put them in UserPreferences.zsc or DefaultStartGame.zsc.

Command Reference

Abbreviated Commands

For convenience, there are usually two forms for a command: the full command (like EXECUTE), and an abbreviated command (like EXE). Both versions have exactly the same effect. We show both forms here by underlining the abbreviated part, e.g. EXECUTE.

Command group: Console

HELP

[ COMMANDS | DETAIL | <command name> ]

Lists commands and their parameters.

CLS

(no parameters)

Clears the Console display.

FONT

{ NAME <font name> | SIZE <point size> ]

Displays the current font settings (when supplied with no parameters), or sets the font name or size.

TYPE

<filename>

Displays a text file in the Command Console window. Filenames having spaces should be enclosed in double quotes.

ECHO or !

<text>

Show text in the console (useful in scripts). Text having spaces should be enclosed in double quotes.

LOG

[ CLEAR | SAVE <filename> | 0 | 1 | 2 ]

  • CLEAR clears the log;
  • SAVE saves the log to the specified filename;
  • 0, 1, or 2 sets the debugging or detail level of log entries (not enabled on release versions).

Command group: Control

KEYS

(no parameters)

Shows the game controls.

EXECUTE or RUN

<filename>

Runs a list of commands in a script (text file); <filename> includes the extension.

NEW

(no parameters)

Starts a new game, on a new landscape.

EXIT

(no parameters)

Closes Zenith application.

Command group: Cheats

CHEAT

[ 0 | 1 | OFF | ON ]

When no parameters are supplied, this shows the state of the Cheat Lock. Parameters change the Cheat Lock. When OFF or 0, no cheat commands are effective.

PLAYER

[ <player number> [ ENERGY <level> ] ]

Shows information, or sets the energy level for a player.

GETHEIGHT

[ <x>, <z> [ , <x2>, <z2> ] ]

Shows heights of landscape points.

LANDSCAPE

[ SCANNERS { 0 | 1 | 2 | OFF | ON | ALL } ]

When no parameters are supplied, this shows Landscape statistics, Landscape Size, Scanners, and details of Players. The SCANNERS option activates or deactivates scanner (Sentinel and Sentry) activity.

ALLOCATION

(no parameters)

Views the game's maximum usage of static allocatable capacity.

Command group: Configuration

PREFERENCES

<option>, <value>

Preferences options and values

Option

Value

Description

S_DIFFICULTY

<level>

Sets the Difficulty slider, <level> = 0..100.

S_DIFFVARIATION

<value>

Sets the Variation slider, <value> = 0..100.

S_LANDSCAPERANDOM

<value>

When <value> is ON or 1, a completely different landscape is used every game (changing the landscape-generation seed every game). OFF or 0 uses a similar landscape for each game.

S_LANDSCAPENUMBER

<seed>

<seed> = landscape code. Used with Difficulty to generate a landscape.

S_GAMESPEED

<value>

A <value> above 1 results in a faster game; below 1 results a slower game.

S_SENTRYSPEED

<value>

A <value> above 1 results in faster sentry movement; below 1 results a slower movement.

S_SCANSPEED

<value>

A <value> above 1 results in a faster sentry scanning; below 1 results a slower scanning.

S_SCANSECTOR

<value>

A <value> above 1 results in wider scan secotrs when sentries scan; below 1 results in narrower scanning sectors.

S_RESOURCES

<value>

A <value> above 1 results more tree resources on a landscape; below 1 results less trees.

C_REVERSEHORIZONTAL

<value>

When <value> is ON or 1, the horizontal direction of mouse look is reversed.

C_REVERSEVERTICAL

<value>

When <value> is ON or 1, the vertical direction of mouse look is reversed.

C_REVERSEZOOM

<value>

When <value> is ON or 1, the direction of the zoom (mouse wheel) is reversed.

C_LOCKCURSOR

<value>

When <value> is ON or 1, the cursor remains in the same place on the screen when mouse look is used.

C_SENSITIVITY

<value>

<value> = 0..100. Larger values turns the camera more with mouse look.

C_SHOWHINTS

<value>

When <value> is ON or 1, the hints panel is shown.

PERFORMANCE

[ RES | FPS | AA [Default|NONE|2x|2xHQ|4x|4xHQ] | SLEEP [0|1|OFF|ON] ]

With no parameters supplied, all information is shown.

  • RES displays resolution;
  • FPS displays frames-per-second (rendered);
  • AA displays anti-aliasing, or sets anti-aliasing mode, subject to availability;
  • SLEEP displays or sets sleep mode (experimental power saving feature).

Command group: Easter Eggs

You might say that it ceases to be an Easter Egg if it is documented - of course, we haven't listed all of them! Provided here for your pleasure...

SPECIAL

[ DARK <value> ]

Makes it go dark, and you can't see very far. Vary visible distance by changing <value> (0.1 is about right). Note that the Sentinel and Sentries can still see you!