# FallingStars

### 🌟 Overview 

Welcome to **FallingStars**, the ultimate celestial event plugin for modern Minecraft servers. Transform your sky into a source of mystery and rewards with beautifully animated falling stars, dynamic "star shower" events, and a fully-integrated rewards system. FallingStars is designed to be lightweight, highly customizable, and easy to manage via an intuitive in-game interface.

<figure><img src="/files/LWoC6g2MHeMpkhPAWchW" alt=""><figcaption></figcaption></figure>

***

### ✨ Core Features

#### 🌠 Dynamic Star Animation

Stars don't just appear; they fall gracefully from the heavens. With customizable **descent height**, **fall duration**, and various **particle trails** (Linear, Spiral, etc.), every drop is a cinematic experience for your players.

#### 🎨 Deep Customization

Create an unlimited variety of star types. Each star can have its own:

* **Visual Style**: Use any Minecraft block or a custom Player Head skin.
* **Impact Effects**: Choose from over 10+ legendary impact strategies like `CELESTIAL_ORBIT`, `VOID_PULSE`, or `FIRE_COLUMN`.
* **Reward Pools**: Configure complex loot tables with commands, random selection methods, and more.

#### 📅 Advanced Event System

<figure><img src="/files/es92t6mDyqskuKEMR5zB" alt=""><figcaption></figcaption></figure>

Orchestrate server-wide activities with the built-in Event System.

* **Global Star Showers**: Trigger events that drop stars for every online player.
* **Regional Drops**: Target specific WorldGuard regions for specialized events (e.g., "The Warzone Meteor Shower").
* **Fixed Coordinates**: Set up `CENTER` events at spawn or community hubs.

#### 🎮 In-Game Management

<figure><img src="/files/8QnnGyoXoRrmS3hPcELf" alt=""><figcaption></figcaption></figure>

Forget about tedious YAML editing. Our **interactive GUIs** allow you to:

* Create and edit stars in real-time.
* Manage and trigger events with a single click.
* Configure random spawning chances and cooldowns.

#### 📊 Competitive Leaderboards

Keep your community engaged with built-in statistics. Players can track their collection progress and compete for the top spot on the **Global Leaderboard** via commands or PlaceholderAPI integrations.

***

### 🛠️ Getting Started

To begin your celestial journey, simply use the administrative base command: `/fallingstar stars` From there, you can create your first star type and start summoning them to your world!

{% hint style="success" %}
**Pro Tip:** Use the `/fs summon <type>` command to quickly test your star's look and feel before adding it to an event.
{% endhint %}

***

#### 🔗 Essential Links

* **Discord Support**: [Join our Discord](https://dc.vortexdevelopment.net)


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.