Server command line

From X-Moto
Revision as of 14:47, 22 April 2009 by Nadenislamarre (talk | contribs)
Jump to: navigation, search

Since X-Moto 0.5.2, you can control the game server from the X-Moto game.

Connexion to the console

Start your server

To play on the network, you need to start a server (one server for several players).

Go in options => www => server and click on "Start the server". If you don't know what is a port, choose the default one (4130).

Server start.png

Connect to the server

Once a server is started, any player on the network can connect to it (you've to know a name or an ip of the server).

Go in levels => network, put the name of the server and click on "Connect".

"localhost" means your own computer.

Server connect.png

Open the console

Once connected, you can open the console using <ctrl><alt>s keyboard sequence.

Server console.png

A banner is displayed and you get a prompt so that you can type commands.

First admin creation

Thanks to the console, you'll be able to add server administrators. At the beginning, there is no default administrator defined. Only people connected from the localhost (ip 127.0.0.1) can login without password by typing the command "login".

Note: once an admnistrator is created, only real administrators can connect. People from localhost can't anymore be connected without an account (protect your ~/.xmoto directory so that any system user can create account directly by modifiying database files).

Commands

help

This command lists the available commands and their syntax. This command takes no argument.

login

This command is required to identify yourself to the game server. Use it without any argument if there is still no administrator on the server. Give your password as argument if you're an administrator of the server.

$ login mypassword

logout

This command can be used if you want to logout without closing X-Moto. This command takes no argument.

changepassword

Use this command to change your password. When an admninistrator is created, the initial password is choosed by the admnistrator which create the account. The first thing to do for the new admnistrator is to change his password. This command takes the new password as argument

$ changepassword my_new_password

lsplayers

Server lsplayers.png

This command lists the connected players on the server. For each player, you can see his identifier (a number), his name and his ip. This command takes no argument.

lsadmins

Server lsadmins.png

This command lists the admnistrators on the server. For each administrator, you can see his identifier (a number), and his name. This command takes no argument.

addadmin

rmadmin

lsbans

ban

unban

stats

Extra controls

  • <ctrl> l : clear the console
  • <ctrl> d : close the console
  • arrow up, arrow down : use shell history