Limits#

Limits allows you to limit island blocks and entities in GameModes like BSkyBlock and AcidIsland.

This addon was made to help limit lag-inducing entities or blocks, e.g., hoppers. It can be used to limit regular blocks and entities but not all can be limited.

Created and maintained by tastybento.

Installation#

1. Place the Limits addon jar in the addons folder of the BentoBox plugin
2. Restart the server
3. The addon will create a data folder and inside the folder will be a config.yml
4. Edit the config.yml how you want.
5. Restart the server if you make a change

Commands#

There is a user command and an admin command called "limits". Admins can check the limits of a specific island owner. Both show a GUI panel with the limits and the current count.

Setup - Config.yml#

The config.yml has the following sections:

• blocklimits
• blocklimits-nether
• blocklimits-end
• blockgrouplimits (1.29.0+)
• blockgrouplimits-nether / blockgrouplimits-end (1.29.0+)
• worlds
• entitylimits
• entitylimits-nether
• entitylimits-end
• entitygrouplimits

It also has these top-level toggles (all added in 1.29.0 unless noted): apply-member-limit-perms, show-limit-messages, stacked-plants-count-as-one, and log-limits-on-join.

blocklimits#

This section lists the maximum number of blocks allowed for each block material. Do not use non-block materials because they will not work. The limits apply independently in every dimension (overworld, nether, end).

blocklimits-nether / blocklimits-end#

Optional sections that override the blocklimits defaults for the nether or the end respectively. They are commented out in the default config; uncomment and add entries to set dimension-specific block limits.

worlds#

This section lists block limits for specific worlds. You must name the world specifically, e.g. AcidIsland_world and then list the materials and the limit. World-named limits override the dimension-default limit above for that specific world.

entitylimits#

This section lists the default entity limits within a player's island space (protected area and to island limit). A limit of 5 will allow up to 5 entities. Affects all types of creature spawning. Also includes entities like MINECARTS. As of 1.28.2, entity limits apply independently per dimension, so the nether and end are now counted and limited correctly (this fixes the long-standing bug where nether/end counts reset to zero on chunk unload).

entitylimits-nether / entitylimits-end#

Optional sections that override the entitylimits defaults for the nether or the end respectively. They are commented out in the default config; uncomment and add entries to set dimension-specific entity limits.

Note: Only the first 49 limited blocks and entities are shown in the limits GUI.

entitygrouplimits#

entitygrouplimits:
  friendly:
    limit: 2
    entities:
      - COW
      - SHEEP
  monsters:
    limit: 4
    entities:
      - ZOMBIE
      - CREEPER

blockgrouplimits#

Define a named group with an icon, a shared limit, and a materials list:

blockgrouplimits:
  Pistons:
    icon: PISTON
    limit: 10
    materials:
    - PISTON
    - STICKY_PISTON
  Soil:
    icon: GRASS_BLOCK
    limit: 200
    materials:
    - GRASS_BLOCK
    - DIRT
    - DIRT_PATH
    - FARMLAND

Per-environment overrides are supported via blockgrouplimits-nether / blockgrouplimits-end, which override only the numeric limit of a group already defined in blockgrouplimits:

blockgrouplimits-nether:
  Pistons: 5

ItemsAdder & Oraxen custom blocks#

blocklimits:
  "iafestivities:christmas/christmas_tree/green_orb": 5
  "oraxen:caveblock": 10

Other toggles#

Permissions#

Island owners can have exclusive permissions that override the default or world settings. Two formats are supported:

1. GAME-MODE-NAME.island.limit.MATERIAL.LIMIT — applied to every dimension.

   example: bskyblock.island.limit.hopper.10

2. GAME-MODE-NAME.island.limit.ENV.MATERIAL.LIMIT — applied to one dimension only, where ENV is one of overworld, nether, or end (1.28.2+).

   example: bskyblock.island.limit.nether.hopper.5

Permissions activate when the player logs in.

Usage permissions are (put the gamemode name, e.g. acidisland at the front):

  GAMEMODE_NAME.limits.player.limits:
    description: Player can use limits command
    default: true
  GAMEMODE_NAME.mod.bypass:
    description: Player can bypass limits
    default: op
  GAMEMODE_NAME.limits.admin.limits:
    description: Player can use admin limits command
    default: op

Full permissions are listed here.

Placeholders#

Translations#

Items that cannot be limited#

Some items cannot be limited (right now). The reasons are usually because there are too many ways to remove the item without it being tracked. If you are a programmer and can work out how to fix these, then please submit a PR!

• Primed TNT
• Evoker Fangs
• Llama Spit
• Dragon Fireball
• Area Effect Cloud
• Ender signal
• Small fireball
• Fireball
• Thrown Exp Bottle
• Shulker Bullet
• Wither Skull
• Tridents
• Arrows
• Spectral Arrows
• Snowballs
• Eggs
• Leashes
• Ender crystals
• Ender pearls
• Ender dragon

Changelog#