> 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/readme.md).

# InfinityRifts

InfinityRifts 1.10.1 is a Java 21 Bukkit-family plugin for configurable, wave-based PvE gateways. Players activate gateway keys or enter naturally spawned rifts, fight timed mob waves, form parties, and receive item, XP, and command rewards.

## Highlights

* Per-gateway YAML definitions for waves, mobs, equipment, effects, rewards, failure behavior, boss bars, and spawn rules
* Item-activated and scheduled random gateways
* Party invitations, joining, leaving, kicking, and configurable friendly-fire controls
* Vanilla mobs plus optional MythicMobs spawning
* PlaceholderAPI placeholders, session persistence, mob/drop protection, admin GUI, MiniMessage text, and Folia-aware scheduling

## Requirements

* Java 21
* A Bukkit-compatible Minecraft 1.20+ server; the project compiles against Spigot API 1.20.1 and declares `api-version: 1.20`
* PlaceholderAPI 2.11.7 or a compatible runtime version (hard dependency)
* Optional: MythicMobs and MMOItems

Velocity, BungeeCord, Fabric, and standalone proxy operation are not supported.

## Install

1. Stop the server and back up its `plugins` directory.
2. Install PlaceholderAPI.
3. Copy the production InfinityRifts JAR to `plugins/`.
4. Start the server once. The plugin creates `plugins/InfinityRifts/config.yml`, `gateways/`, and `active_rifts.yml`.
5. Confirm the console prints `Loaded InfinityRifts v1.10.1` and no configuration warnings require action.

## Commands

The root command is `/rift` (alias `/rifts`). Common operations include `/rift invite <player>`, `/rift join <player>`, `/rift leave`, `/rift party`, `/rift admin`, `/rift give <player> <gateway>`, `/rift reload`, and `/rift list`.

## Documentation

* [Consumer guide](/infinity-rifts/docs.md) — installation, commands, permissions, configuration, gateway setup, and troubleshooting
* [Developer API](/infinity-rifts/developer-api.md) — service access, immutable snapshots, lifecycle events, and integration examples

## Build

Run `mvn clean install` with JDK 21 to create the production and API artifacts. See the [Developer API](/infinity-rifts/developer-api.md) for API dependency details.