User Tools

Site Tools


This is an old revision of the document!


Running Ca3DE

In order to start Ca3DE, simply double-click on the Ca3DE.exe executable file. This file is in the Ca3D-Engine folder that was created during installation.

The Options Dialog

(The Options Dialog is not yet implemented on Linux. Ca3DE will skip it and apply the default options. You can select other worlds either from the command line, or via the in-game console (see section Command Console).)

The Ca3D-Engine Options Dialog After starting, the Options Dialog appears as shown in the figure. This dialog allows you to set up Ca3DE in various ways (detailed below). For your convenience, I preconfigured the dialog settings so that you can, almost always, leave them as they are and simply press the OK button. For a more sophisticated setup, please read the rest of this section. It explains the dialog details in greater depth.

Run-Mode

The upper part of the dialog asks you to choose which role Ca3DE should play in the network (i.e. your LAN or the Internet). I call this role the Ca3DE run-mode. There are three choices:

  • [Client only] Ca3DE acts as a Ca3DE-client only. This means that it will connect to a Ca3DE-server, reachable from within the accessible network: usually a LAN or the Internet.
  • [Server only] Ca3DE acts as a dedicated server only. Other players can run Ca3DE on their computers in “Client only” run-mode and connect to this server. This is the preferred method of setting up an Internet server for Ca3DE.
  • [Both Client and Server] This is the dialog's default choice, where Ca3DE starts up both a server and a client which communicate via the systems localhost. This run-mode is used both for single-player games and for typical multi-player LAN games, where one doesn't want to operate an extra computer as the dedicated server. The current release of Ca3DE actually doesn't differentiate between these two cases. Consequently, when you start a single-player game, you are actually starting a multi-player game with only one participating person. That game is hosted on your machine, and if your network is configured properly, other players can join you in the game. In this mode, some of the other dialog fields are overridden and therefore grayed-out.

Client Options

This part lets you configure Ca3DE in its role as a Ca3DE-client. Depending on your choice of run-mode, not all fields will be available here.

  • [Player name] Your player name. Other players see this name when you talk to them.
  • [Configure] This button does not work yet. Later, one will be able to configure, load and save player profiles here.
  • [Model name] The name of your model. This defines what you look like for others in multi-player games.
  • [Client port number] The local network port number that this client will use for network communication.
  • [Remote hostname or IP] The name or the IP of the server that you wish to connect to.
  • [Remote port number] The port number at which the server is listening on the remote host.
  • [Get Server Info] Retrieves information from the server: such as current world, number of connected players and so on. Not yet implemented.
  • [Ping Server] Pings the server. Mostly for development purposes, but also interesting as long as there are no other (or automatic) ping indicators.
  • [Send NOP] Sends a “NOP” packet to the server (essentially instructing it to do nothing). For development purposes.
  • [Other options] Currently unused.

Server Options

This part lets you configure Ca3DE in its role as a Ca3DE-server. Depending on your choice of run-mode, not all fields will be available here.

  • [Server port number] The local network port number at which the server is reachable when it is running.
  • [World name] As several interesting worlds are included with each demo release, this is usually the most important field when trying out Ca3DE: The combo-box lists all included worlds and lets you easily choose which one you wish to enter.
  • [Other options] Currently unused.

Keyboard Layout

In order to control the player and operate the game, you can use the keys as shown in the table below. The demonstrated layout reflects both keyboard-only player control layout and the popular mouse+keyboard player control layout. The keyboard layout will be made user configurable in future releases.

Action Key Alternative
Move forward (Arrow up) W
Move back (Arrow down) S
Turn left ← (Arrow left) (Mouse left)
Turn right → (Arrow right) (Mouse right)
Strafe left A ,
Strafe right D .
Jump SPACE
Walk R_SHIFT L_SHIFT
Run (even faster) R_CTRL
Look up PAGE UP (Mouse up)
Look down PAGE DOWN (Mouse down)
Look banked CW HOME
Look banked CCW INSERT
Look straight ahead END
Talk / Chat T
Toggle Console ^
Screen-shot F5
Quit program ESC

Keyboard layout for player control and game operations.

The Command Console

In order to activate or deactivate the console, press the accent grave key. This key is labeled ^ on German keyboard layouts.

When the console is active, all keyboard input goes to the console command line and the mouse input is ignored. That means that you cannot control the player while the console is active. The US keyboard layout applies independently from other settings in the operating system.

There are several defined console commands and variables, but I will only give two examples here:

    help

prints out a short console help text, which should be sufficient if you really want to try out the other commands (such as changing the video mode or render style).

    rc passwd ca3d
    rc cl <filename>

rc is the short form for “remote console”. It means that the rest of the line is not processed by the local client, but rather sent to the remote server console. cl is the short form for “change level”. Therefore, the first line introduces you as the super-user at the server. The second line instructs it to initiate a level (world) change. For quick tests, however, it is much easier to leave the game with the ESC key and then to choose a new world from the world list in the options dialog.

Pressing the ^ key deactivates the console and brings you back to the game.

usermanual/running.1162035644.txt.gz · Last modified: 2013-01-07 12:07 (external edit)