Skip to main content

ItemLimiter Commands

Complete command reference for ItemLimiter.

Main Command​

/ilimit​

Opens the Item Limiter configuration GUI.

Aliases: None
Permission: limitless.admin
Usage:

/ilimit

Description:
Opens an interactive GUI where you can:

  • View all configured item limits
  • Add new item limits by clicking items
  • Modify existing limits
  • Remove limits

Example:

# Open the config GUI
/ilimit

[GUI opens showing items with current limits]
Click Diamond (64) → Set to 16 → Confirmed!

GUI Controls​

Setting a Limit​

  1. Run /ilimit to open GUI
  2. Click the item you want to limit
  3. Enter the maximum stack size in chat
  4. Limit is saved and applied immediately

Example:

/ilimit
[Click on Diamond]
> Enter new stack limit (1-64): 16
✓ Diamond limit set to 16

Removing a Limit​

  1. Open /ilimit GUI
  2. Right-click the item with a limit
  3. Limit is removed, item returns to default (64 or vanilla max)

Example:

/ilimit
[Right-click Diamond]
✓ Removed limit for Diamond

Viewing Current Limits​

All items with limits are displayed in the GUI with their current max stack size shown in the item lore.

Command Examples​

Basic Usage​

Open Configuration:

/ilimit

Common Scenarios​

Limit Valuable Items:

/ilimit
# Click Diamond → Set to 16
# Click Emerald → Set to 16
# Click Netherite Ingot → Set to 8

Economy Server Setup:

/ilimit
# Limit currency items
# Diamond → 32
# Gold Ingot → 64 (default)
# Iron Ingot → 64 (default)

PvP Balance:

/ilimit
# Limit combat items
# Golden Apple → 16
# Totem of Undying → 1
# Ender Pearl → 16

Admin Workflow​

Complete Setup Example​

# 1. Open GUI
/ilimit

# 2. Configure limits for your server type
# Click each item and set appropriate limits:
- Diamond: 16
- Emerald: 16
- Netherite Ingot: 8
- Golden Apple: 16
- Enchanted Golden Apple: 4
- Totem of Undying: 1
- Ender Pearl: 16

# 3. Test with a player account
# (Limits apply immediately, no reload needed)

# 4. Grant bypass to VIPs if desired
/lp group vip permission set limitless.bypass.* true

Permissions Required​

CommandPermissionDefault
/ilimitlimitless.adminop

Tab Completion​

The /ilimit command has no arguments, so tab completion simply shows the command.

Command Restrictions​

  • Players Only: Must be executed by a player (console cannot open GUI)
  • Permission: Requires limitless.admin permission
  • No Arguments: Command takes no additional arguments

While ItemLimiter only has one command, these vanilla/other plugin commands may be useful:

# Check a player's permissions
/lp user <player> permission check limitless.admin

# Reload the server (if needed)
/reload confirm

# Check plugin status
/plugins

Command Behavior​

Real-Time Application​

Limits set via /ilimit apply immediately without requiring:

  • Server reload
  • Plugin reload
  • Player re log

Persistence​

All limits configured via the GUI are:

  • ✅ Saved to limits.yml
  • ✅ Loaded on server restart
  • ✅ Applied automatically to all players

Bypass Behavior​

Players with limitless.bypass.* permission:

  • Can exceed configured limits
  • See normal vanilla stack sizes
  • Useful for admins and VIPs

Troubleshooting Commands​

GUI Not Opening​

# Check permission
/lp user <your_name> permission check limitless.admin

# Verify plugin loaded
/plugins
# ItemLimiter should be GREEN

# Check console for errors
# Look for GUI-related errors

Limits Not Saving​

# Check file permissions
# On Linux: ls -l plugins/ItemLimiter/
# Ensure server can write to limits.yml

# Manually reload (rare circumstances)
/reload confirm

Best Practices​

  1. Test Limits: Always test with a non-admin account
  2. Document Changes: Keep a list of configured limits
  3. Backup Config: Save limits.yml before major changes
  4. Communicate: Inform players about item limits
  5. Balance: Don't over-restrict - maintain fun gameplay

##Next Steps

Questions? Ask in our Discord!