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! :))
Set it to 'banner' mode. Navigate to http://website.com/where-you/put-your-php-file/banner.png
If you have everything set up correctly you should see a banner with your sever status on it. (Similar to the image in the main post)
Is there anyway to have a image what will auto update every 15 seconds or something? So the user doesn't always need to refresh the page to get the latest info?
Thank you for this comment... I wasn't sure about this problem, but thanks its the permission. :) Just add the permission "-serverstatus.ignore" to the admin group an it will work. It will look like:
2012-10-31 01:37:43 [INFO] [ServerStatus] Problems with calling URL!
Plugin returns this when the target PHP file doesn't respond with status 200 (OK). Check your PHP file again and check network connection. In next version I will specify the warning message.
Thanks for the update. :)
is there any way to use this with a .gif as bg ?
i want to make THIS with the Players Online feature of this Plugin, i've configured all, but i get only the first page of the Gif :show here
sorry 4 my bad english
Future request for the plugin
-----I use this plugin for a while now and am very satisfied about it
I saw that some people have trouble when their setting up the web-script!
So I thought about convert this script to support multiple servers, and then hosting it on my website, so anyone can use it
features
forum: http://forum.gezelligeserver.hostzi.com/index.php?topic=15
@Linrox
Still works with 1.4.6 I tested it. It should work fine.
I would love to add this to my TS server for advertizing if you is still being updated. It says inactive but not abandoned. Need a 1.4.6 version.
@w3thax
This developer has several plugins and is probably now busy with his other plugins
Update for 1.4.6? Or is it inactive?
@Jacold
I use version 1.4 for my server (1.4.5-r0.2)
Any chance for update? I need an updated version but for old bukkit api (1.4.5 R0.2). Thanks.
got an error everytime a player joins the server http://pastebin.com/0tKWqbTD
@aroepy
Set it to 'banner' mode. Navigate to http://website.com/where-you/put-your-php-file/banner.png If you have everything set up correctly you should see a banner with your sever status on it. (Similar to the image in the main post)
Works great! Thanks!
Is there anyway to have a image what will auto update every 15 seconds or something? So the user doesn't always need to refresh the page to get the latest info?
any of you know how to get in on my site?
@PerwinCZ
Have contacted you via PM.
Thanks for this wonderful plugin.
@jn4kim
Thank you for this comment... I wasn't sure about this problem, but thanks its the permission. :) Just add the permission "-serverstatus.ignore" to the admin group an it will work. It will look like:
Its important that it is in this order.
Thank you for the plugin @PerwinCZ
I am using permissionex.. and OPs get ignored automatically. is there way to fix this? :)
@w3thax
Plugin returns this when the target PHP file doesn't respond with status 200 (OK). Check your PHP file again and check network connection. In next version I will specify the warning message.
I'd love to use this plugin, but it doesn't work. I get this error:
2012-10-31 01:37:43 [INFO] [ServerStatus] Problems with calling URL!
But the url is correct. :(
My config:
useSecurityKey: false
securityKey: ''
callUrl: 'http://www.ultra-craft.de/status/getServerStatus.php'
connection-timeout: 10
ignore-list: ''
Any ideas? And what do I have to do to make the script building my banner? Any commands in-game or script calls via browser?
@nerogold
did you edit the code in getServerStatus.php ?
if yes would you post the code here so I can look
Here is a script that sets a $ _GET in a .html Pagine. loger 2-0 download
I have some error
and i dont know how to repair this. I cant reach players names if I add to code echo '$players Plase, help :(