Difference between revisions of "DIRTSAND"

m (Features: gamemgr clarification)
(Setting Up: Update with new commands)
Line 21: Line 21:
  
 
DIRTSAND consists of an interactive terminal run on a terminal session. It is recommended that you use screen or some other such program to be able to run DIRTSAND in the background. It accepts the following commands for operation:
 
DIRTSAND consists of an interactive terminal run on a terminal session. It is recommended that you use screen or some other such program to be able to run DIRTSAND in the background. It accepts the following commands for operation:
* <code>addacct <user> <password></code>: adds a new user account into the database.
+
* <code>addacct <account> <password></code>: adds a new user account into the database.
 +
* <code>addallplayers <user id></code>: adds a reference to the '''All Players''' vault folder to the specified user. This allows the user to send global chat messages and see everyone who is online from the KI.
 
* <code>clients</code>: lists all connected clients.
 
* <code>clients</code>: lists all connected clients.
 
* <code>commdebug <on|off></code>: available only for debug builds; used to debug.
 
* <code>commdebug <on|off></code>: available only for debug builds; used to debug.
 +
* <code>globalsdl <age> <variable> <value></code>: sets a global default value for the specified SDL variable. Used to control Ae'gura blockers, Neighborhood decorations, and seasonal items.
 +
* <code>help</code>: displays information about the available commands.
 
* <code>keygen new</code>: generates new keys for your <code>dirtsand.ini</code> and <code>server.ini</code> files.
 
* <code>keygen new</code>: generates new keys for your <code>dirtsand.ini</code> and <code>server.ini</code> files.
 
* <code>keygen show</code>: shows the <code>server.ini</code> keys.
 
* <code>keygen show</code>: shows the <code>server.ini</code> keys.
* <code>welcome <message></code>: changes the welcome message for your server.
+
* <code>modacct <account> <admin|banned|beta></code>: Toggles flags on a given user account.
* <code>help</code>: displays information about the available commands.
+
* <code>restart <auth|lobby|status> [...]</code>: restart the specified server process.
+
 
* <code>quit</code>: shuts down DIRTSAND.
 
* <code>quit</code>: shuts down DIRTSAND.
 +
* <code>restart <auth|lobby|status> [...]</code>: restart the specified server process.
 +
* <code>restrict</code>: Restricts login attempts to players who are beta testers.
 +
* <code>welcome <message></code>: changes the welcome message for your server.
  
 
[[Category:DIRTSAND]]
 
[[Category:DIRTSAND]]

Revision as of 22:29, 6 January 2016

DIRTSAND

DIRTSAND.png
Category Server
Licence AGPLv3

The D'ni in Real Time Server and Network Daemon (DIRTSAND) is a server software created by Zrax and developed by H'uru to run open-source MO:UL Shards. It is built for integration with the H'uru fork of the CyanWorlds.com Engine.

The source code for DIRTSAND is available on Github: H-uru/dirtsand. For more information about its development, read the development article.

Features

DIRTSAND as it stands today possesses the following features:

  • Compatibility with CWE-ou (partial), H'uru CWE and PlasmaClient (partial) clients.
  • Fully-functional auth server, file server (optional) and gatekeeper.
  • Interactive operating terminal.
  • Support for Linux and potentially other *nix systems.
  • Facilitated setup process.
  • Absence of game manager (feature, not bug): this means that Ayoheek and GZ Markers will not function unless using the H-uru/Plasma client.

Setting Up

DIRTSAND has been designed to be easily-deployable on Linux systems. It might work on other *nix OSes, but it hasn't been tested. The getting started guide will help you set up your Shard using DIRTSAND.

DIRTSAND consists of an interactive terminal run on a terminal session. It is recommended that you use screen or some other such program to be able to run DIRTSAND in the background. It accepts the following commands for operation:

  • addacct <account> <password>: adds a new user account into the database.
  • addallplayers <user id>: adds a reference to the All Players vault folder to the specified user. This allows the user to send global chat messages and see everyone who is online from the KI.
  • clients: lists all connected clients.
  • commdebug <on|off>: available only for debug builds; used to debug.
  • globalsdl <age> <variable> <value>: sets a global default value for the specified SDL variable. Used to control Ae'gura blockers, Neighborhood decorations, and seasonal items.
  • help: displays information about the available commands.
  • keygen new: generates new keys for your dirtsand.ini and server.ini files.
  • keygen show: shows the server.ini keys.
  • modacct <account> <admin|banned|beta>: Toggles flags on a given user account.
  • quit: shuts down DIRTSAND.
  • restart <auth|lobby|status> [...]: restart the specified server process.
  • restrict: Restricts login attempts to players who are beta testers.
  • welcome <message>: changes the welcome message for your server.