| title | Integrations |
|---|---|
| description | Optional plugin integrations and their runtime behavior |
| published | true |
| date | 2026-09-19 00:00:00 UTC |
| tags | adapt |
| editor | markdown |
| dateCreated | 2026-08-09 00:00:00 UTC |
Adapt detects thirteen optional plugins at startup. Missing integrations do not stop Adapt from enabling, but an unusable configured integration may produce a warning.
Restart after installing, removing, enabling, or disabling an integration. Protection plugins can deny adaptation actions. The other integrations add economy charges, placeholders, or support for specific abilities.
If PlaceholderAPI is enabled when Adapt enables, Adapt registers a persistent expansion under the identifier adapt. Placeholder paths are dot-separated segments after %adapt_. You get things like %adapt_player.level%, %adapt_skill.agility.level% and %adapt_mutation.slot-1%.
Values refresh about once a second, so a scoreboard full of Adapt placeholders costs nothing. A player's values stay readable for sixty seconds after they leave, then become ---. If their profile cannot be loaded, %adapt_available% is false and every value is --- straight away. The complete key and result table is in 47 - API - PlaceholderAPI.
Vault lets you charge economy currency for learning adaptations in addition to knowledge.
- Install Vault and an economy provider.
- Set
learningEconomy.enabled = trueinadapt.toml. - Set
learningEconomy.moneyPerKnowledgeto the price per point of knowledge. - Set
learningEconomy.refundPercentto how much of that comes back on unlearn, or0for none.
Adapt withdraws knowledgeCost * moneyPerKnowledge before spending knowledge. A failed withdrawal rejects the purchase.
Each level bought stores its own refund receipt on the skill line. A normal unlearn pays back refundPercent of the receipts covering the levels being dropped, unless hardcoreNoRefunds is on. If the deposit itself fails, the amount is parked on the skill line and paid out by the next learn or unlearn that player performs.
If Vault is missing, or Vault has no active economy provider, learning stays knowledge-only. Adapt warns once when prices are enabled with no provider available. It stops warning as soon as one appears.
HiddenOre
The HiddenOre bridge only activates when Bukkit reports HiddenOre as enabled. Once it is, hidden veins stop being invisible to Adapt. Breaking one awards Pickaxes XP from the same material-value table normal ores use. Several pickaxe and excavation adaptations start seeing veins as real targets.
Autosmelt turns raw iron, gold and copper drops into ingots. Drop to Inventory asks HiddenOre to deliver straight to the player's inventory. Pickaxe Veinminer chains through HiddenOre vein siblings. Quarry Sense and Excavation's Seismic Ping both include hidden veins in what they detect. Trophy Polish does not run through HiddenOre because hidden veins are not rare trophies.
The bridge applies to pickaxe mining only. It does not act on HiddenOre's blast-mining rewards: an explosion awards no Pickaxes XP, its drops are not autosmelted, and Drop to Inventory does not apply to them.
If HiddenOre is installed but disabled, Adapt logs a warning and runs without the bridge.
Iris controls whether the axe-iris-feller adaptation exists at all. Adapt only registers it when Iris is enabled. The adaptation reports itself disabled if Iris goes away.
Iris handles tree recognition and felling through IrisTreeFellerService. Adapt handles hunger, durability preservation, cooldowns, stopping, and refunds. Other axe veinminers ignore breaks owned by that service. Adapt has no general Iris biome integration.
When AdvancedChests is enabled, rift-access checks the block it is about to open remotely through AdvancedChestsAPI. If that block is an AdvancedChests container, Adapt opens page 1 of that chest instead of a plain Bukkit inventory.
A failed lookup is logged with a stack trace. The remote open fails safely rather than falling through to the vanilla inventory. Normal protection and active-adaptation checks still run either way. The remote session only activates once the API has actually replaced the player's top inventory.
Several Adapt abilities scale off how much armor a player is wearing. MagicCosmetics puts cosmetic items in the helmet and chestplate slots where they would otherwise read as real armor. When MagicCosmetics is enabled and reports an equipped HAT or BAG, Adapt drops the matching slot from its armor-value sum. Cosmetic carriers contribute nothing.
WorldGuard and six claim or container plugins are registered whenever they are present at enable. The protectorSupport.* keys then pick which of those registered protectors are active by default. Factions defaults off. The rest default on.
Indirect Rift container use and transfers from live item entities also dispatch Bukkit's normal interaction or pickup events before committing. Event-driven protection plugins can deny the same action that way without implementing anything Adapt-specific. The registered protectors stay active as an extra gate.
Flags, exact config names, per-adaptation overrides and failure behavior are in 08 - Protection & Region Policy.
Adapt needs no proxy plugin. SQL-backed backends use Redis directly during pre-login to request a response correlated to the exact preceding owner token and epoch. SQL remains authoritative, unsolicited payloads are ignored, and stale owners cannot overwrite a newer fence. A failed claim never rejects the Minecraft login: Adapt stays inactive and makes bounded online retries without creating a fallback profile. Installation, the Adapt:data:v2 hard break, and operational limits are in 39 - Cross-Server SQL & Redis.
Other Bukkit plugins can register AbilityUsePolicy, AbilityCostProvider, Protector and region-policy services. They can listen to Adapt's events. Registering a provider never grants an unlearned adaptation. See docs 41 through 50.
Detected when Adapt starts.
| Plugin | Runtime behavior |
|---|---|
| PlaceholderAPI | Registers the persistent adapt placeholder expansion |
| WorldGuard | Registers region flags, the region policy source, and a protector |
| Factions | Registers the Factions claim protector |
| ChestProtect | Registers its container protector |
| Residence | Registers its residence protector |
| GriefDefender | Registers its claim protector |
| GriefPrevention | Registers its claim protector |
| LockettePro | Registers its lock/sign protector |
| Vault | Resolves the active economy provider for learning charges and refunds |
| HiddenOre | Connects hidden veins to mining XP and applicable pickaxe/excavation adaptations |
| Iris | Enables axe-iris-feller against Iris-managed trees |
| AdvancedChests | Lets rift-access open an AdvancedChests container |
| MagicCosmetics | Keeps cosmetic hat and bag equipment out of Adapt's armor-value sum |
Protection registration and default-enable settings are defined in 08 - Protection & Region Policy.
Values refresh about once a second per player. A player who just left reads their last values for a
minute, then ---. A key the expansion does not publish is left in the text unchanged.
| Key | Default | What it does |
|---|---|---|
learningEconomy.enabled |
false |
Turns on Vault charges for learning. With it off, learning is knowledge-only |
learningEconomy.moneyPerKnowledge |
1.0 |
Currency charged per point of knowledge. Values at or below zero, or non-finite, disable the charge |
learningEconomy.refundPercent |
100.0 |
Percentage of the recorded receipts returned on unlearn, capped at 100 |
hardcoreNoRefunds |
false |
When true, unlearning refunds neither knowledge nor currency |
Skill-line storage keys used by the economy: vault-learning-refund-<adaptation>-level-<n> for per-level receipts, and vault-learning-pending-refund for a deposit that failed and is awaiting retry.
axe-iris-feller is registered only when Iris is enabled, and delegates to art.arcane.iris.api.tree.IrisTreeFellerService from the Bukkit services manager. Max level 3, tick interval 6127 ms, durability preservation chance 0% / 25% / 75% by level. It skips any break that is already vein-mined or already managed by the Iris service.