By
MON@H
in Plugins
The purpose of this plugin is to restrict the entities that players can build. You can limit any entity based on its prefab. To get the full list of supported prefabs use limitentities.list console command.
There are two types of limits available: global and building. For building limit checks, if a cupboard is placed, the limits of the cupboard owner will apply. If no cupboard is placed, the restrictions of the owner of the first block will apply. When you run the plugin for the first time, no players will be limited. To apply limits, you must assign one or more permissions from your config file to a player/group. The plugin also tracks permission changes, so you will not need to restart the plugin after giving a player new permission or adding them to a VIP group, etc. This plugin is designed to be efficient and performant even on highly loaded servers.
This plugin now supports `Entity Groups`, and group names are translatable. All newly created groups are added to the language files on plugin load. You are free to create as many groups as you want or remove them all. The only thing you should keep in mind is that if you added an entity to a group, you can't add the same entity to `Limits Entities`, you must use the `Group name`.
Extended Power Lights (Deluxe Christmas Lights) support added: there is a new group of limits added into config. Defaults are -1, means no limits. Set it according to your needs.
Note: If you want to have "beautiful" names even on English only, please, install Rust Translation API plugin or you will have a short prefab names only.
## Permissions
limitentities.immunity -- Allows player to not being limited by this plugin
limitentities.admin -- Allows player to check other player limits and execute console command
More permissions with limits are created in config file (see Configuration section below)
## Commands
/limits <player name | steamid> (optional) -- Get current limits list for a player. If player doesn't have admin permission or player name/id is empty - current player limit will be shown
limitentities.list (console only) - print all tracked prefabs list into log file. Requires admin rights (can be used in server console/RCON)
## Configuration
You can remove unnecessary default permissions and also add as many permissions as you want. For cases where the player has more than one, the permission with the higher priority will be applied.
Note: For better performance, grant permissions only to players you want to limit, or use an immunity permission to disable limits entirely.
Enable or disable notifications and logging.
Set the Building Detection Range to be used when a building is not specified (e.g., not a decay entity). Do not set this value too high — it may significantly impact performance!
Enable or disable tracking (and limiting) for Power Lights (Deluxe Christmas Lights).
Enable or disable tracking (and limiting) for Growable Entities.
Set the SteamIDIcon to a specific SteamID to customize the account icon in chat messages.
Define the commands list (defaults are limits and limit).
Set the percentage (%) at which limit notifications appear. If set to 0, notifications will only show when the limit is reached.
Add entity prefab names to the Excluded List to make the plugin completely ignore those prefabs.
Enabling Prevent Excessive Merging of buildings may affect performance, so use it at your own risk!
Use Entity Groups to combine entities and set a shared limit for the entire group.
Note: The same entity cannot be listed in both Group Entities and Limits Entities at the same time.
## Localization
Plugins phrases are available on 3 languages out of the box: English, Ukrainian and Russian
Plugin supports Rust Translation API which allows you to have entities names on any language Rust supports
There is a free version on uMod, why do you even need this plugin?
First of all, this plugin was designed to be efficient and performant. It uses unique caching system that should not consume no additional server resources
Much more efficient building limit control system even without cupboard placed
More accurate mechanism for notification messages
Allows you to prevent entities placement if limit is set to 0
Supports Rust Translation API so you can have full support of any language Rust supports
Supports Entity Groups !
Supports checks to prevent excessive merging of buildings
Supports Abandoned Bases plugin
Supports advanced limits for Power Lights (Deluxe Christmas Lights)
Supports setting advanced building detection range