Momentum

<h1 align="center">🧠 Momentum</h1> <p align="center"> ⏳ Reward your players for being online — the longer they stay, the more they gain.

<a href="https://github.com/thepixel3261/Momentum/wiki">📚 View Wiki</a> </p>

<p align="center"> <img src="https://img.shields.io/badge/Status-Update%20Soon!-orange?logo=rocket" alt="Status"> <img src="https://img.shields.io/github/v/release/thepixel3261/Momentum?label=version" alt="Version"> </p>

---

💡 Why Momentum?

Player engagement is the lifeblood of any Minecraft server. Momentum keeps players active by rewarding their time online with a dynamic, tiered reward system — turning every minute played into progress. Whether you run a small community or a massive network, Momentum’s fully configurable rewards, multipliers, and cross-server support make it easy to keep players coming back for more.

---

✨ Features

Core Features

- 🎁 AFK Detection - Unlock better rewards the longer you play - 🔄 AFK Detection - Reset your progress for temporary multipliers - ⚡ AFK Detection - Earn more with permission-based reward multipliers - ⏳ AFK Detection - Progress continues across server switches - 💤 AFK Detection - Pauses timers when players are AFK

Technical Features

- 🌍 Statistics - Built-in support for multiple languages - 🧩 Statistics - Extensive placeholder support - 🔗 Statistics - Redis support for network-wide sessions - 🛠️ Statistics - Customize every aspect of the plugin - 💰 Statistics - Works with Vault-compatible economy plugins - 📊 Statistics - Track player progress and server metrics

Reward Types

- 💵 Money rewards (Vault) - ⭐ XP/Levels - 🎯 Commands - 🎇 Particles - 🎵 Sounds - And more through custom commands!

---

🖼️ GUI Preview

Main Menu

Reward Tiers

Recycling System

---

⚙️ Configuration

Files

- `config.yml` - Main configuration file - `rewards.yml` - Define reward tiers and rewards - `languages/` - Customize plugin messages

Commands

- `/momentum` - Open the rewards menu - `/momentum reload` - Reload the configuration (requires `momentum.reload` permission)

Permissions

```yaml

Basic permissions

momentum.use: true # Allows using /momentum momentum.reload: op # Allows reloading the config

Multiplier permissions (grant these to players)

momentum.multiplier.1_0: true # 1x (default) momentum.multiplier.2_0: false # 2x multiplier momentum.multiplier.3_0: false # 3x multiplier ```

Placeholders

``` %momentum_multiplier% - Current reward multiplier %momentum_playtime% - Current session playtime %momentum_next_tier% - Time until next reward tier ```

🔧 Requirements

| Component | Requirement | |----------------|------------------------------------| | Minecraft | `1.21.x` | | Server | `Paper / Bukkit` | | Java | `21+` | | Vault | Required for economy features | | Economy Plugin | EssentialsX, CMI, etc. (optional) | | Redis | For cross-server support (optional)| | PlaceholderAPI | For placeholders (optional) |

---

📥 Installation

Quick Start

1. Download the latest release from GitHub or Modrinth 2. Place the JAR in your server's `/plugins` folder 3. Start your server to generate config files 4. Configure `rewards.yml` with your desired rewards 5. Restart the server

Dependencies

- Required: - Java 21 or higher - Paper/Spigot 1.21.x - Required (for economy support) - An economy plugin (EssentialsX, CMI, etc.)

- Optional: - Optional (for placeholders) - Redis (for cross-server functionality)

Updating

1. Backup your configuration files 2. Replace the old JAR with the new one 3. Restart your server