AdSky Sponge - Monetize your Minecraft server!


#1

This is a discussion topic for the Ore project, AdSky Sponge. View the full project on Ore for downloads and more information.


AdSky


License
Tag

Table of contents

  1. Introduction
  2. Features
  3. Installation
  4. Configuration
  5. Contributing
  6. Support

Introduction

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.

Server part

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.

Plugin part

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.

Features

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.
  • Lightweight.
  • Android application. Coming soon !

Installation

To install the server part, please check the Installation section of the server branch’s README.

To install the Sponge plugin, you have to download the JAR and put it inside the mods folder located in your server directory.

Any Sponge version above 7.0.0 (included) should work.

A video tutorial of the Bukkit installation is available here. It really is almost the same thing for Sponge.

Configuration

The configuration file is config/adsky-sponge.conf. Open it and configure it as you want :

Depth 0 Depth 1 Description
enable updater Whether the updater should be enabled (OreUpdater).
server url AdSky’s root URL on your server.
plugin-key The key given at the end of the installation. If you don’t remember it, it is available in core/settings/PluginSettings.php.
event-scheduler 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.
ads preferred-hour The preferred hour to broadcast ads to players. 24 hours format. For example, if you want 3PM, put 15.
worlds-blacklist Ads are not going to be broadcasted in these worlds.
min-hour Ads are not going to be broadcasted before this hour.
max-hour Ads are not going to be broadcasted after this hour.
distribution-function Here’s how it works. The h will be replaced by the preferred hour, the n by the number of ads of the day and x by an hour. The function will be evaluated with these parameters with a rounding mode of UP at each hour; first h, then h-1, then h+1, … The process will be repeated while all ads are not scheduled.
Another good distribution function could be ((-1/n) * (x-h)^2) + (log(n)/log(10)).

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.

Contributing

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.

If you are not a developer, well, you can contribute as well ! Report bugs, problems and improvements in the Issues section. You can also contribute by making a donation.

Anyway, help is greatly appreciated under any form !

Support

If you want to report a bug / suggest an improvement / anything else, do not hesitate to open an issue.


#2

A new version has been released for AdSky Sponge, it is available for download here.


  • Fixed some bugs.

#4
  • provide in-game advertising opportunities, sponsorships, or product placement for 3rd parties IF they don’t degrade or interfere with gameplay or give a user an unfair gameplay advantage over anyone else on the server.

https://account.mojang.com/terms#commercial

Looks A-OK to me.