Actual version is v1.6 intended for newest Craftbukkit versions.
Basic information
This plugin sends data to custom .PHP file on your website using GET headers. The data is information about current server status, e.g. Online/Offline, number of online players etc.
On the first start of server with this plugin the plugin creates folder ServerStatus and the configuration file. Then you have set data in config and restart the server.
In configuration file config.yml you can set useSecurityKey (true or false), your security key and full path (adress) to the .PHP file.
Security key can be any expession you want, you will need to set it only in this config.yml file and then in .PHP file. Key will be sent by plugin in GET header, and the .PHP file will check if it is equal.
Then you can set connection timeout. It means how long time give you to plugin to connect to .PHP file. (in milliseconds)
(set -1 for default timeout)
And there is a ignore list. Players in ignore list will be ignored from counting and listing players (plugin won't send them to .PHP file).
Finally you can set refresh-rate to some number of seconds. It means that the plugin will send newest information every x seconds. (set -1 for disabling periodic call)
In this .PHP file is only easy script to read data from GET headers and to write it into .TXT file. You have to set the security key and if you are good .PHP programmer, you would be able to rewrite the code to whatever you want (e.g. write data to .HTML files, to MySQL database,...).
You can choose, if you want to have banner.png or some TXT file with server status.
Banner will look like this:
List of GET headers
sec - The security key
status - Status of the server, can be Online or Offline
name - Name of the server, loaded from server-properties file
motd - Server's message of the day from server-properties file
ip - IP adress of the server, loaded from server-properties file
port - Port of server behind the IP adress, loaded from server-properties file
plsnum - Number of online players
maxnum - Maximum number of players, loaded from server-properties file
players - List of online players
log - Reason why was the URL called (It can be "Starting up Minecraft server", "Stopping Minecraft server", "Player (name) has joined the game", "Player (name) has left the game")
plversion - Contains version number of this plugin
bkversion - Contains version number of used Bukkit version
server.properties
Don't forget to set correct information (server-ip, server-port, server-name, max-players) in server's file server.properties!
Commands & Permissions
serverstatus.reload - Allows you to use /serverstatus command, which reloads the config
serverstatus.ignore - Player with this permission will be ignored from counting and listing players
Changelog
v1.6
Added option to set refresh-rate to -1 for disabling periodic call or set it to any time in seconds
Added option to set connection-timeout to -1 for default timeout or set it to any time in milliseconds
(and no kidding, now is the java.lang.NullPointerException error really fixed! :))
i have not found any replies in previous comments regarding this 404 error:
does anyone have a solution?
i know for a fact that the php and the config files point correctly at each other:
config file: http://www.monahan.co.uk/getServerStatus.php
php code located here:http://www.monahan.co.uk/getServerStatus.php (added the hello so that it shows something rather than blank webpage)
any suggestions?
just as a note, i run the minecraft server on one machine and the webserver is on a different machine in the same house.
I too cant seem to be able to get it working, i only get and 404 error when i know its pointing to the right place and my host does have fsockopen enabled :/
Nice Plugin...
...if it works in 1.12.2 or 1.13
I hope you make an update
Can this plugin be used to post server status on a facebook page?
lortet virker jo ikke
working ?
@PerwinCZ
That's great news! Could you also add some functionality? Like custom commands with custom POST requests? For instance in the config:
and in chat:
I am going to make a big update :)
@jamesmonahan
Same problem here: server console say 404 error, but the config files are correct
hi,
i have not found any replies in previous comments regarding this 404 error: does anyone have a solution? i know for a fact that the php and the config files point correctly at each other: config file: http://www.monahan.co.uk/getServerStatus.php php code located here:http://www.monahan.co.uk/getServerStatus.php (added the hello so that it shows something rather than blank webpage)
any suggestions?
just as a note, i run the minecraft server on one machine and the webserver is on a different machine in the same house.
thanks in advance for an answer
James
Wow, 10,000 downloads! Congratulations!
Can someone tell me how to set all of this up because I am not very technical. Thanks in advance!
There's no Ticket Section, DERP A+
I too cant seem to be able to get it working, i only get and 404 error when i know its pointing to the right place and my host does have fsockopen enabled :/
This is where my php file is: http://clustermc.net/status/getServerStatus.php
and this is what i have it set to: callUrl: 'http://www.clustermc.net/status/getServerStatus.php'
@Acrivec
+1 There's no Ticket Section xD
@ThaPengwin
Because
Writing tickets is turned off?
Guys, why don't you file a ticket? He doesn't get notifications about comments... Why should he even bother?
Author doesn't care about us.
asoiy.com/status/banner.png why ?
I am getting
I'm going to assume this is because my webhost doesn't allow fsockopen without dedicated ip?
Anyone there? :p Or I need to find another plugin? :(
2013-08-31 20:13:42 [SEVERE] [ServerStatus] Problems with calling URL! Called URL responded with status 403!
Please help? It worked before update.