Contents
English (United Kingdom)French (Fr)Deutsch (DE-CH-AT)
Random Thumbnail
ALRF_schot059.jpg
Search
Login
Who Is Online?
We have 56 guests online
Navigation
Home Descent 3 Descent 3 dedicated server tool for Windows Sending out emails on server events
Most Recent
Featured Articles
Joomla 1.5 Featured Articles
Navigation
Home Descent 3 Descent 3 dedicated server tool for Windows Sending out emails on server events
English (United Kingdom)French (Fr)Deutsch (DE-CH-AT)
Sending out emails on server events E-mail
User Rating: / 0
PoorBest 
Descent 3 - Descent 3 dedicated server tool for Windows
Written by Thomas   
Saturday, 22 December 2012 00:00
Article Index
Sending out emails on server events
Let's do it
Alternatives to Blat
All Pages

 

For several versions already D3Server3 supports so-called server events. These events are triggered when the event in question occurs, like when a game server is started or when a player joins or leaves. As a result an application can be invoked (i.e. executed) with parameters. This includes calling any type of scripting language when its interpreter is executed.

 

For a full list of possible events see running applications on server events.

Since an application will be executed as the resulting action of an event literelly anything that can be done with computer technology could be performed. Probably the declining number of players online made American Spirit suggest an option to send out emails when someone joins a server.

In theory, to achieve this we only need to develop an application that does just this. Lucky for us, some innovative people have done this already.

The software is called Blat (http://www.blat.net).

Blat is a commandline tool to send out emails. It's got tons of different options (http://www.blat.net/syntax/syntax.html), and configuring Blat might be the most difficult and time-consuming task here since calling it for a server event is pretty simple. First decide which event should trigger the mail, then create an entry for it in your ServerEvents.ini file. The section in the ini file specifies the event.

Let's say, you'd like to send out an email when a dedicated server is started manually. In that case find the section OnServerManualStart in ServerEvents.ini. The section name is usually enclosed in square brackets ("[]"):

[OnServerManualStart]

Underneath this line add the line below. Note that this text needs to go in one single line.

  1. Default=BLAT.EXE -optionfile BlatOptions.txt -debug -subject "Descent 3 server started. This is an email from D3Server3" -body "The test server $ServerName has been started."

"Default" means that the event is triggered every time a server is started manually (with the Start button etc), independent of the server's name or port number. BLAT.EXE is the executable program that should be fired up in that case.

Instead of the key name "Default" you can also specify exactly which server the event applies to.

(port number):(server name)=

Example:

  1. 2093:Test server=

(port number) is the UDP port number the server runs on. It's the port number specified in the server's configuration dialog window or an automatically assigned port if this function used. The port number is also displayed in D3Server3's main window when the Descent 3 gameserver is running. It's 2093 in the example above.

(server name) is the gameserver's name. It's "Test server" in the example above. Don't forget the colon (":") between the port and the server name.

For all options regarding the possible server events and how to place them in the file ServerEvents.ini have a look at "server events". Here we'll only discuss the line with BLAT, which is called independent of the server name or port number in our example:

  1. Default=BLAT.EXE -optionfile BlatOptions.txt -debug -subject "Descent 3 server started. This is an email from D3Server3" -body "The test server $ServerName has been started."

The first two parameters tell Blat to find some options in the file BlatOptions.txt. Of course we could have put all options we need directly in the entry within ServerEvents.ini but then it's probably not so easy to test if the settings are correct.

 



Last Updated on Wednesday, 15 May 2013 13:29
 
You need to login or register to post comments.
Discuss this item on the forums. (0 posts)
Discuss (0 posts)