Subsections

Getting started

Intro: command syntax

On the Windows platform, to run any of the commands, check the Start Menu under Programs -> Hogs. On all other platforms, use the syntax:

hogs <command> [arguments].

For example, to run the game browser, run hogs browse. To run the client and connect to a specified host (e.g., localhost), run hogs play -h localhost.

Play: get started

If you know the address of a machine on which a Hogs server is running, you can run the hogs client yourself and give it the hostname as an argument. For this, use:

hogs play -h HOSTNAME

where HOSTNAME is the address of a machine on which the server is running.

The game starts up. Controls are listed if you press and hold the SHIFT key.

Browse: see your favorite games

If you know a number of servers on which games might be held, you can list them in the favorite-servers file in the data folder whereever Hogs was installed. By default on Linux, this would be /usr/local/share/hogs/data/favorite-servers. On Windows, it's probably C:\Program Files\Hogs\data\favorite-servers.

Then, you can run the game browser, which lets you monitor and connect to any of a number of servers. It only shows active servers. It can be run with

hogs browse [FILENAME]

The optional FILENAME argument can be used to specify a different file other than the default favorite-servers file.

From Windows, this can also be accessed through the Start Menu.

Ping: monitor servers

You may want to know more information about a server without actually joining it. The ping tools connects to a remote server, obtains the following information, and disconnects:

It can be run with the command

hogs ping HOSTNAME

where HOSTNAME is the name of the remote host on which a server is running. A command line version also exists as:

hogs text-ping HOSTNAME

It is not available from the Start Menu, since it takes an argument.

Hogs Project 2005-05-15