import dev.drawethree.xprison.api.XPrisonAPI;

XPrisonAPI api = XPrisonAPI.getInstance();

api.getEnchantsApi()      // Enchant system
api.getRanksApi()         // Ranks
api.getPrestigesApi()     // Prestiges
api.getRebirthApi()       // Rebirths
api.getBlocksApi()        // Block tracking
api.getCurrencyApi()      // Currency balances
api.getGangsApi()         // Gangs
api.getMultipliersApi()   // Global, player, and rank multipliers
api.getAutoSellApi()      // Auto-sell prices and regions
api.getMinesApi()         // Mine management
api.getBombsApi()         // Bomb items
api.getAutoMinerApi()     // Auto-miner time
api.getBattlePassApi()    // Battle Pass tiers, XP and premium
api.getQuestsApi()        // Quests progress and rerolls
api.getDailyRewardsApi()  // Daily login streaks and claims
api.getMilestonesApi()    // Milestone ladders and per-track progress
api.getPickaxeLevelsApi() // Pickaxe level and XP
api.getPickaxeQualityApi()// Pickaxe quality tiers
api.getPickaxeSkinsApi()  // Skins on a pickaxe
api.getMiningStatsApi()   // Per-player mining rates (blocks/sec, income/min)
api.getHistoryApi()       // The player history log
api.getVirtualBlocksApi() // Packet (virtual) mine blocks
api.getTextApi()          // MiniMessage rendering that also works on Spigot
api.getTimeApi()          // 1.10 - the server's time zone, date format and duration labels

api.getPluginVersion()    // e.g. "2026.3.8.5"
api.getModules()          // every module and whether it is enabled
api.getLoadedAddons()     // what AddonManager loaded from plugins/X-Prison/addons
api.getDashboardUrl()     // null unless the Dashboard addon is running

// 2026.3.7.0 - optional, see "Diagnostics API" and "Player Preferences API" below
api.getDiagnosticsApi()         // Config lint findings, startup warnings, permission catalog
api.getPlayerPreferencesApi()   // Per-player on/off switches shown in /toggles

// Battle Pass
api.getBattlePassApi().addXp(uuid, 500, XpSource.OTHER);
int tier = api.getBattlePassApi().getTier(uuid);
boolean premium = api.getBattlePassApi().isPremium(uuid);

// Quests
List<ActiveQuest> daily = api.getQuestsApi().getActiveQuests(uuid, QuestCategory.DAILY);
api.getQuestsApi().addProgress(uuid, "daily_mine_blocks", 100);

// Daily Rewards
int streak = api.getDailyRewardsApi().getStreak(uuid);
boolean claimed = api.getDailyRewardsApi().claim(uuid);

XPrisonMilestonesAPI milestones = api.getMilestonesApi();

// Ladders
MilestoneRegistry registry = milestones.getRegistry();
List<MilestoneTrack> tracks = registry.getConfiguredTracks();
MilestoneTrack prestige = registry.getTrack("prestige");
List<Milestone> ladder = registry.getMilestones(prestige);
Milestone rung = registry.getMilestone("prestige-100");

// A player's standing
MilestoneProgress progress = milestones.getProgress();
BigDecimal blocks = progress.getCurrentValue(player, registry.getTrack("blocks"));
int reached = progress.getLevel(player, registry.getTrack("blocks"));
Milestone next = progress.getNextMilestone(player, registry.getTrack("blocks"));

// The high-water mark, offline-capable - this is what a rebirth does not reset
BigDecimal highest = progress.getHighestProgress(uuid, prestige);
progress.setHighestProgress(uuid, prestige, 0);   // let the ladder be earned again
progress.resetPlayer(uuid);                       // clear every track

// Hand one out on demand - ignores whether it was reached or already paid
milestones.awardMilestone(player, "playtime-1440");
milestones.reloadConfig();

Milestone rung = registry.getMilestone("prestige-100");

// the menu half
MilestoneDisplay display = rung.getDisplay();
display.getDescription(); display.getRewardLines(); display.getMaterial(); display.getCustomModelData();

// the "you reached it" half
MilestoneAnnouncement announcement = rung.getAnnouncement();
announcement.getTitle(); announcement.getSubtitle(); announcement.getMessage();
announcement.getBroadcast(); announcement.getSound(); announcement.isFirework();

public final class GangLevelTrack implements MilestoneTrack {

