speedwise-node 0.3.6
This is the server node module to connect your Assetto Corsa game servers with speedwise.de.
License: MIT
Keywords: assetto corsa,ac,speedwise,stats,statistics,monitoring,banlist,server,dedicated server,gameserver,game,racing

speedwise-node
=====================

This is a library to connect racing simulation servers (currently only Assetto Corsa) with speedwise.de to collect session statistics and make use of a global ban list moderated by a community of stewards.

Installation
------------

The library is tested and developed for Windows 7+ 64bit and Debian/Ubuntu Linux distributions (of course, you will be able to get it running on other distributions).

Debian/Ubuntu
^^^^^^^^^^^^^

::

    # The following procedure is tested for Ubuntu 14.04 LTS 64 bit. 
    # First we install all requirements
    sudo apt-get install python-dev build-essential mono-complete

    # download and install pip (see https://pip.pypa.io/en/latest/installing.html , if you don't trust me)
    wget https://bootstrap.pypa.io/get-pip.py
    sudo python get-pip.py

    # download and install the speedwise-node
    sudo pip install speedwise-node

Windows
^^^^^^^

1. Install http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf&displaylang=en
2. Install python27, pip and do a python pip install speedwise-node
3. or Download the generated exe file from http://speedwise.de/gameserver\_admins

Configuration
-------------

The server node is configured by a simple ini file defining the paths to your dedicated server installation, a folder containing configuration presets for your server instances and a folder (workspace) where these instance will live in.

Furthermore your obtained credentials (SpeedwiseServerId and SpeedwiseServerSecret) for speedwise.de are placed underneath the [Speedwise] section of this file. If you need credentials join the speedwise Steam group (http://steamcommunity.com/groups/speedwise-de) and contact the admins.

::

    [Paths]
    DedicatedServerBaseDirectory = C:\Program Files (x86)\Steam\SteamApps\common\assettocorsa\server
    DedicatedServerPresetsFolder = C:\Program Files (x86)\Steam\SteamApps\common\assettocorsa\server\presets
    DedicatedServerWorkspacesFolder = C:\ACServers

    [Speedwise]
    SpeedwiseServerId = 4711
    SpeedwiseServerSecret = yourSharedSecret
    SpeedwiseHost = speedwise.de
    SpeedwisePort = 80

Usage
-----

Start the server node as described below and sign in into your speedwise account (http://speedwise.de). If you configured your machine correctly you can now access your server control dashboard through http://speedwise.de/gameserver\_admins/servers.

Ubuntu/Debian
^^^^^^^^^^^^^

::

    # Searches for a speedwise.ini in the current folder.
    speedwise-node

    # or specify the config explicitly
    speedwise-node --config-file /path/to/your/speedwise.ini

    # optionally specify a preset name (=preset folder name) that should be started automatically on startup
    speedwise-node --preset GT3_Spa

    # without installing via pip
    python -m hgross.speedwise_node
    # or
    python -m hgross.speedwise_node --config-file /path/to/your/speedwise.ini

Windows
^^^^^^^

Using the binary from http://speedwise.de/gameserver\_admins: 1. Unpack the speedwise-node into a dedicated folder 2. Place your speedwise.ini 3. Make sure you configured your paths and credentials correctly 4. Start speedwise\_node.exe by double clicking speedwise\_node.exe.

Open ports
----------

You need to configure your firewall/router to forward port 9055 (TCP) to your machine as well as the usual Assetto Corsa ports which you have configured in your presets (server\_cfg.ini).

Upgrading
---------

Linux users upgrade through pip: ``$ pip install --upgrade speedwise-node`` Windows users have to (re-)download the distribution from http://speedwise.de/gameserver\_admins Make sure to backup your config file!