✓ Donations Holograms 1.4.2

This plugin is an addon for Holographic Displays (required)!


An innovative way to stimulate your players to donate. Display your store's donations progress bar directly in game, with four different placeholders for Holographic Displays:

• Progress bar (fully customizable)
• Raw amount of donations received
• Raw amount of donations goal
  
• Current percentage of the donations goal

The plugin is able to read and parse web pages using regular expression, without affecting the performance of your server.


Placeholders
The following placeholders can be used in holograms:

• {donationsPercentage} - The percentage of the completed donations goal
• {donationsProgressBar} - The fancy progress bar
  
• {donationsReceived} - The raw amount of money received
  
• {donationsGoal} - The donation goal set in config.yml

Requirements

• Have a donation page. Buycraft*, Enjin* and Minecraft Market are supported by default, but the plugin can be configured.
• Have a goal module visible to everyone, with percentage or raw amount of donations received displayed.
• Have the plugin Holographic Displays installed.

Using the browser
* Enjin and BuyCraft use a protection against attacks that requires JavaScript. In order to enable support for it, download this file and drop it in the folder /plugins/DonationHolograms/. Stop and start the server to enable it, the reload command is not enough.


Installation

• Download and install Holographic Displays (make sure it's updated)
• Drop DonationsHolograms.jar in the plugins folder
• Start and stop the server to generate the configuration
• Edit the configuration (explaination below)
• Drop the browser (read above) in the plugin folder if you use Enjin or BuyCraft.
• Start the server
• If you change the configuration in the future, do /DonationHolograms reload

Commands
Please read Holographic Displays' commands list first.
/hd create donations
/hd setline donations 1 Percentage bar: {donationsProgressBar}

This commands would create a hologram named "donations", made of a single line, displaying something like this:

Percentage bar: █ █ █ █ █ █ █ █ █ █

You can combine multiple placeholders and add multiple lines, check out Holographic Displays' page.
/DonationsHolograms autodetect - Recommends you the store type to use in config.yml
/DonationsHolograms status - Prints the donations amount from the webstore, if the last check was successful, if you are using the browser JAR file, and some config values
/DonationsHolograms reload - Reloads the plugin
/DonationsHolograms dump - Writes the HTML page to htmlDump.txt in this plugin's folder, to show how does the plugin see the page html. It can be different from what you would see with a browser.


Permissions
The single permission to use all the commands is donationsholograms.admin