Documentation, Add BouncyPads

Datura/src/main/java/me/totalfreedom/datura/Datura.java

@@ -27,11 +27,11 @@ public class Datura extends JavaPlugin
 
         CommonsBase.getInstance()
                    .getRegistrations()
-                   .getServiceRegistry()
+                   .getServiceTaskRegistry()
                    .registerService(SubscriptionProvider.syncService(this, locker));
         CommonsBase.getInstance()
                    .getRegistrations()
-                   .getServiceRegistry()
+                   .getServiceTaskRegistry()
                    .registerService(SubscriptionProvider.syncService(this, cager));
 
         Bukkit.getPluginManager()

Datura/src/main/java/me/totalfreedom/datura/perms/FreedomUser.java

@@ -45,7 +45,7 @@ public class FreedomUser implements User
         final Datura datura = CommonsBase.getInstance()
                                          .getRegistrations()
                                          .getModuleRegistry()
-                                         .getModule(Datura.class)
+                                         .getProvider(Datura.class)
                                          .getModule();
 
         UserData data = SimpleUserData.fromSQL(datura.getSQL(), uuid.toString());

Datura/src/main/java/me/totalfreedom/datura/user/ServerEconomyHolder.java

@@ -3,40 +3,112 @@ package me.totalfreedom.datura.user;
 import me.totalfreedom.economy.EconomicEntity;
 import me.totalfreedom.economy.EconomicEntityData;
 
+/**
+ * Represents the server's economy holder.
+ * <br>
+ * <br>
+ * This is effectively a Bank object which is meant to represent the server itself,
+ * which can store a balance and perform transactions with other EconomicEntity objects.
+ * <br>
+ * <br>
+ * The server is initially given a maximum balance of {@link Long#MAX_VALUE}, though this can be changed
+ * using the constructor {@link #ServerEconomyHolder(String, long)}. The value that this
+ * bank object holds is persistent, which means that the total economic resources available
+ * are of limited supply.
+ * <br>
+ * <br>
+ * Please be aware, if the server's economy falls below 0,
+ * it will have drastic consequences.
+ */
 public class ServerEconomyHolder implements EconomicEntity, EconomicEntityData
 {
-    private long balance = Long.MAX_VALUE;
+    private final String name;
+    private long balance;
 
+    /**
+     * Constructs a new ServerEconomyHolder with the specified name and a balance of {@link Long#MAX_VALUE}.
+     *
+     * @param name The name of this server economy holder.
+     */
+    public ServerEconomyHolder(final String name)
+    {
+        this.name = name;
+        this.balance = Long.MAX_VALUE;
+    }
+
+    /**
+     * Constructs a new ServerEconomyHolder with the specified name and balance.
+     *
+     * @param name    The name of this server economy holder.
+     * @param balance The balance of this server economy holder.
+     */
+    public ServerEconomyHolder(final String name, final long balance)
+    {
+        this.name = name;
+        this.balance = balance;
+    }
+
+    /**
+     * This method will return this object, as it is both the EconomicEntity and the EconomicEntityData.
+     * This is due to the fact that the server should only ever have one singular concrete representation
+     * of it's economic entity and the respective data.
+     *
+     * @return this object.
+     */
     @Override
     public EconomicEntityData getEconomicData()
     {
         return this;
     }
 
+    /**
+     * @return The name of this server economy holder.
+     */
     @Override
     public String getName()
     {
-        return "TotalFreedom-Bank";
+        return name;
     }
 
+    /**
+     * This method will always return false, as the server should not ever be
+     * prevented from performing transactions.
+     *
+     * @return false
+     */
     @Override
     public boolean areTransactionsFrozen()
     {
         return false;
     }
 
+    /**
+     * @return The server's current available balance.
+     */
     @Override
     public long getBalance()
     {
         return balance;
     }
 
+    /**
+     * Sets the server's balance to the specified value.
+     *
+     * @param newBalance The new balance to set.
+     */
     @Override
     public void setBalance(final long newBalance)
     {
         balance = newBalance;
     }
 
+    /**
+     * Adds the specified amount to the server's balance.
+     * This method mutates the balance and returns the new balance.
+     *
+     * @param amount The amount to add.
+     * @return The new balance.
+     */
     @Override
     public long addToBalance(final long amount)
     {
@@ -44,6 +116,13 @@ public class ServerEconomyHolder implements EconomicEntity, EconomicEntityData
         return balance;
     }
 
+    /**
+     * Removes the specified amount from the server's balance.
+     * This method mutates the balance and returns the new balance.
+     *
+     * @param amount The amount to remove.
+     * @return The new balance.
+     */
     @Override
     public long removeFromBalance(final long amount)
     {