🧩 Integrations

FallingStars integrates with several popular plugins to enhance your server experience.

📊 PlaceholderAPI

Use these placeholders in scoreboards, tablists, or bossbars. The main identifier is fallingstars.

Player Statistics

Placeholder	Description
%fallingstars_collected%	Total count of all stars collected by the player.
%fallingstars_collected_<type>%	Count of a specific star type (e.g., basic, legendary).

Event Status

Placeholder	Description
%fallingstars_event_active_<id>%	Returns true if the specific event ID is running.

Leaderboards (Top 10)

Placeholder	Description
%fallingstars_top_name_<rank>%	Name of the player at the specified rank.
%fallingstars_top_collected_<rank>%	Score of the player at the specified rank.

---

🛡️ WorldGuard

FallingStars supports WorldGuard out of the box for precise spawn control.

• Region-Specific Spawning: Create events that only trigger within specific regions using the REGION event type.

• Global Blacklists: Use the WorldGuard.Excluded Regions For Spawning setting in config.yml to prevent stars from landing in sensitive areas.

• Region Filtering: Automatically checks if a target spawn location is within a forbidden zone before executing the drop.

---

🕶️ Vanish Support

The plugin respects popular vanish plugins (SuperVanish, PremiumVanish, etc.).

• Vanished players are automatically excluded from PLAYER type events.

• Random star spawns will not trigger for players who are currently hidden from others.

---

🏺 DecentHolograms / CMI / HolographicDisplays

FallingStars uses VortexCore for its hologram management. If you have any of the supported hologram plugins installed, the plugin will automatically use them to display:

• Star names above falling entities.

• Temporary reward indicators when a star is collected.

Setup Check: No additional configuration is usually needed for these integrations, they are automatically detected on startup!