Bukkit

CraftersStaff v2.0 - The Network & Developer Update

This is a massive update for CraftersStaff that brings full compatibility with proxy networks, a brand new public API for developers, and a rewritten web integration system!

CHANGES & NEW FEATURES:

1. Proxy Network Compatibility (BungeeCord & Velocity)
- CraftersStaff now fully supports BungeeCord and Velocity networks.
- Interceptors have been added to properly handle network-wide placeholders.
- The %cstaff_proxy_count% placeholder now accurately displays the total number of staff members online across the entire network.

2. Web Panel Removal (IMPORTANT)
- The Web Panel integration (/stafflog) has been completely removed from the plugin.
- This decision was made because the backend services (like Cloudflare KV databases) have strict rate limits on free tiers and require a budget to maintain effectively at scale.
- Since we do not currently have the budget to maintain this feature without users running into these limits, we decided to remove it completely to keep the plugin lightweight and stable.

3. Complete Developer API
Developers can now hook into CraftersStaff to check player states and listen to events!

HOW TO USE THE API:
Add the CraftersStaff jar to your plugin's build path or dependencies.

Methods available in CraftersStaffAPI:
- CraftersStaffAPI.isStaffMode(Player player): Returns true if the player is in Staff Mode.
- CraftersStaffAPI.isVanished(Player player): Returns true if the player is vanished.
- CraftersStaffAPI.isFrozen(Player player): Returns true if the player is frozen.
- CraftersStaffAPI.setStaffMode(Player player, boolean state): Force a player in or out of Staff Mode.
- CraftersStaffAPI.setVanished(Player player, boolean state): Force a player in or out of Vanish.
- CraftersStaffAPI.setFrozen(Player player, Player freezer, boolean state): Force freeze or unfreeze a player.

Events you can listen to (Standard Bukkit/Spigot Events):
- StaffModeChangeEvent: Fired when a player toggles staff mode.
Methods: getPlayer(), isEntering(), isLeaving()

- StaffVanishEvent: Fired when a player toggles vanish.
Methods: getPlayer(), isVanishing(), isUnvanishing()

- PlayerFreezeEvent: Fired when a player is frozen.
Methods: getPlayer(), getFreezer()

- PlayerUnfreezeEvent: Fired when a player is unfrozen.
Methods: getPlayer(), getUnfreezer()

Example usage in your plugin:
@EventHandler
public void onStaffMode(StaffModeChangeEvent event) {
if (event.isEntering()) {
System.out.println(event.getPlayer().getName() + " entered staff mode!");
}
}

Thank you for using CraftersStaff! If you have any issues, please report them on our Discord.