WooEconomy
A Comprehensive Economy System for Minecraft
About the Project WooEconomy is a powerful economy system developed as an API for Minecraft servers. It offers a variety of features that allow server administrators to implement a complex and flexible economy system.
Available Commands Here are the available commands you can use with WooEconomy:
- /economy balance - Shows your current balance.
- /economy deposit <amount> - Adds the specified amount to your account.
- /economy withdraw <amount> - Withdraws the specified amount from your account.
- /economy pay <player> <amount> - Transfers the specified amount to another player.
- /economy set <player> <amount> - Sets a player’s balance to the specified amount.
Permissions are configured within the config files. You can find these in the WooEconomy plugin folder.
Advanced Logging:
- Advanced Logging: Find a plugin-specific logging file within your server's logs folder.
Introducing 3 new Placeholders for the PlaceholderAPI:
- %wooeconomy_player_uuid%
- %wooeconomy_player_currency%
- %wooeconomy_player_name%
Main Features
- API Support: Designed to allow developers to integrate into their plugins easily.
- Transaction Management: Efficiently manage deposits and withdrawals.
- User-Friendly: Easy to configure and use.
- Extensible: Supports extensions and customizations by other plugins.
Installation
<dependency >
<groupId >de.alphaomega-it.wooeconomy</groupId >
<artifactId >WooEconomy</artifactId >
<version >1.3</version >
</dependency >
Download the latest version of WooEconomy from
GitHub.
Place the JAR file in the plugins directory of your Minecraft server.
Restart the server to activate the plugin.
Configuration After installation, you will find the configuration file in the plugins/WooEconomy directory. Adjust the settings to your needs.
EconomyProvider Class To use WooEconomy in your plugin, you can implement the following EconomyProvider class:
Code (Java):
public
class EconomyProvider
{
private
final EconomyAdapter economyAdapter
;
public EconomyProvider
(
)
{
this.
economyAdapter
=
this.
findEconomyProvider
(
)
;
}
/**
* Find and return the EconomyAdapter provider if the WooEconomy plugin is enabled.
*
* @Return the EconomyAdapter provider, or null if the plugin is not found or not enabled
*/
public @Nullable EconomyAdapter findEconomyProvider
(
)
{
final Server server
= Bukkit.
getServer
(
)
;
if
(
Arrays.
stream
(server.
getPluginManager
(
).
getPlugins
(
)
).
noneMatch
(plugin
-> plugin.
getName
(
).
equals
(
"WooEconomy"
)
)
||
!server.
getPluginManager
(
).
isPluginEnabled
(
"WooEconomy"
)
)
{
return
null
;
}
return server.
getServicesManager
(
).
getRegistration
(EconomyAdapter.
class
).
getProvider
(
)
;
}
/**
* Get the EconomyAdapter instance.
*
* @return the EconomyAdapter instance
*/
public @NotNull EconomyAdapter get
(
)
{
if
(
this.
hasEconomyProvider
(
)
)
{
return
this.
economyAdapter
;
}
throw
new
IllegalStateException
(
"No economy provider found!"
)
;
}
public
boolean hasEconomyProvider
(
)
{
return
this.
economyAdapter
!=
null
;
}
}
Here is the usage example:
Code (Java):
getEconomyProvider
(
).
get
(
).
depositPlayer
( player, earnings
)
;
Please visit the GitHub repository or join our Discord server for support and more information.
License This project is licensed under the
MIT License.
Acknowledgements A big thank you to all contributors and supporters of this project!