    @Override public @NotNull String getKey() { return "gang-level"; }
    @Override public @NotNull String getDisplayName() { return "Gang Level"; }
    @Override public @NotNull String getDescription() { return "Level your gang to climb this track!"; }

    @Override
    public @NotNull BigDecimal getValue(@NotNull Player player) {
        return BigDecimal.valueOf(myGangApi.getLevel(player));   // cheap, main-thread, never blocks
    }

    // optional
    @Override public boolean isAvailable() { return myPluginIsRunning(); }
    @Override public @NotNull String format(@NotNull BigDecimal value) { return "Lv. " + value; }
}

api.getMilestonesApi().getRegistry().registerTrack(new GangLevelTrack());

MilestoneProgress progress = api.getMilestonesApi().getProgress();

// a counter that only climbs (blocks, playtime, a lifetime total)
progress.reportCounter(player, track, previousValue, currentValue);

// a value that can go back down (prestige, rebirth, rank)
progress.reportValue(player, track, newValue);

// a jump on such a value - every threshold between the two fires, plus non-exact repeats
progress.reportChange(player, track, previousValue, currentValue);

api.setDashboardUrl(String url)   // called by the Dashboard addon on startup
api.getDashboardUrl()             // returns the active panel URL, or null if not running

api.getModules()                        // List<XPrisonModule> — all registered modules
api.isModuleEnabled(String configKey)   // true if module is active
api.enableModule(String configKey)
api.disableModule(String configKey)

api.getLoadedAddons()                          // List<XPrisonAddon>
api.enableAddon(String name)
api.disableAddon(String name)
api.reloadAddon(String name)                   // runs the addon's onReload() hook; false if unknown, disabled or it threw (API 1.10)
api.loadAddonFromFile(File jar)                // runtime load without restart

public class MyAddon implements XPrisonAddon {

    private XPrisonAddonContext context;

    @Override
    public void onEnable(XPrisonAddonContext context) {
        this.context = context;

        XPrisonAPI api = context.getAPI();           // full X-Prison API
        File dataFolder = context.getDataFolder();   // plugins/X-Prison/addons/MyAddon/
        Logger log = context.getLogger();            // prefixed logger
        String name = context.getAddonName();
        String version = context.getAddonVersion();

        // Register Bukkit event listeners
        context.registerEvents(new MyListener());

        log.info("MyAddon enabled.");
    }

    @Override
    public void onDisable() {
        context.getLogger().info("MyAddon disabled.");
    }

    @Override
    public void onReload() {
        // Called by /xprison reload, /xprison reload MyAddon, the Addons Manager GUI
        // and XPrisonAPI#reloadAddon. Re-read your config here; the addon stays enabled,
        // so listeners, commands and runtime state survive. Core modules are reloaded first.
        myConfig.load();
    }
}

@Override
public void onEnable(XPrisonAddonContext context) {
    File file = new File(context.getDataFolder(), "myenchant.json");
    // copy your bundled default if it is missing, then merge new keys into an existing one
    EnchantJsonUpdater.update(file, getClass().getResourceAsStream("/myenchant.json"));

    enchant = new MyCustomEnchant(file);
    enchant.load();
    context.getAPI().getEnchantsApi().registerEnchant(enchant);
}

@Override
public void onDisable() {
    enchant.unload();
    context.getAPI().getEnchantsApi().unregisterEnchant(enchant);
}

XPrisonEnchantsAPI enchants = api.getEnchantsApi();

// The cuboid an area enchant may affect (highest-priority region that permits enchants).
Optional<AreaBounds> region = enchants.getEnchantRegionBounds(location);

// Fortune level on a pickaxe, and blocks Fortune must not multiply.
int fortune = enchants.getItemFortuneLevel(pickaxe);
boolean skip = enchants.isFortuneBlacklisted(block);

// Suppress X-Prison's own gated listeners for a synthetic BlockBreakEvent you fire.
enchants.ignoreBlockBreakEvent(event);

XPrisonBlocksAPI blocks = api.getBlocksApi();

// Run the shared post-break pipeline once for a set of blocks: blocks-broken statistic,
// lucky blocks, and the aggregate XPrisonBlockBreakEvent that quests / battle pass /
// block boosters consume. Call this ONLY when you are not firing a Bukkit event per
// block — otherwise X-Prison's own listener already ran it and you would double-count.
blocks.handleBlockBreak(player, brokenBlocks, countBlocksBroken);

