# 🍀 Pillar of Fortune

## Information

The Pillar of Fortune add-on periodically gives every player on their own a random item or block.

<figure><img src="https://cdn.phoenixplugins.com/4owwwyiv3pbd2s88j7bk18wte9ax" alt="" width="188"><figcaption><p>Pillar of Fortune Add-On</p></figcaption></figure>

### Installation <a href="#installation" id="installation"></a>

To install this add-on, simply drag and drop the jar file into the PhoenixDuels/addons folder, or include the add-on while using the bundle download option to download the plugin.

This add-on adds Pillar of Fortune as a [gamemode rule](../../main-features/create-a-mode/README.md#mode-rules) to the plugin.

### Create a Gamemode

Create a gamemode, or open an existing one, that you want the periodic item drops applied to.

### Select Rule

Select the Generated rule `Pillar of Fortune` alongside your other rules.

### Create a Map

Create a map dedicated for this gamemode.

> **Info:**
This add-on supports [Folia](../../first-installation.md#version-support), which is still experimental.

## Configuration

The rule's settings let you configure:

* **Drop Interval** - how many seconds between each random item drop.
* **Blacklisted Items** - items that should never be picked when rolling a drop.
* **Action Bar** - toggles an action bar showing the countdown to the next drop, with an editable format.
* **Receive Title** - an optional title/subtitle shown to a player when they receive an item, with the item name available via `%item%`.
* **Receive Sound** - toggles a sound effect played when a player receives an item.

<!-- TODO: add screenshot -->

## Placeholders

The Pillar of Fortune add-on adds the following placeholders that you can use on the Scoreboard:

1. `%pillaroffortune_team1_remaining%` through `%pillaroffortune_team4_remaining%` - Returns the number of players still alive on that team slot.

## PlaceholderAPI Placeholders

The following is the list of the available placeholders that Pillar of Fortune has.

| Placeholders                                    | Description                              |
| -------------------------------------------------- | ------------------------------------------- |
| %phoenixduels_pillaroffortune_team1_remaining%     | Returns the players remaining on team 1.  |
| %phoenixduels_pillaroffortune_team2_remaining%     | Returns the players remaining on team 2.  |
| %phoenixduels_pillaroffortune_team3_remaining%     | Returns the players remaining on team 3.  |
| %phoenixduels_pillaroffortune_team4_remaining%     | Returns the players remaining on team 4.  |

Source: https://www.phoenixplugins.com/docs/phoenix-duels/add-ons/gamemodes/pillar-of-fortune