ark-query-tool
v1.0.38
Published
NodeJS Web Service that lets you load all the data from your ARK server Asynchronously.
Downloads
9
Readme
NodeJS-ArkService
This repository houses a NodeJS Web Service that lets you load all the data from your ARK server Asynchronously. The nodejs server must be on the same server that houses your ARK server in order for this to function properly. You also will need to open up the port you specify in the settings.json to the outside world.
Install
npm install ark-query-tool
Inside your index.js just put the following,
var arkquery = require('ark-query-tool');
arkquery.startServer();
Standalone
If you don't want to use this as an external module, clone this repo, run npm install and then node index.js start.
Setup
First you need to copy settings.json-example to settings.json and edit everything inside OR just run the module once and it will generate a settings.json for you that you can modify. Make sure nothing says CHANGEME when you are done. Also make note of your secret as you'll need it to setup your api key.
API Key
Your api key will be outputted to you in your console and log file the first time you run the module. If you forget to save the api key, just delete your player.sqlite and let it regen the cache.
Result
After running node index.js, your output should be similiar to this.
Config verification finished!
Player DB....
Caching Steam Info...
Profiles are done updating!
Steam bans are done updating!
Time to start: 2s
Setting up Tribes...
Ark Query Server Up At http://:::8081
Settings
daemon_mode
This tells the module to load as a daemon and not as blocking process. Please note you will not see any errors/output with this enabled. Default: false
log_console
Enables logging to a file named console.txt. There will be a backup log called console.old.txt that will be created on launch. Default: false
sourcequery.host
Hostname/IP of your ARK server. Default: "your.ark.server"
sourcequery.port
Port your ARK serve uses Default: 27015
API Calls
All api calls (unless otherwise noted) must be encoded as application/json and be a valid JSON call.
For Example:
jQuery.post({url:"http://localhost:8081/listOnline",data:JSON.stringify({api_key:"YOUR_KEY"}),success:function(d){console.log(d);},contentType:"application/json"});
//outputs
{
players: ["","first_player","second_player",""]
}
getServerData
POST: {api_key: YOURKEY}
RETURNS: {d:{mods:[],map:'',maxplayers:0}}
getChat
POST: {api_key: YOURKEY}
RETURNS: {chat:[]}
listOnline
POST: {api_key: YOURKEY}
RETURNS: {players:[]}
saveWorld
POST: {api_key: YOURKEY}
RETURNS: {text:'World Saved'}
destroyDinos
POST: {api_key: YOURKEY}
RETURNS: {text:'Wild Dinos Destroyed'}
command
POST: {api_key: YOURKEY, cmd: RCONCOMMAND}
RETURNS: {result:''}
broadcast
POST: {api_key: YOURKEY, msg: YOURMESSAGE}
RETURNS: {chat:'[ALL] YOURMESSAGE'}
listTribes/true
POST: {api_key: YOURKEY}
RETURNS: {d:[
{"Id":1234567890,
"Name":"",
"OwnerId":123456789,
"FileCreated":"2016-07-04 17:15:34",
"FileUpdated":"2016-07-09 15:10:33"}
]}
listTribes/false
POST: {api_key: YOURKEY}
RETURNS: {
d:{
1234567890:
{"Id":1234567890,
"Name":"",
"OwnerId":123456789,
"FileCreated":"2016-07-04 17:15:34",
"FileUpdated":"2016-07-09 15:10:33"}
}
}
listPlayers
POST: {api_key: YOURKEY}
RETURNS: {d:[
{"Id":132456789,
"TribeId":123456789,
"Level":50,
"Engrams":1000,
"SteamId":"1234156748974",
"Admin":null,
"CharacterName":"",
"SteamName":"",
"ProfileUrl":"http://steamcommunity.com/id/",
"AvatarUrl":"https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/",
"CommunityBanned":0,
"VACBanned":0,
"NumberOfVACBans":0,
"NumberOfGameBans":0,
"DaysSinceLastBan":0,
"FileUpdated":"2016-07-09 15:10:33",
"FileCreated":"2016-07-04 17:15:34"}
]}
getPlayer
POST: {api_key: YOURKEY, id: STEAMID}
RETURNS: {d:
{"Id":132456789,
"TribeId":123456789,
"Level":50,
"Engrams":1000,
"SteamId":"1234156748974",
"Admin":null,
"CharacterName":"",
"SteamName":"",
"ProfileUrl":"http://steamcommunity.com/id/",
"AvatarUrl":"https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/",
"CommunityBanned":0,
"VACBanned":0,
"NumberOfVACBans":0,
"NumberOfGameBans":0,
"DaysSinceLastBan":0,
"FileUpdated":"2016-07-09 15:10:33",
"FileCreated":"2016-07-04 17:15:34"}
}