AdSky is a way for you, as a Minecraft server owner, to monetize your server. Currently, there are two kinds of ads : Title ads and Chat ads. Advertisers choose the type of ad they want to broadcast on your server, customize it (Title / subtitle, duration, display per day, ...), pay it according to the price you set up and voilà !
There are two parts : Server and Plugin.
The server part is a PHP + MySQL application that you install on your own web server, it is where advertisers will register and broadcast their ads. To see how to install it and the requirements, please check the Installation section of the server branch's README.
Here is a screenshot of the administration panel.
The plugin part is a simple Bukkit / Sponge plugin that is going to link up with the server part. To see how to install it and the requirements, please check the Installation section.
AdSky is built to be lightweight, but it still has a lot of features :
- Free and open-source.
- Can be run on almost any server that as PHP + MySQL installed.
- Everything is configurable.
- Android application. Coming soon !
To install the server part, please check the Installation section of the server branch's README.
To install the Bukkit plugin, you have to download the JAR and put it inside the
plugins folder located in your server directory.
You need either Bukkit or Spigot. Any version above 1.8 should work.
The configuration file is
plugins/AdSky/config.yml. Open it and configure it as you want :
|Depth 0||Depth 1||Description|
||Whether the updater should be enabled (Skyupdater).|
||Whether bStats Metrics should be enabled.|
||AdSky's root URL on your server.|
||The key given at the end of the installation. If you don't remember it, it is available in
||Whether you have scheduled the MySQL event (downloadable here). If you did not, please turn on this option; then the plugin is going to clear expired ads each day at midnight.|
||The preferred hour to broadcast ads to players. 24 hours format. For example, if you want 3PM, put 15.|
||Ads are not going to be broadcasted in these worlds.|
||Ads are not going to be broadcasted before this hour.|
||Ads are not going to be broadcasted after this hour.|
||Here's how it works. The
Another good distribution function could be
Important : If you cannot see the ads, it means you have the permission
adsky.bypass (which is granted to ops by default). If you want to see the ads, please turn off the permission for yourself.
Services included in the plugin
This plugin utilizes bstats.org metrics system, which means that the following information is collected and sent to bstats.org :
- A unique identifier.
- The server's version of Java.
- Whether the server is in offline or online mode.
- The plugin's version.
- The server's version.
- The OS version/name and architecture.
- The core count for the CPU.
- The number of players online.
- The bStats version.
This plugin uses the Skyupdater, which means that the following may occur :
- Connection to curseforge.com.
- Plugin version compared against version on curseforge.com.
- Downloading of the plugin from curseforge.com if a new version is found.
Every third party service can be disabled in the configuration file (see above).
It's easy to contribute to AdSky ! If you are a developer, first, you have to create a fork and make your changes. Then make a pull request describing what are the improvements.
Anyway, help is greatly appreciated under any form !
If you want to report a bug / suggest an improvement / anything else, do not hesitate to open an issue.