Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/epicericee/justmoney
A Bukkit plugin for just money
https://github.com/epicericee/justmoney
bukkit bukkit-plugin minecraft minecraft-plugin minecraft-server spigot spigot-plugin spigot-resource spigotmc
Last synced: 8 days ago
JSON representation
A Bukkit plugin for just money
- Host: GitHub
- URL: https://github.com/epicericee/justmoney
- Owner: EpicEricEE
- License: mit
- Created: 2020-07-25T12:00:09.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-08-27T15:03:29.000Z (5 months ago)
- Last Synced: 2024-11-24T01:24:32.918Z (2 months ago)
- Topics: bukkit, bukkit-plugin, minecraft, minecraft-plugin, minecraft-server, spigot, spigot-plugin, spigot-resource, spigotmc
- Language: Java
- Homepage:
- Size: 96.7 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# JustMoney
[](https://ci.codemc.io/job/EpicEricEE/job/JustMoney/)
[](https://github.com/EpicEricEE/JustMoney/releases/)
JustMoney is a Bukkit economy plugin that adds just money, not any unnecessary features that you will never use.
Just upload the plugin to your server, and everything just works out of the box.
[**Get JustMoney on SpigotMC**](https://www.spigotmc.org/resources/justmoney.81941/)
## Features
- SQLite and MySQL database support
- [Vault](https://www.spigotmc.org/resources/vault.34315/) integration
- Optional multi world economy support
- Customizable currency formatting
- Permissions
- Automatic update checking
## Usage
### Commands
The `/money` command can also be accessed via `/balance` or `/bal`.
The optional `` argument can only be used if `multi-world` is enabled in the config. If the argument is left out, the player's current world is used instead.
| Command | Description |
| --- | --- |
| `/money []` | Show your own balance |
| `/money []` | Show the balance of another player |
| `/money send []` | Send money to another player |
| `/money set []` | Set your own balance |
| `/money set []` | Set the balance of another player |
| `/money give []` | Add money to your own account |
| `/money give []` | Add money to the account of another player |
| `/money take []` | Withdraw money from your own account |
| `/money take []` | Withdraw money from the account of another player |
| `/money help` | Show the command usage |
### Permissions
These should be self-explanatory.
- `justmoney.*`
- `justmoney.send` *(allowed by default)*
- `justmoney.view.other`
- `justmoney.set.*`
- `justmoney.set.self`
- `justmoney.set.other`
## Developer API
I highly recommend using [Vault](https://www.spigotmc.org/resources/vault.34315/) to hook into your server's economy, as it provides an API that almost all current economy plugins hook into. If for some reason, you still want to hook directly into JustMoney, it is published on CodeMC's maven repository:
*Replace `{version}` with the respective version*
```xml
codemc-repo
https://repo.codemc.io/repository/maven-public/
de.epiceric.justmoney
justmoney
{version}
provided
```
```groovy
repositories {
maven {
url = "https://repo.codemc.io/repository/maven-public/"
}
}
dependencies {
compileOnly 'de.epiceric.justmoney:justmoney:{version}'
}
```
### Example usage
Any changes to an account's balance done via `BankAccount#setBalance(...)`, `BankAccount#withdraw(...)` or `BankAccount#deposit(...)` are automatically stored to the database or file system.
*[Have a look at the javadoc](https://ci.codemc.io/job/EpicEricEE/job/JustMoney/javadoc/index.html)*
```java
World world = ...;
OfflinePlayer vendor = ...;
Player customer = ...;
double price = ...;
JustMoney plugin = JavaPlugin.getPlugin(JustMoney.class);
BankManager manager = plugin.getBankManager();
BankAccount vendorAccount = manager.getBankAccount(vendor);
BankAccount customerAccount = manager.getBankAccount(customer);
if (customerAccount.getBalance(world) >= price) {
customerAccount.withdraw(price, world);
vendorAccount.deposit(price, world);
} else {
customer.sendMessage("You don't have enough money!");
return;
}
// or using the server's default world and using try-catch
try {
customerAccount.withdraw(price);
vendorAccount.deposit(price);
} catch (NotEnoughMoneyException ex) {
customer.sendMessage("You don't have enough money!");
return;
}
customer.sendMessage("You now have " + customerAccount.formatBalance() + "left on your account!");
```