// Bulk form for breaks too large to enumerate (a whole packet mine): O(block types).
blocks.handleBulkBlockBreak(player, typeCounts);

// Credit the pickaxe with blocks and XP from a named source.
api.getPickaxeLevelsApi()
   .addBlocksAndExp(player, pickaxe, blockCount, exp, PickaxeExpSource.AREA_ENCHANTS);

// Read a pickaxe's permanent quality tier and what it multiplies. Absent tag = tier 0 = 1.0x.
XPrisonPickaxeQualityAPI quality = api.getPickaxeQualityApi();
double tokenBonus = quality.getCurrencyMultiplier(pickaxe, "tokens");

// PlayerPickaxeQualityUpgradeEvent is cancellable and its cost is mutable, so an addon can
// block an upgrade or discount it before the player is charged.

// A skin's boosts (API 1.10). Each is 1.0 when the skin does not define it. The core already
// applies them - read them for lore/placeholders, do not multiply again.
api.getPickaxeSkinsApi().getPickaxeSkin(pickaxe).ifPresent(skin -> {
    double tokens = skin.getMultiplier("tokens");        // 0.0 when not defined
    double procs  = skin.getEnchantProcMultiplier();     // scales every chance-based enchant's chance
    double exp    = skin.getPickaxeExpMultiplier();      // mining pickaxe XP (never API grants)
    double bpXp   = skin.getBattlePassXpMultiplier();    // Battle Pass XP from mining
});

// Currencies can be capped, so credit and report what was ACTUALLY added — otherwise a
// "you earned %amount%" message overstates the payout whenever the cap clamps it.
BigDecimal credited = api.getCurrencyApi()
        .addBalance(player, currency, amount, ReceiveCause.MINING);

// Drops belong in the backpack, not the inventory, when this is on. Note UltraBackpacks
// reads real world state, so bypass it whenever the affected blocks are virtual.
boolean backpacks = api.isUltraBackpacksEnabled();

XPrisonTextAPI text = api.getTextApi();

// Sending — PlaceholderAPI placeholders are resolved for you
text.sendMessage(player, "<gradient:#FFD700:#FFAA00>Well mined!</gradient>");
text.sendMessage(player, List.of("<gray>Line one", "<gray>Line two"));
text.sendActionBar(player, "<green>+100 tokens");
text.sendTitle(player, "<gold><bold>LEVEL UP", "<gray>You reached level %level%", 10, 40, 10);

// Rendering to a String, for sinks that take coloured text rather than sending it
String hologramLine = text.toLegacySection(configLine);  // legacy section codes
String plain        = text.stripTags(gangName);          // no tags at all

// Feature check — hover and click cannot be shown on Spigot
if (text.isRich()) {
    text.sendMessage(player, "<click:open_url:'https://example.com'>Click me</click>");
} else {
    text.sendMessage(player, "<gray>Visit https://example.com");
}

XPrisonTimeAPI time = api.getTimeApi();

ZoneId zone = time.getZone();                       // configured zone, or the system zone
LocalDate today = time.now().toLocalDate();         // "today" as the server owner defines it

String left = time.formatDuration(remainingSeconds);            // "1d 4h 20m 5s" - zero units omitted
String when = time.formatDateTime(Instant.ofEpochMilli(at));    // "2026/09/17 21:05:00" by default
String unit = time.getUnitName(TimeUnit.MINUTES);               // "Minutes", or whatever the owner set
String give = time.formatAmount(5, TimeUnit.MINUTES);           // "5 Minutes"

XPrisonRanksAPI ranks = api.getRanksApi();

// Online and offline reads
Rank rank = ranks.getPlayerRank(player);
Rank rank = ranks.getPlayerRankOffline(uuid);           // DB lookup, works for offline players
Rank next = ranks.getNextPlayerRank(player);
double progress = ranks.getRankupProgress(player);      // 0.0 – 1.0
boolean isMax = ranks.isMaxRank(player);

// Writes
ranks.setPlayerRank(player, rank);
ranks.setPlayerRankOffline(uuid, rank);                 // persists to DB immediately
ranks.resetPlayerRank(player);

// Leaderboard
List<RankLeaderboardEntry> top = ranks.getTopByRank(10);

