Skip to main content

ItemLimiter Usage Guide

Practical tutorials and examples for using ItemLimiter effectively.

Basic Workflows​

Setting Up Your First Limits​

Scenario: You want to balance your economy server by limiting valuable items.

Steps:

  1. Open Configuration GUI:

    /ilimit

  2. Set Limits for Valuable Items:

    • Click Diamond → Enter 16
    • Click Emerald → Enter 16
    • Click Netherite Ingot → Enter 8
    • Click Gold Ingot → Enter 32

  3. Test with a non-admin player account

  4. Adjust as needed based on feedback

Server Type Setups​

####Economy Server

Focus on currency and trade items:

Limits:
- Diamond: 16-32 (main currency)
- Emerald: 16-32 (premium currency)
- Netherite Ingot: 8 (rare currency)
- Gold Ingot: 64 (common currency, maybe no limit)

How to Configure:

  1. /limit → Click each item
  2. Set appropriate limits
  3. Test trading economy
  4. Balance based on server needs

PvP Server​

Balance combat items:

Limits:
- Golden Apple: 16 (prevents spam)
- Enchanted Golden Apple: 4 (rare healing)
- Totem of Undying: 1 (no spamming)  
- Ender Pearl: 16 (mobility limit)
- TNT: 16 (prevent griefing)
- Crystal: 8 (end crystal PvP)

Configuration:

/ilimit
# Click and set each combat item
# Test in PvP scenarios
# Adjust based on balance

Survival/Vanilla+​

Gentle limitations:

Limits:
- Diamond: 48 (minor restriction)
- Netherite Ingot: 32 (slightly limited)
- Most items: Default 64

Setup:

/ilimit
# Only limit truly valuable items
# Keep gameplay mostly vanilla

Use Case Examples​

Example 1: New Economy Server​

Goal: Create balanced economy with diamond currency

Setup:

# Step 1: Limit diamonds
/ilimit → Diamond → 16

# Step 2: Test trading
# Give players diamonds
# Ensure they can't stack beyond 16

# Step 3: Inform players
# Broadcast:  "Diamonds limited to 16 per stack for economy balance"

# Step 4: Grant VIP bypass
/lp group vip permission set limitless.bypass.* true

Example 2: PvP Balance​

Goal: Prevent combat item spam

Setup:

# Limit healing items
/ilimit
→ Golden Apple: 16
→ Enchanted Golden Apple: 4
→ Totem of Undying: 1

# Limit mobility
→ Ender Pearl: 16

# Test in combat
# Adjust based on PvP meta

Example 3: Anti-Duplication​

Goal: Limit duped items quickly

Setup:

# If players dupe netherite:
/ilimit → Netherite Ingot → 1

# Prevents mass stacking duped items
# Buy time to fix dupe exploit
# Remove limit once fixed

Advanced Techniques​

Temporary Limits​

Quickly apply limits for events:

# Before event
/ilimit → Event Item → Low Limit

# During event
# Limit enforced

# After event
/ilimit → Right-click Event Item (removes limit)

Group-Based Access​

Different limits for different groups:

# VIPs bypass all limits
/lp group vip permission set limitless.bypass.* true

# Regular players
# No bypass → Limits enforced

# Staff can configure
/lp group admin permission set limitless.admin true

Seasonal Balancing​

Adjust limits based on server progression:

# Early Season: Strict limits
Diamond: 16
Netherite: 4

# Mid Season: Moderate limits  
Diamond: 32
Netherite: 8

# Late Season: Relaxed limits
Diamond: 48
Netherite: 16

Common Scenarios​

Scenario: Preventing Item Hoarding​

Problem: Players hoarding valuable items

Solution:

/ilimit
# Set low limits on hoarded items
→ Diamond Block: 1
→ Netherite Block: 1
→ Shulker Box: 8

Scenario: Balancing Shop Economy​

Problem: Shop prices unbalanced due to mass buying

Solution:

# Limit shop currency items
/ilimit → Currency Item → 16

# Forces multiple trips
# Prevents instant richness

Scenario: Event Management​

Problem: Special event items too powerful

Solution:

# Before event
/ilimit → Special Item → Event Limit

# After event  
/ilimit → Right-click to remove

Best Practices​

  1. Start Conservative: Begin with lower limits, increase if needed
  2. Test Thoroughly: Always test with regular player account
  3. Communicate: Tell players why limits exist
  4. Document: Keep notes on configured limits
  5. Balance: Don't over-restrict fun items
  6. VIP Perks: Use bypass as donator benefit
  7. Feedback: Listen to player concerns
  8. Adjust: Be willing to change limits

Testing Your Configuration​

Test Checklist​

  • Can non-admin players see limits in action?
  • Do bypass permissions work for VIPs?
  • Are limits saving across restarts?
  • Do messages display correctly?
  • Is economy balanced?
  • Are players satisfied?

Testing Procedure​

  1. Create test account (no permissions)
  2. Try to stack items beyond limit
  3. Verify message shows correctly
  4. Test bypass with VIP account
  5. Restart server and verify limits persist

Troubleshooting Usage​

Players Complaining About Limits​

Solutions:

  • Explain reasoning behind limits
  • Gather feedback on specific issues
  • Consider adjusting limits
  • Offer bypass as VIP perk

Limits Too Restrictive​

Fix:

/ilimit → Increase limit values
# Test new limits
# Gather feedback

Limits Too Lenient​

Fix:

/ilimit → Decrease limit values
# Monitor economy/gameplay
# Adjust as needed

Quick Reference​

ActionCommand/Steps
Set Limit/ilimit → Click item → Enter number
Remove Limit/ilimit → Right-click item
Grant Bypass/lp group <group> permission set limitless.bypass.* true
Check Limits/ilimit → View GUI

Next: API Documentation for developers
Questions? Ask in Discord!