Auto Turret Interference & Settings 1.3.0

Auto Turret Interference & Settings

Auto Turret Interference allows you or your CLAN/TEAM to change the limit of turrets allowed for different players, based on your configurations and assigned roles. You can also make sure that the server or event turrets do not have interference, for example Raidable Base.

In addition, it offers commands to see the statistics on the auto turrets, the possibility of turning the turrets ON and OFF via command, automatic switching ON and OFF of the auto turrets and much more.

It also allows you to modify some automatic turret configurations, for example:

• Customize rotation angle,
• Viewing angle and target scanning,
• Infinite Ammo: In the next release
• Health,
• Range,
• Bullet Speed,
• Aim Cone,
• Damage Scale

Oxide/Carbon compatibility
 

Basically, 4 groups are configured: Default, VIP1, VIP2, VIP3, in this way you can decide the limit of turrets in a given radius based on the group assigned to the user or the group they belong to

Permissions:

• autoturretinterference.admin -- Allows you to execute some commands reserved for administrators
• autoturretinterference.show.allowed -- Allows you to use the /ati show command, to display text above the auto turrets with the status they are in.

• ----------------------------------------
• autoturretinterference.default -- Assign configurations: Default
• autoturretinterference.vip1 -- Assign configurations: VIP1
• autoturretinterference.vip2 -- Assign configurations: VIP2
• autoturretinterference.vip3 -- Assign configurations: VIP3

These are the groups that are created by default, but you can add and/or edit groups as you wish.
For example, if you change the group vip1 to vip_elite, the permission autoturretinterference.vip_elite will be created
If you create a new group, for example vipvanilla, the permission autoturretinterference.vipvanilla will be created.

COMMANDS

Commands can be typed in chat (by putting the / character in front of the command), or from console.

• /ati status or /ati st -- This command allows the player to see his auto turret statistics and limits
• /ati status <steamID> or  /ati st <steamID> -- This command allows the administrator to see another players auto turret and limit statistics. To use this command you must have permission: autoturretinterference.admin
   
• /ati start or  /ati stop -- This command allows the player to turn on or off the single auto turret you are looking at. To use this command, you must enable the AllowCommandsToStartAndStop = true property in your configuration or have permission: autoturretinterference.admin
  • NB: If you have autoturretinterference.admin permission, you can turn on or off the auto turret you are watching of any player.
     
• /ati startall or  /ati stopall -- This command allows the player to turn all of your auto turrets ON or OFF. To use this command, you must enable the AllowCommandsToStartAndStop = true property in your configuration or have permission: autoturretinterference.admin
  • NB: If the player is part of a clan/team, all turrets of all members of the clan/team will be turned ON or OFF.
• /ati startall <steamID> or  /ati stopall <steamID> -- This command allows you to turn ON or OFF all turrets of a player based on its SteamID. To use this command you must have permission: autoturretinterference.admin
  • NB: If the player is part of a clan/team, all turrets of all members of the clan/team will be turned ON or OFF.
     
• /ati show or /ati sh -- Command to display text above the auto turret with the status they are in.
  Useful for finding turrets that are having problems.
  To use this command you must have permission: autoturretinterference.show.allowed
  You can pass one of these parameters:
  • /ati show 0: Show all player auto turrets in all states.
  • /ati show 1: Show text on all player active auto turrets
  • /ati show 2: Show text on all player turned off auto turrets
  • /ati show 3: Display text on all player auto turrets not connected to power
  • /ati show 4: Display text on all player auto turrets with interference
  • /ati show 5: Display text on all player auto turrets with information on the name of the weapon and the ammunition present in the auto turrets
  • /ati show 6: Display text on all player auto turrets without a weapon
  • /ati show 7: Display text on all player auto turrets without ammunition
     
• /ati show <numbr> <steamID> or /ati sh <numbr> <steamID> -- Command to display text above the auto turret with the state it is in based on the players SteamID.
  To use this command you must have permission: autoturretinterference.admin

Commands can be added or modified in the configuration file: /oxide/config/AutoTurretInterference.json

Command output example (/ati status or /ati st) :

Command output example (/ati show or /ati sh) :

CLAN/TEAM

If you are part of a clan/team and there are 1 more members who have the VIP/ROLE, then all members of the clan/team will benefit.

Example: a clan/team member has the VIP/ROLE to be able to place 40 turrets, in this case all clan/team members will be able to place 40 turrets, but this does not mean that the total number of turrets you can place are added, the limit in in this case there are still 40 turrets, but they can be positioned by all members of the clan/team, rather than just the player who has the VIP/ROLE (in this case we assumed that the VIP/ROLE limited to 40 turrets).

You can enable this setting from the configuration file: "Share Group With Clan/Team members. Default FALSE": false": true

Configuration

The settings and options can be configured in the AutoTurretInterference under the config directory. 
The use of an editor and validator is recommended to avoid formatting issues and syntax errors.

