SKO-GridPCULimiter

Description

A PCU limiter for Grids. Allows you to configure the max PCU for grids on your server. It also provides you options for allowing or disallowing Projections and Merges if the max PCU thresholds has been reached. You can also control if you want to include the Connected grids in the calculations and prevent abuse of connectors to go over PCU limits.

The current version will REMOVE the block when welded to functional if it exceeds the Grid PCU limit. This is to avoid weld spamming for now, but will improve this in the future or make it configurable.

NOTE: Existing servers with high PCU ships over the set limit will still be available. Players only get limited on placing/welding new blocks from the time the plugin has been enabled.

Available Features / Configuration:

Config file:

In the Instance folder, you will find the file SKOGridPCULimiter.cfg that holds all configuration data.

Config options:

Enabled: Enable the plugin?
MaxGridPCU: Define max PCU for grids.
AllowProjection: Allow projections when max PCU has been reached? It also checks if both grids (projected and the base grid) reached PCU limits together.
AllowMerge: Allow merging grids if together they exceed the PCU limit?
IncludeConnectedGridsPCU: When calculating PCU of a grid, should we include the connected/docked grids?
MaxNumberOfConnectedGrids: If you've enabled IncludeConnectedGridsPCU, you can restrict the number of grids that can be connected when you exceed the PCU limits. Setting this to 0 will not allow any grids to be connected. Connectors will get disabled.
DamageConnectors: If you also want connectors to get damaged, you can enable this option. This also provides a way to prevent connect-spamming with scripts.
DisableWeldersWithinMeters: When welding block to functional detects you're exceeding the Grid PCU limit, it will remove the block and also disable welders. You can define the distance from that block to search for welders to disable. This can be handy if using tiered welders that can weld over high distances. In that case, you can increase this option if you wish to disable those.
IgnoreNPCGrids: You can set this to true if you want to ignore Grid PCU limits for NPC's. In some cases mods will try to add blocks and that might be blocked if the grid exceeds the PCU limit.

Commands

!gridpculimiter config : View current config (Admin).
!gridpculimiter reload : Reloads the config on the server (Admin). You can do this live during a ongoing session. Simply modify the file on the server and use this command to change the settings on the server.

Support

Bugs and Feature requests can be reported here:

Donate

If you wish to support my work and you find this plugin useful, you can donate via PayPal:

## Description
A PCU limiter for Grids. Allows you to configure the max PCU for grids on your server. It also provides you options for allowing or disallowing Projections and Merges if the max PCU thresholds has been reached. You can also control if you want to include the Connected grids in the calculations and prevent abuse of connectors to go over PCU limits.

The current version will `REMOVE` the block when welded to functional if it exceeds the Grid PCU limit. This is to avoid weld spamming for now, but will improve this in the future or make it configurable.

*NOTE*: Existing servers with high PCU ships over the set limit will still be available. Players only get limited on placing/welding new blocks from the time the plugin has been enabled.

## Available Features / Configuration:

### Config file:
In the Instance folder, you will find the file `SKOGridPCULimiter.cfg` that holds all configuration data.

### Config options:
- `Enabled`: Enable the plugin?
- `MaxGridPCU`: Define max PCU for grids.
- `AllowProjection`: Allow projections when max PCU has been reached? It also checks if both grids (projected and the base grid) reached PCU limits together.
- `AllowMerge`: Allow merging grids if together they exceed the PCU limit?
- `IncludeConnectedGridsPCU`: When calculating PCU of a grid, should we include the connected/docked grids?
- `MaxNumberOfConnectedGrids`: If you've enabled IncludeConnectedGridsPCU, you can restrict the number of grids that can be connected when you exceed the PCU limits. Setting this to `0` will not allow any grids to be connected. Connectors will get disabled.
- `DamageConnectors`: If you also want connectors to get damaged, you can enable this option. This also provides a way to prevent connect-spamming with scripts.
- `DisableWeldersWithinMeters`: When welding block to functional detects you're exceeding the Grid PCU limit, it will remove the block and also disable welders. You can define the distance from that block to search for welders to disable. This can be handy if using tiered welders that can weld over high distances. In that case, you can increase this option if you wish to disable those.
- `IgnoreNPCGrids`: You can set this to `true` if you want to ignore Grid PCU limits for NPC's. In some cases mods will try to add blocks and that might be blocked if the grid exceeds the PCU limit.

## Commands
- `!gridpculimiter config` : View current config (Admin).
- `!gridpculimiter reload` : Reloads the config on the server (Admin). You can do this live during a ongoing session. Simply modify the file on the server and use this command to change the settings on the server.

## Support
Bugs and Feature requests can be reported here:

[![](https://img.shields.io/github/issues/sko85/TorchPlugins)](https://github.com/SKO85/TorchPlugins/issues)

## Donate
If you wish to support my work and you find this plugin useful, you can donate via PayPal:

[![](https://img.shields.io/badge/Donate-Paypal-brightgreen)](https://paypal.me/sko85gaming)