Skip to main content

ItemLimiter Configuration

Configuration file reference and customization guide.

Configuration Files​

ItemLimiter uses two configuration files:

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

config.yml​

Main configuration file (auto-generated on first run):

# ItemLimiter Configuration
# Version 1.1

# Update Checker Settings
update-checker:
  enabled: true
  modrinth-slug: "item-limits"
  check-interval: 3600  # seconds (1 hour)

# Bypass Permission
bypass-permission: "limitless.bypass.*"

# GUI Settings
gui:
  title: "&6&lItem Limiter Configuration"
  size: 54  # Must be multiple of 9 (9-54)
  fill-empty: true
  fill-material: GRAY_STAINED_GLASS_PANE

# Limit Enforcement
enforcement:
  check-on-pickup: true
  check-on-craft: true
  check-on-inventory-move: true
  check-on-give: true

# Messages
messages:
  prefix: "&8[&6ItemLimiter&8]"
  limit-exceeded: "&cYou cannot stack more than %limit% of this item!"
  limit-set: "&aSet %item% limit to %limit%"
  limit-removed: "&aRemoved limit for %item%"
  no-permission: "&cYou don't have permission to use this command!"

Update Checker​

update-checker:
  enabled: true              # Enable/disable update checking
  modrinth-slug: "item-limits"  # Modrinth project slug
  check-interval: 3600       # Check every hour

Options:

  • enabled: true/false - Enable automatic update checking
  • modrinth-slug: Modrinth project identifier
  • check-interval: Seconds between checks (default: 1 hour)

GUI Settings​

gui:
  title: "&6&lItem Limiter Configuration"
  size: 54
  fill-empty: true
  fill-material: GRAY_STAINED_GLASS_PANE

Options:

  • title: GUI window title (supports color codes)
  • size: Inventory size (9, 18, 27, 36, 45, or 54)
  • fill-empty: Fill empty slots with glass pane
  • fill-material: Material for filler items

Enforcement Settings​

enforcement:
  check-on-pickup: true      # Enforce when picking up items
  check-on-craft: true       # Enforce when crafting
  check-on-inventory-move: true  # Enforce when moving items
  check-on-give: true        # Enforce with /give command

Enable/disable limit checking for specific events.

Messages​

messages:
  prefix: "&8[&6ItemLimiter&8]"
  limit-exceeded: "&cYou cannot stack more than %limit% of this item!"
  limit-set: "&aSet %item% limit to %limit%"
  limit-removed: "&aRemoved limit for %item%"
  no-permission: "&cYou don't have permission!"

Placeholders:

  • %limit% - The configured limit
  • %item% - Item display name
  • %player% - Player name

Color Codes:

  • &0-&f - Standard Minecraft colors
  • &l - Bold
  • &o - Italic
  • &n - Underline

limits.yml​

Stores item limits (managed via GUI):

# Item Limits
# Managed by /ilimit GUI - edit at your own risk

limits:
  DIAMOND:
    max-stack: 16
  EMERALD:
    max-stack: 16
  NETHERITE_INGOT:
    max-stack: 8
  GOLDEN_APPLE:
    max-stack: 16
  ENCHANTED_GOLDEN_APPLE:
    max-stack: 4
  TOTEM_OF_UNDYING:
    max-stack: 1
  ENDER_PEARL:
    max-stack: 16

⚠️ Warning: This file is auto-managed by the GUI. Manual editing may cause issues.

Customization Examples​

Economy Server​

# Focus on currency item limits
limits:
  DIAMOND: 32
  EMERALD: 32
  GOLD_INGOT: 64
  NETHERITE_INGOT: 16

PvP Server​

# Balance combat items
limits:
  GOLDEN_APPLE: 16
  ENCHANTED_GOLDEN_APPLE: 4
  TOTEM_OF_UNDYING: 1
  ENDER_PEARL: 16
  TNT: 16

Survival Server​

# Gentle limitations
limits:
  DIAMOND: 48
  EMERALD: 48
  NETHERITE_INGOT: 32

Applying Changes​

Via GUI​

  • Changes apply immediately
  • No reload required
  • Automatically saved to limits.yml

Via Manual Edit​

  1. Stop server (recommended)
  2. Edit limits.yml
  3. Start server

OR

  1. Edit limits.yml while running
  2. Run /reload confirm (may cause issues)

Configuration Tips​

  1. Backup First: Always backup config before editing
  2. Test Changes: Test with non-admin account
  3. Use GUI: Prefer GUI over manual editing
  4. Document: Keep notes on why limits were set
  5. Balance: Don't over-restrict fun items

Troubleshooting​

Config Not Loading​

Check:

  • YAML syntax (use YAML Lint)
  • File permissions (server must be able to read/write)
  • File location (plugins/ItemLimiter/config.yml)

Limits Not Saving​

Fix:

  • Check file permissions
  • Ensure disk space available
  • Verify no filesystem errors

Messages Not Showing​

Verify:

  • Messages section exists in config
  • Color codes are valid
  • Plugin reloaded after config edit

Next: Usage Examples for practical scenarios