// All player UUIDs that have rank data
Set<UUID> uuids = ranks.getAllPlayerUUIDs();

// Rank list
List<Rank> allRanks = ranks.getAllRanks();
Rank max = ranks.getMaxRank();
Rank defaultRank = ranks.getDefaultRank();
Rank byId = ranks.getRankById(id);

// Rank cost scaling (2026.3.8.3) - what this player actually pays
BigDecimal price = ranks.getRankCostFor(player, next);   // rank.getCostExact() x multiplier
BigDecimal factor = ranks.getRankCostMultiplier(player); // BigDecimal.ONE when scaling is off

XPrisonPrestigesAPI prestiges = api.getPrestigesApi();

Prestige prestige = prestiges.getPlayerPrestige(player);
Prestige prestige = prestiges.getPlayerPrestigeOffline(uuid);   // offline lookup
double progress = prestiges.getPrestigeProgress(player);
boolean isMax = prestiges.isMaxPrestige(player);
Prestige next = prestiges.getNextPlayerPrestige(player);

prestiges.setPlayerPrestige(player, prestige);
prestiges.setPlayerPrestigeOffline(uuid, prestige);             // persists to DB immediately
prestiges.resetPlayerPrestige(player);

List<PrestigeLeaderboardEntry> top = prestiges.getTopByPrestige(10);
Set<UUID> uuids = prestiges.getAllPlayerUUIDs();

List<Prestige> all = prestiges.getAllPrestiges();
Prestige max = prestiges.getMaxPrestige();

XPrisonRebirthAPI rebirth = api.getRebirthApi();

Rebirth r = rebirth.getPlayerRebirth(player);
Rebirth r = rebirth.getPlayerRebirthOffline(uuid);   // offline lookup
boolean isMax = rebirth.isMaxRebirth(player);
Rebirth next = rebirth.getNextPlayerRebirth(player);

rebirth.setPlayerRebirth(player, r);
rebirth.setPlayerRebirthOffline(uuid, r);            // persists to DB immediately
rebirth.resetPlayerRebirth(player);
rebirth.tryRebirth(player);                          // attempts rebirth, checks requirements

List<RebirthLeaderboardEntry> top = rebirth.getTopByRebirth(10);
Set<UUID> uuids = rebirth.getAllPlayerUUIDs();

List<Rebirth> all = rebirth.getAllRebirths();
Rebirth max = rebirth.getMaxRebirth();

XPrisonCurrencyAPI currency = api.getCurrencyApi();

// Balance operations — all work for online AND offline players
BigDecimal balance = currency.getBalance(uuid, currencyName);
currency.addBalance(uuid, currencyName, amount);
currency.removeBalance(uuid, currencyName, amount);    // clamped to 0
currency.setBalance(uuid, currencyName, amount);
boolean has = currency.has(uuid, currencyName, amount);
currency.transferBalance(fromUuid, toUuid, currencyName, amount);

// Leaderboard
List<CurrencyLeaderboardEntry> top = currency.getTopByBalance(currencyName, 10);
List<CurrencyLeaderboardEntry> top = currency.getTopByBalance(currencyName, 10, offset);

// Currency CRUD (live — changes apply immediately and persist to currencies.yml)
currency.createCurrency(name, displayName, prefix, suffix, format, startingBalance);
currency.updateCurrency(name, displayName, prefix, suffix, format);
currency.deleteCurrency(name);
XPrisonCurrency c = currency.getCurrency(name);
List<XPrisonCurrency> all = currency.getAllCurrencies();

XPrisonMultipliersAPI multipliers = api.getMultipliersApi();

// Global multipliers (server-wide, per currency)
GlobalMultiplier g = multipliers.getGlobalMultiplier(currencyName);
multipliers.setGlobalMultiplier(currencyName, value, duration, unit);
multipliers.addGlobalMultiplier(currencyName, value, duration, unit);  // extends if active
multipliers.resetGlobalMultiplier(currencyName);

// Player multipliers (per player, per currency)
PlayerMultiplier p = multipliers.getPlayerMultiplier(player, currencyName);
multipliers.setPlayerMultiplier(player, currencyName, value, duration, unit);

// Rank multipliers (assigned via permission node xprison.multiplier.<rank>)
RankMultiplier r = multipliers.getRankMultiplier(player, currencyName);

XPrisonMinesAPI mines = api.getMinesApi();

