Difference between revisions of "Server command line"

From X-Moto
Jump to: navigation, search
(rmadmin)
Line 77: Line 77:
  
 
==rmadmin==
 
==rmadmin==
 +
This command is used to remove an administrator. This command takes only 1 argument : the identifier of the administrator to remove, use lsadmins to get it.
 +
$ rmadmin 2
 +
 
==lsbans==
 
==lsbans==
 
==ban==
 
==ban==

Revision as of 15:01, 22 April 2009

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

This command is used to add admnistrators. It takes 2 arguments : the id of the player to become an admnistrator and the password for this admnistrator.

Note: use "lsplayers" to get the identifier of the player. Identifier are used instead of profile name because it's easier and your keyboard could have not some special chars (if you want a chineese, a russian, a greek or any man with a non ascii name because an administrator)

In the following example, 0 is the identifier of the player (Nicolas in the previous screenshots) which will become admnistrator.

$ addadmin 0 his_password

rmadmin

This command is used to remove an administrator. This command takes only 1 argument : the identifier of the administrator to remove, use lsadmins to get it.

$ rmadmin 2

lsbans

ban

unban

stats

Extra controls

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