ArmorStand-Limiter 1.6

Native Minecraft Version:

1.13

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13
• 1.14
• 1.15
• 1.16
• 1.17
• 1.18

Source Code:

https://github.com/xSavior-of-God/ArmorStand-Limiter

Contributors:

@eliotesta98

Donation Link:

https://www.paypal.com/donate/?hosted_button_id=NLLBQGNRYYLJW&locale.x=en

ArmorStand-Limiter
​

allows you to limit armor stands, so you can fix TPS drops caused by a high number of ArmorStands in your server!
Can be used in all modalities and is fully and easily configurable thanks to its intuitive configuration file.


This plugin was created with the express purpose of fixing LAG problems caused by other plugins that generate and do not remove custom Armor Stands within a single block!
Later we also thought of adding other functions to avoid lagging machines caused by Armor Stands, like this one in the picture

​

You can enable/disable the dynamics of the Armor Stands as you wish, so doing so you will not affect the Vanilla dynamics!


Why should you use this plugin?
simply to prevent your server from crashing like the one in this video

Feature
​

⪢ The most important function is that of removing CUSTOM Armor Stands ( created by other plugins ) that exceed the preset limit in a single block or chunk!
⪢ Set Armor Stand limit in a Block and/or a Chunk
⪢ Check the world name, armor stand type and its name to avoid unwanted removal
⪢ Timer that checks every X minutes in the loaded chunks the number of Armor Stands inside the chunk or in the single block
⪢ Check TPS status and if too low check and remove the Armor Stands in a sigle block or chunk ( this check is also performed only on loaded chunks )
⪢ Ability to limit players to placing a maximum of Armor Stands per chunk
⪢ Ability to disable that the Armor Stand can be moved by the pistons or blocks connected to it
⪢ Ability to disable that Armor Stand can move in the water
⪢ Ability to disable that Armor Stand can be spawned through dispensers
⪢ Customized notification ( inGame, Discord, Telegram and Console ) of when Armor Stands are removed due to limit violation
⪢ No Dependency!
⪢ Open Source!

Without ArmorStand-Limiter


With ArmorStand-Limiter



Without ArmorStand-Limiter


With ArmorStand-Limiter



Without ArmorStand-Limiter


With ArmorStand-Limiter​

Without ArmorStand-Limiter


With ArmorStand-Limiter

Commands
​

⪢ /asl - Simple reload of the config file (Perms: armostandlimiter.reload)
⪢ /asl check <chunk> - Simple command to control how many Armor Stands there are in a chunk or location in the world (Perms: armostandlimiter.check)
⪢ /asl test - Simple command to test the notifications (Perms: armostandlimiter.test)

Config​

Spoiler: config.yml

Code (YAML):

#                                                                
#    /\   _  _   _   _ (_  |_  _   _   _|   |   .  _  . |_  _  _
#   /--\ |  ||| (_) |  __) |_ (_| | ) (_|   |__ | ||| | |_ (- |  
#                                                                
#  Developed by xSavior_of_God                                  
#                                                                
#  For SUPPORT                                                  
#   <Discord/>     https://discord.gg/5UuVdTE                    
#                                                                
#                                                                
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

# How many ArmorStands must there be...
ArmorStandLimit:
 # ...in a block to be removed?
  Block:
   # The maximum number of armorstands that can be in a block,
    # if higher, all armorstands will be removed!
    Trigger: 50
    # Do you want to check every x ('Refersh') minutes if there are more Armor Stands
    # than 'ArmorStandLimit' in a block?
    Task:
     # Do you want to enable this task?
      Enabled: false
      # How often should the check be done? ( Recommended 5 )
      Refresh: 10
  # ...in a chunk to be removed?
  Chunk:
   # The maximum number of armorstands that can be in a chunk,
    # if higher, all armorstands will be removed!
    Trigger: 256
    # Do you want to check every x ('Refersh') minutes if there are more Armor Stands
    # than 'ArmorStandLimit' in a chunk?
    Task:
     # Do you want to enable this task?
      Enabled: false
      # How often should the check be done? ( Recommended 5 )
      Refresh: 10
  # Various checks to perform before removing an armorstand
  Checks:
   # List of worlds where armorstands should not be removed
    DisabledWorlds:
     - 'world_disabled'
    # List of words that, if present in the name of the armor stand,
    # prohibit its removal
    DisableIfNameContains:
     - 'CustomName'
    # Disable removal if Armor Stand has a Name
    DisableIfNamed: true
    # (ONLY 1.9+) Disable removal if Armor Stand is Invulnerable
    DisableIfIsInvulnerable: true
    # Disable removal if Armor Stand is Invisible
    DisableIfIsInvisible: true
    # Disable removal if Armor Stand has Arms
    DisableIfHasArms: true
    # Disable removal if Armor Stand has not BasePlate
    DisableIfHasNotBasePlate: true
    # Disable removal if Armor Stand has Helmet
    DisableIfHasHelmet: false
    # Disable removal if Armor Stand is small
    DisableIfIsSmall: true
    # Disable if an entity is part of a hologram
    DisableIfHolographicDisplaysEntityPart: false
    # Disable if is active part of a Model Engine Entity
    # ( Required ModelEngine https://www.spigotmc.org/resources/79477/ )
    DisableIfIsModelEngineEntity: true