List<Mine> allMines = mines.getMines();
Mine mine = mines.getMine(name);

// Mine interface — key methods
String name = mine.getName();
World world = mine.getWorld();
int filled = mine.getFilledBlocks();
int total = mine.getTotalBlocks();
double pct = mine.getPercentageFull();            // 0.0 – 1.0
int players = mine.getPlayerCount();

// Added for Dashboard / addon support:
Map<String, Integer> effects = mine.getEffects();         // uppercase effect name → amplifier
String resetType = mine.getResetTypeName();               // "INSTANT" or "GRADUAL"

// Block palette
BlockPalette palette = mine.getBlockPalette();
List<MineBlock> blocks = palette.getBlocks();
palette.setPaletteByIds(Map<String, Double> blockIdToPercentage);  // save and apply new palette

mine.reset();

XPrisonAutoSellAPI autoSell = api.getAutoSellApi();

// Global prices
Map<String, Double> global = autoSell.getGlobalPrices();
autoSell.addSellPrice(MineBlock block, double price);
autoSell.removeSellPrice(MineBlock block);

// Sell regions (per WorldGuard region)
List<SellRegion> regions = autoSell.getSellRegions();
SellRegion region = regions.get(i);
String id = region.getId();
World world = region.getWorld();
String permission = region.getRequiredPermission();
Map<String, Double> prices = region.getPrices();

autoSell.addRegionSellPrice(String regionId, MineBlock block, double price);
autoSell.removeRegionSellPrice(String regionId, MineBlock block);

// 1.9 — exact-precision pricing. Prefer this when multiplying one type's price by a
// large count (an area enchant prices per block *type* and multiplies by how many were
// broken), where a double would lose precision on OP-scale servers.
BigDecimal exact = autoSell.getSellPriceForBlockExact(mineBlock);

XPrisonPickaxeLevelsAPI levels = api.getPickaxeLevelsApi();

// The pickaxe is already in the player's inventory - the rebuilt item is stored back for you.
levels.setPickaxeLevel(player, heldPickaxe, 25);

// You are still holding the pickaxe yourself - use the returned item. (2026.3.7.0+)
ItemStack pickaxe = new ItemStack(Material.DIAMOND_PICKAXE);
pickaxe = levels.withPickaxeLevel(player, pickaxe, 25);
player.getInventory().addItem(pickaxe);

XPrisonDiagnosticsAPI diagnostics = api.getDiagnosticsApi();

// The configuration linter. MUST be called from the server main thread - it reads live
// mine and module state. Empty list = a consistent configuration.
List<ConfigFinding> findings = diagnostics.lintConfiguration();
for (ConfigFinding finding : findings) {
    finding.severity();   // FindingSeverity.ERROR or .WARNING
    finding.source();     // the file or section it belongs to, e.g. "enchants.yml"
    finding.message();    // human-readable, ready to show to a server owner
    finding.isError();    // convenience for severity() == ERROR
}

// Warnings collected while the plugin enabled. Fixed once startup completes.
List<String> warnings = diagnostics.getStartupWarnings();

// Every permission node X-Prison checks, grouped by area and sorted by node.
Map<String, List<PermissionEntry>> catalog = diagnostics.getPermissionCatalog();

XPrisonPlayerPreferencesAPI prefs = api.getPlayerPreferencesApi();

// Works for offline players - the value is read from, and written to, the database.
boolean auto = prefs.isEnabled(uuid, XPrisonPlayerPreferencesAPI.AUTO_REBIRTH, true);
prefs.set(uuid, XPrisonPlayerPreferencesAPI.AUTO_REBIRTH, false);

// Only the keys this player has explicitly set.
Map<String, Boolean> all = prefs.getPreferences(uuid);
prefs.getPreferencesAsync(uuid).thenAccept(map -> { /* ... */ });

public interface PrestigeableEnchant {
    boolean isPrestigeEnabled();
    int getMaxPrestige();
    double getMultiplierPerPrestige();
    long getRequiredActivations(int currentPrestige);
}

// dev.drawethree.xprison.api.enchants.model.XPrisonEnchantmentGuiProperties
int getGuiSlot();
default int getGuiPage() { return 1; }   // 1-based

// dev.drawethree.xprison.api.enchants.model.RefundableEnchant
int getRefundGuiSlot();
default int getRefundGuiPage() { return 1; }   // 1-based