{
  "Remove interference for server auto turrets: default true (Useful for Raidable Bases or events)": true,
  "Share Group With Clan/Team members. Default FALSE": false,
  "PlayerShowTurretCountInfoMessage (Show the player, when he places a turret, a message with the number of turrets that are placed in the radius he is in. Default true.)": true,
  "AllowCommandsToStartAndStop (If set to TRUE, enables commands to allow the player or clan/team to turn their all auto turrets ON or OFF. Default FALSE)": false,
  "EnableAutomaticsStartAndStop (If set to TRUE, the player's turrets will be turned OFF when they go offline and ON when they come back online. For the clan/team, the entire clan must be offline to turn OFF the turrets automatically, but if at least one member of the clan comes back online, all the auto turrets will turn ON. Default FALSE)": false,
  "EnableMessageInfo (If set to TRUE, it shows a message info to the player, when he takes hold of an auto turret, of the commands that the plugin makes available to him)": true,
  "Auto Turret Draw Time (seconds). Default 60s": 60,
  "Auto Turret Draw Font Size (px). Default 16 pixel": 16,
  "Chat Command": [
    "ati",
    "autoturretinterference"
  ],
  "RolePermission": {
    "vip1": {
      "Priority. (lower = higher priority)": 1,
      "Force the maximum number of Auto Turrets for player or entire clan/team (-1 no limit). Default -1": -1,
      "Player Auto Turrets without interference limit": 40,
      "Radius within which the system checks for other turrets (lower = more turrets)": 40,
      "Rotate Auto Turrets 180° degrees instead 90°. Default false": false,
      "Rotate Auto Turrets 270° degrees instead 90°. Default false": false,
      "Rotate Auto Turrets 360° degrees instead 90°. Default false": false,
      "Auto Turret Viewing angle and target scanning. Default 180° Degrees": 180,
      "Enable Auto Turrets custom settings": false,
      "Health (Default 1000)": 1000.0,
      "Range (Default 30)": 30.0,
      "Bullet Speed (Default 200)": 200.0,
      "Aim Cone (Default 4)": 4.0,
      "Damage Scale (Default 1.0)": 1.0
    },
    "vip2": {
      "Priority. (lower = higher priority)": 2,
      "Force the maximum number of Auto Turrets for player or entire clan/team (-1 no limit). Default -1": -1,
      "Player Auto Turrets without interference limit": 30,
      "Radius within which the system checks for other turrets (lower = more turrets)": 40,
      "Rotate Auto Turrets 180° degrees instead 90°. Default false": false,
      "Rotate Auto Turrets 270° degrees instead 90°. Default false": false,
      "Rotate Auto Turrets 360° degrees instead 90°. Default false": false,
      "Auto Turret Viewing angle and target scanning. Default 180° Degrees": 180,
      "Enable Auto Turrets custom settings": false,
      "Health (Default 1000)": 1000.0,
      "Range (Default 30)": 30.0,
      "Bullet Speed (Default 200)": 200.0,
      "Aim Cone (Default 4)": 4.0,
      "Damage Scale (Default 1.0)": 1.0
    },
    "vip3": {
      "Priority. (lower = higher priority)": 3,
      "Force the maximum number of Auto Turrets for player or entire clan/team (-1 no limit). Default -1": -1,
      "Player Auto Turrets without interference limit": 20,
      "Radius within which the system checks for other turrets (lower = more turrets)": 40,
      "Rotate Auto Turrets 180° degrees instead 90°. Default false": false,
      "Rotate Auto Turrets 270° degrees instead 90°. Default false": false,
      "Rotate Auto Turrets 360° degrees instead 90°. Default false": false,
      "Auto Turret Viewing angle and target scanning. Default 180° Degrees": 180,
      "Enable Auto Turrets custom settings": false,
      "Health (Default 1000)": 1000.0,
      "Range (Default 30)": 30.0,
      "Bullet Speed (Default 200)": 200.0,
      "Aim Cone (Default 4)": 4.0,
      "Damage Scale (Default 1.0)": 1.0
    },
    "default": {
      "Priority. (lower = higher priority)": 100,
      "Force the maximum number of Auto Turrets for player or entire clan/team (-1 no limit). Default -1": -1,
      "Player Auto Turrets without interference limit": 12,
      "Radius within which the system checks for other turrets (lower = more turrets)": 40,
      "Rotate Auto Turrets 180° degrees instead 90°. Default false": false,
      "Rotate Auto Turrets 270° degrees instead 90°. Default false": false,
      "Rotate Auto Turrets 360° degrees instead 90°. Default false": false,
      "Auto Turret Viewing angle and target scanning. Default 180° Degrees": 180,
      "Enable Auto Turrets custom settings": false,
      "Health (Default 1000)": 1000.0,
      "Range (Default 30)": 30.0,
      "Bullet Speed (Default 200)": 200.0,
      "Aim Cone (Default 4)": 4.0,
      "Damage Scale (Default 1.0)": 1.0
    }
  },
  "VersionNumber": {
    "Major": 1,
    "Minor": 2,
    "Patch": 0
  }
}

