Skip to main content

Installing ItemLimiter

Complete installation guide for ItemLimiter 1.1.

Prerequisites​

Before installing ItemLimiter, ensure you have:

  • ✅ Paper 1.21+ (required - Spigot/Bukkit NOT supported)
  • ✅ Java 21+ installed on your server
  • ✅ Server restart capability

Installation Steps​

1. Download the Plugin​

Download the latest ItemLimiter JAR from:

  • Modrinth (recommended)
  • GitHub Releases
  • Vexor Core website

Current Version: 1.1
File: ItemLimiter-1.1.jar

2. Install Plugin​

  1. Stop your server if running
  2. Navigate to your serverplugins/ folder: 
    your-server/
    └── plugins/
        └── ItemLimiter-1.1.jar  ← Place here
  3. Place the JAR file in plugins/ directory
  4. Start your server

3. Verify Installation​

Check the console for successful load:

[ItemLimiter] Enabling ItemLimiter v1.1
[ItemLimiter] Modrinth update checker initialized
[ItemLimiter] ItemLimiter has been enabled!

OR use the command:

/plugins

Look for:

  • ✅ ItemLimiter in GREEN = Loaded successfully
  • ❌ ItemLimiter in RED = Failed to load (check console errors)

4. Test Functionality​

Run the admin command:

/ilimit

You should see the ItemLimiter configuration GUI open.

First-Time Setup​

Default Configuration​

ItemLimiter creates these files on first run:

plugins/ItemLimiter/
├── config.yml           # Main configuration
└── limits.yml           # Item limit storage (GUI-managed)

Initial Configuration​

Edit config.yml to customize:

# Enable/disable update checker
update-checker:
  enabled: true
  modrinth-slug: "item-limits"

# Default bypass permission
bypass-permission: "limitless.bypass.*"

# GUI settings
gui:
  title: "Item Limiter Configuration"
  size: 54

Set Your First Limit​

  1. Open GUI: /ilimit
  2. Click an item to set its limit
  3. Enter value in chat (e.g., 16 for 16 max stack)
  4. Confirm - limit applies immediately

Upgrading from Previous Versions​

From 1.0 to 1.1​

  1. Backup your plugins/ItemLimiter/ folder
  2. Stop the server
  3. Replace the JAR file
  4. Start server
  5. Verify limits still work

New in 1.1:

  • Modrinth update checker
  • Improved performance
  • Bug fixes

Troubleshooting Installation​

Plugin Not Loading​

Red in /plugins list?

  1. Check Java version:

    java -version
    # Must show 21 or higher

  2. Verify server is Paper:

    /version
    # Must say "Paper" not "Spigot" or "Bukkit"

  3. Check console errors: Look for stack traces mentioning ItemLimiter

Commands Not Working​

/ilimit not recognized?

  1. Verify permissions:

    /lp user <your_name> permission check limitless.admin

  2. Reload plugin:

    /reload confirm

  3. Check for conflicts: Other plugins using same command?

Limits Not Applying​

Items still stacking beyond limit?

  1. Check bypass permission:

    • Remove limitless.bypass.* from players

  2. Verify limit is set:

    • Open /ilimit GUI
    • Confirm item shows limit

  3. Test with different item:

    • Some items may have conflicts

Permissions Setup​

Grant admin access:

# LuckPerms
/lp user <name> permission set limitless.admin true

# Or for a group
/lp group admin permission set limitless.admin true

Grant bypass for VIPs:

/lp group vip permission set limitless.bypass.* true

Performance Impact​

ItemLimiter is highly optimized:

  • CPU Usage: < 0.1% average
  • RAM Usage: ~5MB
  • TPS Impact: Negligible (async operations)

Next Steps​

Need help? Join our Discord support channel!