noPerms: "&cUnknown Command or you don't have permissions!"
tooManyArmorStand: "&c&lHey! &7You can't place it here, there are more than {max} armor stands in this chunk!"

# TPS Meter will allow you to analyze the tps every tick,
# if they are lower than the preset value in 'Trigger' the Armor Stands
# will be cleared only if they are more than 'ArmorStandLimit' in a single block
TPSMeter:
 # Do you want to enable this feature?
  Enabled: false
  # Under how many TPS must the server go down to trigger this event? ( Recommended 17 )
  Trigger: 17

# Various events
Events:
 # Do you want to limit the armor stands placed by users in a chunk?
  # the limit is based on the one set above (ArmorStandLimit -> Chunk -> Trigger)
  LimitArmorStandPlaceForChunk: false
  # Do you want to disable armorstand spawning through dispensers?
  DisableDispenserSpawningArmorstand: false
  # Do you want to disable the armor stand from moving...
  DisableArmorStandMoving:
   # in water ( This option will also disable the armorstand gravity!
               # if you know an alternative way to fix this problem
               # let me know! )
    Water: false
    # pushed by a piston
    Piston: false

# Want to be notified whenever Armor Stands are removed?
Notifications:
 # This option will allow you to completely disable all notifications,
  # if on true, it will only enable them if they are enabled
  Enabled: true

  # Do you want to receive a message in the console as a notification?
  Console:
    Enabled: true
    # Message format
    #
    # Placeholders:
    #   {x} => Coordinate X
    #   {z} => Coordinate Z
    #   {world} => World Name
    #   {type}  => Chunk or xyz
    #   {counter} => Total number of Armor Stands found in that location
    #   {max} => The value of 'ArmorStandLimit'
    Message: |
     &c&l----------------------------
      &r
      &eArmorStand Limiter
      &r
      &fWorld &e{world}
      &fType &e{type}
      &fX  &e{x}
      &fZ  &e{z}
      &fCounter   &c{counter}&f/{max}
      &r
      &c&l----------------------------

  # Want to receive an in-game message as a notification?
  OnlinePlayer:
    Enabled: true
    # What is the permission you need to have to receive this notification?
    Permission: "armostandlimiter.notify"
    # Message format
    #
    # Placeholders:
    #   {x} => Coordinate X
    #   {z} => Coordinate Z
    #   {world} => World Name
    #   {type}  => Chunk or xyz
    #   {counter} => Total number of Armor Stands found in that location
    #   {max} => The value of 'ArmorStandLimit'
    Message: |
     &c&l----------------------------
      &r
      &eArmorStand Limiter
      &r
      &fWorld &e{world}
      &fType &e{type}
      &fX  &e{x}
      &fZ  &e{z}
      &fCounter   &c{counter}&f/{max}
      &r
      &c&l----------------------------

  Telegram:
    Enabled: false
    # Telegram bot API
    API: "https://api.telegram.org/bot"
    # The token of the bot that sends you the notification
    Token: ""
    # The unique id of the chat in which the message will be sent
    ChatID: ""
    # Message format
    #
    # Placeholders:
    #   {x} => Coordinate X
    #   {z} => Coordinate Z
    #   {world} => World Name
    #   {type}  => Chunk or xyz
    #   {counter} => Total number of Armor Stands found in that location
    #   {max} => The value of 'ArmorStandLimit'
    Message: |
     <b>ArmorStand Limiter</b>
      %empity%
      <b>World</b>  <code>{world}</code>
      <b>Type</b>  <code>{type}</code>
      <b>X</b>  <code>{x}</code>
      <b>Z</b>  <code>{z}</code>
      %empity%
      <b>Counter</b>  {counter} <code>| {max}</code>

  Discord:
    Enabled: false
    # The token of the bot that sends you the notification
    Webhook: ""
    # Message format
    Title: "ArmorStand Limiter"
    # Default null(Invisible) characters
    Description: "%empity%"
    # color code, type HEX ("#ffeb3b")
    Color: "#ffeb3b"
    # Message format
    #
    # Placeholders:
    #   {x} => Coordinate X
    #   {z} => Coordinate Z
    #   {world} => World Name
    #   {type}  => Chunk or xyz
    #   {counter} => Total number of Armor Stands found in that location
    #   {max} => The value of 'ArmorStandLimit'
    Message: |
     **World**  {world}
      **Type**  `{type}`
      **X**  `{x}`
      **Z**  `{z}`
      **Counter**  `{counter}`/{max}

 

Support​

https://discord.gg/5GqJbRw

​