listings = manager.all();
// Creating a listing
Currency currency = CurrencyRegistry.getAll().getFirst();
Player player = Bukkit.getPlayer("Preva1l");
ItemStack item = player.getInventory().getItemInMainHand();
player.getInventory().setItemInMainHand(new ItemStack(Material.AIR));
manager.listingBuilder(player)
.price(4_500_000) // 4.5 Million
.tax(3.5) // This is a percentage, so 3.5%, the default is 0%
.currency(currency) // By default this is the same as what we have it
.length(2 * 60 * 60 * 1000) // 2 Hours, this is also a default value
.itemStack(item)
.biddable(false) // this is false by default, bidding is still W.I.P.
.toPost() // theres alot more options you can change in this section
.postAdvert(true)
.buildAndSubmit().thenAccept(result -> {
if (!result.successful()) {
player.sendMessage(
"Failed to post listing! " + result.message()
);
player.getInventory().setItemInMainHand(item);
return;
}
player.sendMessage("Listing Posted!");
});
}
}
```
# Events
Listen for Events via the API.
## Getting started
First setup your listeners.
import org.bukkit.plugin.java.JavaPlugin;
import org.bukkit.Bukkit;
public final class FadahAPIExample extends JavaPlugin {
@Override
public void onEnable() {
if (Bukkit.getPluginManager().getPlugin("Fadah") != null) {
Bukkit.getPluginManager().registerEvents(new FadahAPIExampleListener(), this);
}
}
}
{% code title="FadahAPIExampleListener.java" %}
```java
import org.bukkit.event.Listener;
import org.bukkit.event.EventHandler;
public class FadahAPIExampleListener implements Listener {
// Add listeners here.
}
```
{% endcode %}
Now you can add your listeners!
## ListingCreateEvent
This event is cancellable and accepts a reason to show the player.
{% code title="FadahAPIExampleListener.java" %}
```java
public class FadahAPIExampleListener implements Listener {
@EventHandler
public void onListingStart(ListingCreateEvent e) {
if (e.getPlayer().getName().equalsIgnoreCase("IhateFadah")) {
e.setCancelReason("Nuh uh!");
e.setCancelled(true);
}
}
}
```
{% endcode %}
## ListingEndEvent
public class FadahAPIExampleListener implements Listener {
@EventHandler
public void onListingEnd(ListingEndEvent e) {
if (e.getReason() == ListingEndReason.CANCELLED_ADMIN) {
Player player = Bukkit.getPlayer(e.getListing().getOwner());
if (player == null) return;
player.sendMessage("An admin has cancelled your listing!");
}
}
}
## ListingPurchaseEvent
{% code title="FadahAPIExampleListener.java" %}
```java
public class FadahAPIExampleListener implements Listener {
@EventHandler
public void onListingPurchase(ListingPurchaseEvent e) {
Player player = Bukkit.getPlayer(e.getListing().getOwner());
if (player == null) return;
player.sendMessage("%s has purchased your listing!"
.formatted(e.getBuyer().getName()));
}
}
```
{% endcode %}
# Adding a Economy Hook
This page will provide you with the information to add an economy hook to fadah!
### Adding a Single Currency
```java
public class MyCustomCurrency implements Currency {
private MyPluginsAPI api;
@Override
public String getId() {
return "my_currency";
}
@Override
public String getRequiredPlugin() {
return "MyPlugin";
}
@Override
public String getName() {
return "Super Money";
}
@Override
public void withdraw(OfflinePlayer player, double amountToTake) {
api.take(player, amountToTake);
}
@Override
public void add(OfflinePlayer player, double amountToAdd) {
api.give(player, amountToAdd);
}
@Override
public double getBalance(OfflinePlayer player) {
return api.get(player);
}
@Override
public boolean preloadChecks() {
api = MyPluginsAPI.getInstance()
return api != null;
}
}
```
### Adding a Multi Currency
public class MyMultiCurrency implements MultiCurrency {
private final List<Currency> currencies = new ArrayList<>();
private MyPluginsAPI api;
@Override
public String getId() {
return "my_plugin";
}
@Override
public String getRequiredPlugin() {
return "MyPlugin";
}
@Override
public List<Currency> getCurrencies() {
return currencies;
}
@Override
public boolean preloadChecks() {
api = MyPluginsAPI.getInstance()
if (api == null) return false;
for (String economy : List.of("gems", "tokens")) {
Currency subCur = new SubCurrency(
id + "_" + economy,
economy,
requiredPlugin,
(player, amount) -> api.take(p.getUniqueId(), economy, amount),
(player, amount) -> api.give(p.getUniqueId(), economy, amount),
player -> api.get(player.getUniqueId(), economy),
v -> {
if (!api.currencyExists(economy)) {
System.out.println("-------------------------------------");
System.out.println("Cannot enable coins engine currency!");
System.out.println("No currency with name: " + eco.economy());
System.out.println("-------------------------------------");
return false;
}
return true;
}
);
currencies.add(subCur);
}
return true;
}
}
### Registering your currency
```java
CurrencyRegistry.register(new MyCustomCurrency());
CurrencyRegistry.register(new MyMultiCurrency());
```
# Dungeons Terminals
DungeonsTerminals is an extension to MythicDungeons (2.0.0) to add Hypixel-esque terminals!
How to setup
{% embed url="" %}
# Fadsb
Finally a Decent SkyBlock
Docs Coming Soon!