• Remove interference for server auto turrets: default true (Useful for Raidable Bases or events): Whether or not to enable interference for server auto turrets. By default it is true, in this way the server's automatic turrets will not have interference, useful for events for example: Raidable Base.
• Share Group With Clan/Team members: If set to TRUE, the group assigned to a player is shared with all members of the clan/team. The group with the lowest priority is shared, then all members of the clan/team will benefit. Default FALSE
• PlayerShowTurretCountInfoMessage: Show the player, when he places a turret, a message with the number of turrets that are placed in the radius he is in. Default: TRUE.
• AllowCommandsToStartAndStop: If set to TRUE, enables commands to allow the player or clan/team to turn their all auto turrets ON or OFF. Default FALSE.
• EnableAutomaticsStartAndStop: If set to TRUE, the player's turrets will be turned OFF when they go offline and ON when they come back online. For the clan/team, the entire clan must be offline to turn OFF the turrets automatically, but if at least one member of the clan comes back online, all the auto turrets will turn ON. Default FALSE.
• EnableMessageInfo: If set to TRUE, it shows a message info to the player, when he takes hold of an auto turret, of the commands that the plugin makes available to him. Default: TRUE.
• Auto Turret Draw Time (seconds). Default 60s: Duration of display of text above the auto turret. Default 60 seconds.
• Auto Turret Draw Font Size (px). Default 16 pixel: Size of text above auto turret. Default 16 pixel
• Chat Command: Here you can add, edit or delete Commands can be typed in chat (by putting the / character in front of the command), or from console.

• Priority. (lower = higher priority) -- Each group has its own property, the lower this number is, the more important the group is.
  This is useful in the case where a player has more roles assigned. In this case, the group with the lowest priority will be assigned, the most important group.
  Negative numbers are also allowed.
• Player Auto Turrets without interference limit: How many automatic turrets can a player place within the radius within which the system controls the other turrets, without them interfering. For example, basic rust allows 12 turrets in a radius of 40 meters, you can set for example 30 turrets instead of 12.
• Radius within which the system checks for other turrets (lower = more turrets)
• Force the maximum number of Auto Turrets for player or entire clan/team (-1 no limit).
  Maximum total number of auto turrets that can be active for player or entire clan/team.
  When Auto Turrets are placed, only a certain number in a certain radius, configured in the configuration file, can be active at a given time.
  However, this does not prevent you from being able to place unlimited Auto Turrets.
  For example, you have set a limit of 20 Auto Turrets in a 40 meter radius, this means that in a 40 meter radius there can be a maximum of 20 Auto Turrets. But if you place another 20 Auto Turrets more than 40 meters away from the first ones, then you can place another 20 active Auto Turrets, and so on.
  With this option you can establish the maximum number of Auto Turrets that can be active regardless of the radius, in order to avoid unlimited Auto Turrets.
  It is always recommended to use this configuration together with the others.
  For example you can decide that the forced maximum Auto Turrets limit is 5 times the number of active Auto Turrets in a given radius, it's up to you to decide. Default -1.
   
• Auto Turrets rotation angle: Allows you to change the rotation angle of the turret. Targets will be acquired as usual, if they are in front of the turret which however can move to a larger angle.
  • Rotate Auto Turrets 180° degrees instead 90°: If set to TRUE, the auto turrets will rotate 180° instead of the default 90° (degrees). Default False
  • Rotate Auto Turrets 270° degrees instead 90°: If set to TRUE, the auto turrets will rotate 270° instead of the default 90° (degrees). Default False
  • Rotate Auto Turrets 360° degrees instead 90°: If set to TRUE, the auto turrets will rotate 360° instead of the default 90° (degrees). Default False
     
• Auto Turret Viewing angle and target scanning: This is a very powerful setting, it allows the auto turrets to see and acquire targets instantly based on the set angle, regardless of whether the target is in front of the auto turrets or not.
  For example if set to 200°, the auto turrets will acquire targets instantly within 200°.
  Or if set to 360°, the auto turrets will acquire targets instantly in all directions. You can choose the angle you prefer by entering a number between 1° and 360° (degrees). Default 180° Degrees.
   
• Enable Auto Turrets custom settings: If set to TRUE, it allows you to change some Auto turret settings. Default FALSE

  • Health (Default 1000): Auto Turrets maximum health.

  • Range (Default 30): Distance from which the weapon can see.

  • Bullet Speed (Default 200): Speed of bullets fired.

  • Aim Cone (Default 4): The weapon's aiming cone.

  • Damage Scale (Default 1.0): allows you to increase the damage of Auto turrets. A higher value indicates greater damage.

PlayerShowTurretCountInfoMessage EXAMPLE:

EnableMessageInfo EXAMPLE:

Localization

The plugin, therefore the automatic messages and statistics, are translated into the following languages:

• English
• Italian
• Spanish
• French
• German
• Dutch
• Turkish
• Russian
• Ukrainian

Translation files are located in the /oxide/lang folder, here is an example of a /oxide/lang/en/AutoTurretInterference.json translation file.

You can add translations for other languages by adding them to the folder: /oxide/lang