Integrations & Hooks
JoyMart integrates with several popular Spigot/Paper plugins. All integrations are optional — JoyMart detects them automatically at startup.
PlaceholderAPI
Once PlaceholderAPI is installed, JoyMart registers the following placeholders:
| Placeholder | Description |
|---|---|
%gamebox_tokens% | Current player's token balance |
%gamebox_highscore_<id>% | Current player's high score in a game (e.g. %gamebox_highscore_2048%) |
%gamebox_ingame% | Whether the current player is in a game (true/false) |
The implementation is in GameBoxPlaceholders.java. Placeholders are registered automatically when PlaceholderAPI is detected.
Vault Economy
When Vault is present and economy.vault: true in config.yml:
- Games can award money (coins) alongside tokens
- The token shop can charge coins
- Lottery / SlotMachine prize pools can include money rewards
- All money operations go through Vault's Economy API
WARNING
Without Vault, only the internal JoyMart token system is used.
CalendarEvents
JoyMart hooks into CalendarEvents for seasonal easter eggs. When CalendarEvents is detected:
- Special themed game icons or messages may appear during holidays
- The hook is in
CalendarEventsHook.javaand is auto-detected — no configuration needed
bStats
JoyMart uses bStats for anonymous usage statistics:
- Enabled by default (can be disabled with
bstats: falsein config.yml) - Reports: server version, plugin version, game usage, storage type
- Data is sent to bStats.org and is fully anonymous
TIP
bStats only collects aggregated, anonymized metric data — it never includes any personal player information or sensitive server configuration.
Soft Dependencies Summary
| Plugin | Required? | Purpose |
|---|---|---|
| Vault | Optional | Economy hook (coins) |
| PlaceholderAPI | Optional | Placeholder variables |
| CalendarEvents | Optional | Seasonal easter eggs |
| bStats | Built-in | Anonymous metrics |