The Minecraft App lets you visualize the minecraft world from the guts side. Wondering how many blocks have been dug up by your buddies? Not a problem. Wondering who's found the most diamonds? Yep, got it covered. Have you been planting enough wheat? Carrots? Pototoes? The Minecraft App will let you know.
This section provides information about installing and using the Minecraft App.
- Operating System: Windows, Linux, or Mac OS X.
- Web browsers: Latest versions of Chrome, Safari, or Firefox, Internet Explorer 9 or later.
- Craftbukkit: The open source minecraft server from Craftbukkit
- LogToSplunk Plugin: The log to splunk plugin that allows input of more detailed minecraft data to splunk from CraftBukkit
- The Splunk Web Framework: The Web Framework is included in Splunk 6 and is available for Splunk 5 from the Splunk Developer Portal.
- Minecraft Overviewer (Optional): The Google Maps based minecraft word renderer from Overviewer
The Minecraft App is built as a Splunk App on the Splunk Web Framework and must be installed on top of it.
If you downloaded the Minecraft App from Splunk Apps, you can install the app within Splunk Web.
- For more, see Where to get more apps and add-ons.
- Download and unzip the Minecraft App or clone the repository from GitHub.
- Copy the entire
/minecraft-app
subdirectory into$SPLUNK_HOME/etc/apps/
. - Restart Splunk.
- In Splunk Web, navigate to the Minecraft App (http://localhost:8000/dj/minecraft-app).
- Confgiure a TCP input as noted in the Documentation for whatever port you like.
- Ensure firewalls and NAT are properly configured if applicable
- Downlod the jar from Craftbukkit
- Copy the LogToSplunk jar into your craftbukkit server's
/plugins
folder. - Create a
/LogToSplunk
directory in the/plugins
folder - Create a and edit
/config.yml
text file in the/LogToSplunk
directory created in 3- The text file should contain one line in the format of "splunks: <Splunk Server>:<TCP Input Port>" (ie. "splunks: localhost:8888"). Multiple servers can be added as comma separated values between the server:port entries. A port must be specified.
- Download and configure Overview as described int the Overviewer Docs
- Serve the overviewer via a webserver like Apache or IIS. Many operating systems have a web service built in that just needs to be enabled.
- Create an initial render from overviewer with at least one of the "Normal","Lighting", and "Night" options
- Copy the overviewer.css,overviewer.js, and overviewerConfig.js scripts from the base render directory to
$SPLUNK_HOME/etc/apps/minecraft-app/django/minecraft-app/static/minecraft-app/
on your splunk server. - Edit
$SPLUNK_HOME/etc/apps/minecraft-app/django/minecraft-app/static/minecraft-app/overviewerConfig.js
and modify the path variable of each tileset object to include your webserver path. For example, change"path": "world-normal"
to"path": "http://webserver:81/world-normal"
. The external hostname must be used in order for the map to be visible to clients. Using "localhost" as the webserver will not work as the minecraft app does not reserve the map, it simply redirects to it.
NOTE: The minecraft-app does not refresh overviewer renders automatically. This will need to be scheduled by another service (ie. cron or task scheduler).
- LogToSplunk does not maintain connecton across Splunk restarts. The minecraft server must be restarted if Splunk is restarted
- Time calculations and active players may be mis-reported if player disconnects are not logged properly (ie. due to a server crash). Orphaned sessions may be estimated by running sessions from connection to the subsequent server start.
- The live map may appear to "shift" as the minecraft world expands and overviewer resets it's origin in future renders. This can be corrected by recopying and modifying the overviewerConfig.js script with the same steps as the installation.
When you need to know more:
-
For CraftBukkit documentation, see Craftbukkit
-
For Overviewer documentation, see Overviewer
-
For all things developer with Splunk, your main resource is the Splunk Developer Portal.
-
For component reference documentation, see the Splunk Web Framework Reference.
-
For more about Splunk in general, see Splunk>Docs.
If you would like to contribute to the Minecraft App, go here for more information:
Please feel free to open issues and provide feedback through GitHub Issues.
The Minecraft_App is licensed under the Apache License 2.0. Details can be found in the LICENSE file.