> For the complete documentation index, see [llms.txt](https://wiki.vortexdevelopment.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.vortexdevelopment.net/projects/fallingstars/integrations.md).

# 🧩 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.

{% hint style="success" %}
**Setup Check:** No additional configuration is usually needed for these integrations, they are automatically detected on startup!
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://wiki.vortexdevelopment.net/projects/fallingstars/integrations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.