🧠 Momentum

This project will likely be deleted by Modrinth because of their new AI guidelines.

⏳ 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

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

# 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

📥 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