AutoTurrets Plugin

AutoTurrets is a configurable turret plugin for Minecraft servers. It allows players to place automated defensive units (turrets) that track and attack entities based on selected settings. The plugin supports GUI interaction, weapon selection, targeting options, and a friend system to exclude allies from attacks.

Features

Turret System

Players can craft and place turret blocks. Once placed, a turret can be configured through an in-game interface. Each turret is represented by an invisible armor stand equipped with a dispenser model and a health indicator.

Turrets can:

• Track and aim at targets in real time using entity rotation.
• Attack only entities visible within line-of-sight.
• Be manually enabled or disabled.
• Be destroyed and repaired using iron ingots.
• Change their appearance based on status (broken or active).

Target Selection

Targeting is fully customizable:

• Players can choose whether turrets attack players, hostile mobs, and animals.
• The GUI allows switching each category on or off.
• Turrets ignore the owner and any listed friends.

Weapon System

Turrets support modular weapon configurations:

• Each weapon has defined damage and cooldown properties.
• Example weapons include:
  • Bow (uses arrows as ammunition)
  • Laser weapon (uses custom ammo)
• Weapon switching is supported via the menu.
• Ammo must be manually inserted into the turret's inventory.

Friend System

Players can add other users as friends to prevent their turrets from targeting them. This system is managed through commands:

• /turret friend add <player>
• /turret friend remove <player>
• /turret friend list

If a player is not online or does not exist, appropriate messages will be shown.

GUI and Localization

The plugin includes a full GUI system:

• Main turret control menu with options to:
  • Load ammo
  • Select attack targets
  • Enable/disable the turret
  • View usage instructions
• Crafting menu and general information windows
• All text messages are configurable through a language file (TurretsLang) with built-in defaults for messages and tooltips

Events and Feedback

The plugin provides configurable event messages such as:

• Turret installation
• Turret repairs
• Kills made by turrets
• Warnings about interaction requirements (e.g. must disable turret before loading ammo)

Crafting

Custom items such as the turret block and laser ammo include titles and descriptions shown in the crafting interface. Crafting recipes and item metadata are defined within the plugin.

Dependencies

• Bukkit or Spigot server (1.20+ recommended)
• No external plugin dependencies

Notes

• Turrets do not function if broken.
• Only the owner can remove a turret once placed.
• Turrets use the server’s task scheduler and update every 5 ticks when enabled.