Sueta

[API] ManaCore

1.3.0

Manage and display Mana bars for your players

·Plugin

download.png

ManaCore adds a customizable mana bar at the top of the player's screen which is perfect for RPG-like servers and custom gameplay mechanics.

This plugin allows server owners to manage and display mana dynamically using a boss bar. The system is configurable, and developers can easily integrate the mana system into their custom plugins using the ManaCoreAPI.


mana.PNG

Features

  • Customizable Mana Bar: Easily configure the title and max value of the mana bar.
  • Developer API: Interact with the mana system through ManaCoreAPI.
  • Reload Command: Reload the mana system settings without restarting the server using /mcreload or /mcr.

Commands

  • /mcreload [/mcr]: Reloads the configuration file.
    • Permission: mc.reload

ManaCoreAPI

ManaCoreAPI allows for developers to easily integrate Mana into their own plugins. Some examples below.

Player player = e.getPlayer();

if(ManaCoreAPI.hasEnoughMana(player, 25)) {
    ManaCoreAPI.adjustMana(player, -25);
}
Player player = (Player) sender;

double currentMana = ManaCoreAPI.getMana(player);

player.sendMessage("Current Mana: " + currentMana);

Useful methods:

public static void addPlayer(Player player) // Gives a player the ability use mana and obtain the mana bar    

    public static void setMana(Player player, double amount) //Sets the amount of mana for the player

    public static double getMana(Player player) //Gets the current Mana of player

    public static void adjustMana(Player player, double amount) //Adjusts mana for player. This supports addition/subtraction

    public static boolean hasEnoughMana(Player player, double amount) //Returns true if player's current Mana is greater than amount.
 
    public static void removePlayer(Player player) //Removes mana from the player

This is a simple example however, plugin developers can easily hook into the ManaCoreAPI with their custom plugins that can have custom items.

Configuration file :

#config file for the Mana Bar
manaBar:
  title: "&b&lMana" # Title of the Mana Bar
  maxMana: 100.0 # Maximum amount of Mana for players

This plugin is still in development, if there are any problems or requests you may have please let me know so I can improve it.

Similar projects

Plugin →