> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/pinnagiveaways/getting-started/installation.md).

# Installation

1. Stop the server, put `PinnaGiveaways.jar` in `plugins/` and start it.
2. The plugin writes `config.yml`, `messages.yml` and the three menus in `guis/`. None of them is ever overwritten: delete one to get the default back.
3. Check the console: it lists every currency that could not load (for example "Vault has no economy plugin registered") and the storage in use.

## Supported servers

Paper 1.21 to 1.21.x and the 26.x versions, Java 21. The packet library the reel uses is bundled inside the jar (relocated, so it never clashes with other plugins). On a server version it can't draw on, the plugin logs one warning and announces winners straight away without the reel; everything else works.

## Optional plugins

| Plugin                                     | Used for                                                                    |
| ------------------------------------------ | --------------------------------------------------------------------------- |
| Vault + an economy (EssentialsX, CMI...)   | the `money` currency                                                        |
| PlayerPoints                               | a `playerpoints` currency                                                   |
| PinnaPrison, EdPrison, EdTools, EdDungeons | their currencies (tokens, gems, farm coins, souls...)                       |
| PlaceholderAPI                             | `%pinnagiveaways_...%` placeholders, `%placeholders%` in menus and messages |
| EdLang                                     | every text in each player's own language                                    |

None of them is required; a currency whose plugin is missing is skipped with one warning.