> For the complete documentation index, see [llms.txt](https://docs-nightbeam.gitbook.io/infinity-rifts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-nightbeam.gitbook.io/infinity-rifts/docs.md).

# InfinityRifts documentation

This is the main guide for server owners and administrators running InfinityRifts 1.10.1. It focuses on installing and operating the plugin; integration details for developers are in the [Developer API](/infinity-rifts/developer-api.md).

## Start here

1. [Installation](https://github.com/MeherBenSalem/InfinityRifts/tree/main/docs/installation.md) — requirements, production JAR placement, and first startup.
2. [Quick start](/infinity-rifts/docs/quick-start.md) — create a gateway, grant access, and run the first rift.
3. [Commands](/infinity-rifts/docs/commands.md) — `/rift` commands and their behavior.
4. [Permissions](/infinity-rifts/docs/permissions.md) — access nodes and administrator permissions.

## Configure the plugin

1. [Main configuration](/infinity-rifts/docs/configuration.md) — `plugins/InfinityRifts/config.yml`.
2. [Gateway configuration](/infinity-rifts/docs/gateway_configuration.md) — waves, mobs, rewards, timers, conditions, and spawn settings.
3. [Messages and localization](/infinity-rifts/docs/messages-and-localization.md) — configurable messages and MiniMessage formatting.
4. [GUIs](/infinity-rifts/docs/gui.md) — administrator gateway panel and controls.

## Runtime features

1. [Placeholders](/infinity-rifts/docs/placeholders.md) — PlaceholderAPI expansion and available placeholders.
2. [Hooks and integrations](/infinity-rifts/docs/hooks.md) — PlaceholderAPI, MythicMobs, MMOItems, and Vault behavior.
3. [Storage](/infinity-rifts/docs/storage.md) — gateway files, active sessions, backups, and restore behavior.

## Support and upgrades

1. [FAQ](/infinity-rifts/docs/faq.md) — common owner and administrator questions.
2. [Troubleshooting](/infinity-rifts/docs/troubleshooting.md) — startup, configuration, spawning, and session issues.
3. [Versioning and migration](https://github.com/MeherBenSalem/InfinityRifts/tree/main/docs/migration.md) — upgrade and downgrade safety.

## Developer documentation

The [Developer API](/infinity-rifts/developer-api.md) is the only developer-facing reference. It documents the Bukkit service, all public snapshots and enums, lifecycle events, threading rules, and Java integration examples.

## Compatibility at a glance

| Item                  | Current support                                        |
| --------------------- | ------------------------------------------------------ |
| Plugin version        | 1.10.1                                                 |
| Java                  | 21                                                     |
| Minecraft API         | Spigot API 1.20.1; descriptor API version 1.20         |
| Server platforms      | Bukkit, Spigot, Paper, and Folia-compatible scheduling |
| Required plugin       | PlaceholderAPI 2.11.7 or compatible                    |
| Optional integrations | MythicMobs and MMOItems                                |
| Public developer API  | Contract version 1.0                                   |

For unsupported implementation details, inspect the source rather than treating internal classes as a compatibility contract.