tes3mp-server

Repository for the official Modding-OpenMW.com TES3MP server.

Setup

This has been setup to be a clone-and-go package; you can be up and running in a few steps:

git clone --recursive http://git.modding-openmw.com/TES3MP/tes3mp-server.git
cd tes3mp-server
make

This will only work out of the box on Linux, however it should be simple to swap in macOS or Windows executables.

Enabling Extra Modules

IRC Bridge / Live Map

The IrcBridge and LiveMap modules are not loaded by default. Enable them by setting an environment variable:

# Enable IrcBridge
TES3MP_USE_IRC=t make

# Enable LiveMap
TES3MP_USE_LIVEMAP=t make

# Enable both
TES3MP_USE_IRC=t TES3MP_USE_LIVEMAP=t make

Leveling

By default the vanilla Morrowind leveling system is used, but this too can be changed with an environment variable:

# Use Better Vanilla Leveling
TES3MP_LEVELING=BetterVanillaLeveling make

# Use NCGD
TES3MP_LEVELING=NCGD make

Startup / Spawning

By default the default TES3MP spawn is used. Other options are available:

# Use the Original Start spawning system
TES3MP_SPAWN=OriginalStart make

# Use random spawn points
TES3MP_SPAWN=RandomSpawn make

Example With Extra Options

Below is how I run the server:

TES3MP_LEVELING=NCGD TES3MP_SPAWN=RandomSpawn TES3MP_USE_IRC=t TES3MP_USE_LIVEMAP=t make

This enables: NCGD for leveling, random player spawn locations, an IRC chat bot, and a Live Map.

A sample runit service might look like this:

#!/bin/sh
export LD_LIBRARY_PATH=/srv/tes3mp/server/bin/lib
export TES3MP_USE_IRC=t
export TES3MP_LEVELING=NCGD
export TES3MP_SPAWN=RandomSpawn
export TES3MP_USE_LIVEMAP=t
cd /srv/tes3mp/server/bin
exec chpst -u tes3mp:tes3mp ./tes3mp-server.x86_64

Customizing

To create a customized or forked version of this server:

# From within this repo
git checkout -b my-cool-branch-name

Then, from here push your changes to whatever git repo you choose.

For example, Windows or macOS executables could be added instead of the Linux ones I use.

Automated Testing

A simple automated test which verifies a successful startup and shutdown is included:

make test

If this is ran and exists cleanly, you can at least be sure the server starts and exits fine. Note that nothing involving players logging in is tested (yet).