Skip to content

Compatibility

okereke-dev edited this page Jul 4, 2026 · 6 revisions

Compatibility

RPGLoot is designed to layer cleanly on top of vanilla mechanics and other plugins. This page documents optional integrations with established plugins.


PlaceholderAPI

If PlaceholderAPI is installed, RPGLoot automatically registers a %rpgloot_*% expansion — no configuration needed. Check the console on startup for:

[RPGLoot] PlaceholderAPI found — registered %rpgloot_*% placeholders

Available placeholders

Placeholder Output Example
%rpgloot_active_set% The player's currently active set name, or None Shadowveil
%rpgloot_active_set_pieces% Equipped pieces out of 5 for the active set 3/5
%rpgloot_active_set_bonus% Formatted current bonus value from the active set +6.1% Dodge Chance

If the player has no active set, active_set returns None, active_set_pieces returns 0/5, and active_set_bonus returns None.

Use cases: scoreboards, tab list, holographic displays, or any GUI plugin that reads PlaceholderAPI placeholders.


mcMMO

RPGLoot does not integrate directly with mcMMO's ability procs — mcMMO does not expose a reliable per-hit/per-block event for Double Drops (Mining/Excavation), Serrated Strikes (Swords bleed), Skull Splitter (Axes crit), or Treasure Hunter (Fishing), so there's no clean signal to detect and avoid double-stacking.

If you run both plugins together, be aware of overlapping mechanics:

RPGLoot stat Overlapping mcMMO ability
Fortune Boost / Auto-Smelt Mining "Double Drops", Excavation "Double Drops"
Bleeding Swords "Serrated Strikes"
Crit Chance Axes "Skull Splitter"
Double Catch Chance Fishing "Treasure Hunter"

Since v0.3.3, every bonus-stat range is configurable in config.yml under bonus-stat-ranges (see Configuration). If your server runs mcMMO with these skills active, consider lowering the affected ranges to compensate — e.g. cut FORTUNE_BOOST, AUTO_SMELT_CHANCE, and DOUBLE_CATCH_CHANCE roughly in half.


WorldGuard

If WorldGuard is installed, RPGLoot automatically registers a custom region flag: rpgloot-drops (defaults to ALLOW). Check the console on startup for:

[RPGLoot] WorldGuard found — registered 'rpgloot-drops' region flag

When this flag is set to DENY in a region, RPGLoot skips:

  • Mob drops (regular and boss) inside that region
  • Structure-loot injection inside that region

Example — disable RPGLoot drops in your spawn region:

/rg flag spawn rpgloot-drops deny

Everything else about the region (PvP, mob spawning, building, etc.) is untouched — this flag only controls whether RPGLoot adds its own loot on top of what would otherwise happen there. If WorldGuard isn't installed, drops behave exactly as if the flag were always ALLOW.


Other plugins

RPGLoot uses Bukkit's native AttributeModifier system (not custom NBT) for all stat bonuses, with namespaced UUID keys (rpgloot_damage, rpgloot_speed, rpgloot_armor, rpgloot_health, etc.) — this minimizes collision risk with other stat/attribute plugins. If you notice a conflict with a specific combat or attribute plugin, please open an issue.

Clone this wiki locally