KScript - Server Scripting for KAG Classic

KScript
Hey everyone, let me introduce you to a project Ardivaba and I have been working on for the past few weeks.

What is KScript?
A tool used to create and execute scripts that can interact with the server.
It allows you do make your own scripts for your server: kick/freeze/ban/swap a player, add custom chat commands, spawn zombies or any other entities at a certain position...

How does it work?
It connects to your server, via tcpr, and parses the rcon output which is then processed by a script manager.
Here's a sample of code taken from a mod:

PHP:

ks.events.on('newPlayer', function(player) {
    ks.server.message('Hello, ' + player.getName() + '!');
});

This sample will greet players when they joins the server.

Where do I get it?
https://github.com/master4523/kscript

Available mods:
- Killstreaks by master4523
Shows first blood and killing sprees - Check Oban's Epic RTDM Server for a demo.

- SnIcKeRs mods by SnIcKeRs
A collection of mods, including kill/death ranking, spam kick, message of the day, time commands and much more!

Servers featuring KScript:
- Strathos' Dungeon & Zombies Server
- jammer312s Magic CTF
- Oban's Epic RTDM Server

If you've made a mod, or if you're hosting a server with KScript, send it to me and I'll gladly add it here :)

Help:
We have an IRC channel if you need help: #kag.kscript @ QuakeNet

 

There's already a folder which is called /mods/.
Put the downloaded mods inside that folder.

 

getData() returns an object which contains any custom variables. It is like a local storage for each player.

PHP:

player.data.myint = 42;
player.data.mystr = 'abc';
player.getData()
=> {  myint: 42, mystr: 'abc' }

It is also being shared between mods and extensions.

It doesn't matter. KScript connects via tcpr so you can run it either locally or remotely.

 

By default it is "./node data/kscript_app.js", did you inadvertently add a '/' before 'data'?
For delays, you could use javascript's setTimeout(callback, delay):

Code:

setTimeout(function() {
    log('Ding!');
}, 1000);

This script will show 'Ding!' after 1 second (1000ms)

 

Of course you can. Mazey's post is actually misleading.
You can use KScript on Windows, as long as your server is on Linux.

 

Theorically they can't, but they can change their clantag (which emits the nameChange event)
Also I forgot to mention but KScript is incompatible with migrants so if you're using it on a server with the default zombie gamemode you have to remove the migrants from the game.

 

Well it should work. Don't forget to use ks.server.getPlayerByName(name) in order to return a Player object.