🧠 Momentum

⏳ Reward your players for being online — the longer they stay, the more they gain.

📚 View Wiki

---

💡 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

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

Technical Features

• 🌍 Multi-Language - Built-in support for multiple languages
• 🧩 PlaceholderAPI - Extensive placeholder support
• 🔗 Cross-Server - Redis support for network-wide sessions
• 🛠️ Fully Configurable - Customize every aspect of the plugin
• 💰 Economy Support - 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

!View your current playtime, available rewards, and multiplier status

Reward Tiers

!Earn better rewards as you play longer

Recycling System

!Reset your progress for permanent multiplier bonuses

---

⚙️ 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

# 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
  • Vault (for economy support)
  • An economy plugin (EssentialsX, CMI, etc.)

• Optional:

  • PlaceholderAPI (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