https://github.com/restoremonarchyplugins/buildingrestrictions
Set the limits for the number of buildings the player can build.
https://github.com/restoremonarchyplugins/buildingrestrictions
unturned unturned-plugin unturned-rocket-plugin
Last synced: 4 days ago
JSON representation
Set the limits for the number of buildings the player can build.
- Host: GitHub
- URL: https://github.com/restoremonarchyplugins/buildingrestrictions
- Owner: RestoreMonarchyPlugins
- Created: 2024-09-02T17:11:53.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-01-17T10:30:03.000Z (over 1 year ago)
- Last Synced: 2025-01-17T11:30:31.761Z (over 1 year ago)
- Topics: unturned, unturned-plugin, unturned-rocket-plugin
- Language: C#
- Homepage: https://restoremonarchy.com/plugins/buildingrestrictions
- Size: 206 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Building Restrictions
A plugin that allows server admins to set limits on the number of buildings players can place in Unturned.
## Features
- Limit total buildings per player
- Limit barricades and structures separately
- Set specific limits for different building types
- Height restrictions for buildings
- Location-based building limits with bypass permission and configurable excluded items
- Road building restriction (both spline roads and city street objects)
- Multipliers for players with special permissions
## Commands
- `/buildingstats` - Shows your current building counts and limits
- `/buildingstats ` - Shows another player's building counts and limits (requires permission)
## Permissions
- `buildingstats` - Allows using the `/buildingstats` command
- `buildingstats.other` - Allows checking other players' building stats
- `buildings.vip` - Example permission for multiplier (customizable)
- `buildings.location.bypass` - Bypass location-based building limits
- `buildings.road.bypass` - Bypass road building restriction
> **Note**: Admins always have all permissions in RocketMod, so they will automatically bypass location and road restrictions.
## Configuration
### General Settings
```xml
yellow
https://i.imgur.com/LlEcfBg.png
false
200
false
100
false
150
```
- `MessageColor` - Color of plugin messages
- `MessageIconUrl` - Icon shown with messages
- `EnableMaxBuildings` - Set to `true` to limit total buildings
- `MaxBuildings` - Maximum total buildings allowed per player
- `EnableMaxBarricades` - Set to `true` to limit barricades separately
- `MaxBarricades` - Maximum barricades allowed per player
- `EnableMaxStructures` - Set to `true` to limit structures separately
- `MaxStructures` - Maximum structures allowed per player
### Height Restrictions
```xml
false
100
false
100
```
- `EnableMaxBarricadeHeight` - Set to `true` to limit barricade height
- `MaxBarricadeHeight` - Maximum height (in meters) for barricades
- `EnableMaxStructureHeight` - Set to `true` to limit structure height
- `MaxStructureHeight` - Maximum height (in meters) for structures
### Road Restriction
```xml
false
5
```
- `EnableRoadRestriction` - Set to `true` to prevent building on roads
- `RoadRestrictionHeight` - Maximum height (in meters) above a road surface where building is blocked
When enabled, players cannot place any barricades or structures on roads. This includes:
- **Spline roads** - Roads created with the road tool in the map editor
- **Object roads** - Road objects placed in cities (any object with chart type `STREET`, `ROAD`, or `HIGHWAY`)
Players with the `buildings.road.bypass` permission can still build on roads.
### Location Restrictions
```xml
false
100
10
```
- `EnableMaxBuildingsPerLocation` - Set to `true` to limit buildings in specific areas
- `MaxBuildingsPerLocationHeight` - Maximum height for location detection
- `MaxBuildingsPerLocation` - Maximum buildings allowed in a location
- Set to `0` to completely disable building in locations
- `LocationRestrictionExcludedIds` - List of item IDs that are excluded from location limits. These items can always be placed regardless of the limit, and they don't count toward the limit for other buildings.
- `Id` - The item ID in Unturned
- `Name` - Display name for reference (doesn't affect functionality)
The following building types are always excluded from location counting: Safezone Radiators, Horde Beacons, Charges, and Vehicle barricades.
Players with the `buildings.location.bypass` permission can ignore location limits entirely.
### Specific Building Limits
```xml
```
- `Barricades` - List of specific barricade type restrictions
- `Structures` - List of specific structure type restrictions
- For each entry:
- `Name` - Display name for the building type (informational only, doesn't affect functionality)
- `Build` - Barricade type (use values from Barricade Build types list)
- `Construct` - Structure type (use values from Structure Construct types list)
- `ItemId` - Specific item ID (overrides Build/Construct)
- `Max` - Maximum number allowed
#### Restriction Methods:
You can restrict buildings in three ways:
1. **By Building Category**: Use the `Build` attribute for barricades or `Construct` for structures to restrict entire categories (e.g., all SENTRY types).
2. **By Specific Item ID**: Use the `ItemId` attribute to restrict a specific item. For example:
- `ItemId="365"` restricts Sandbag barricades specifically
- `ItemId="371"` restricts Metal Walls specifically
3. **Combined Restrictions**: You can have both category restrictions and specific item restrictions active at the same time.
> **Note**: When using ItemId, you need to know the exact ID number of the item in Unturned. Using ItemId will override category-based restrictions for that specific item. The `Name` attribute is just for your reference and doesn't need to match the exact item name in Unturned.
### Permission Multipliers
```xml
```
- Use multipliers to give certain players higher limits
- `Permission` - The permission to check for
- `Multiplier` - How much to multiply the limits (1.5 = +50%)
## Building Types Reference
### Barricade Types
```
FORTIFICATION, BARRICADE, DOOR, GATE, BED, LADDER, STORAGE, FARM,
TORCH, CAMPFIRE, SPIKE, WIRE, GENERATOR, SPOT, SAFEZONE, FREEFORM,
SIGN, VEHICLE, CLAIM, BEACON, STORAGE_WALL, BARREL_RAIN, OIL, CAGE,
SHUTTER, TANK, CHARGE, SENTRY, SENTRY_FREEFORM, OVEN, LIBRARY,
OXYGENATOR, GLASS, NOTE, HATCH, MANNEQUIN, STEREO, SIGN_WALL,
CLOCK, BARRICADE_WALL
```
### Structure Types
```
FLOOR, WALL, RAMPART, ROOF, PILLAR, POST, FLOOR_POLY, ROOF_POLY
```