> For the complete documentation index, see [llms.txt](https://ajneb97.gitbook.io/complexturrets/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajneb97.gitbook.io/complexturrets/how-to-start.md).

# How to Start

Information of the plugin to work correctly on your server.

## Requirements

**1) Spigot**

{% hint style="warning" %}
You need Spigot or Paper for the plugin to work. Don't use Craftbukkit.
{% endhint %}

**2) NBT API**

{% hint style="warning" %}
ComplexTurrets depends on NBT API to create turret items, so it's completely required.\
Link: <https://www.spigotmc.org/resources/nbt-api.7939/>
{% endhint %}

## Optional Dependencies

**1) Holograms plugin**

{% hint style="info" %}
If you want to enable information holograms above turrets, or damage holograms you will need **one** of these plugins. \
Holographic Displays: <https://dev.bukkit.org/projects/holographic-displays>\
DecentHolograms: <https://www.spigotmc.org/resources/96927/>\
FancyHolograms: <https://modrinth.com/plugin/fancyholograms>
{% endhint %}

**2) Vault and Economy plugin**

{% hint style="info" %}
You can set turrets to be upgraded using money (Vault + an Economy plugin). If so, you need this plugin.\
Link: <https://www.spigotmc.org/resources/vault.34315/>
{% endhint %}

**3) Clan/Team plugins**

{% hint style="info" %}
ComplexTurrets has support for different allies plugins. This means, if `ally_protection` is enabled in the config, turrets won't damage allies. Here is the list of compatible plugins:\
Towny: <https://www.spigotmc.org/resources/towny-advanced.72694/>\
Lands: <https://www.spigotmc.org/resources/53313/>\
Better Teams: <https://www.spigotmc.org/resources/better-teams.17129/>\
Gangs+: <https://www.spigotmc.org/resources/gangs-1-7-1-16.2604/>\
Simple Clans: <https://www.spigotmc.org/resources/simpleclans.71242/>\
SaberFactions: <https://www.spigotmc.org/resources/69771/>\
FactionsUUID: <https://www.spigotmc.org/resources/factionsuuid.1035/>\
Ultimate Clans: <https://polymart.org/resource/ultimate-clans-v5.1162>\
Kingdoms: <https://www.spigotmc.org/resources/kingdomsx.77670/>\
Medieval Factions: <https://www.spigotmc.org/resources/medieval-factions.79941/>\
Konquest: <https://www.spigotmc.org/resources/konquest.92220/>\
Residence: <https://www.spigotmc.org/resources/residence-1-7-10-up-to-1-18.11480/>\
ClansLite: <https://www.spigotmc.org/resources/clanslite-1-21-1-support.97163/>
{% endhint %}

**4) Region plugins**

{% hint style="info" %}
The `place_turrets_only_on_own_region` option also provides support for some ally plugins, including region plugins like:\
WorldGuard: <https://dev.bukkit.org/projects/worldguard>\
Towny: <https://www.spigotmc.org/resources/towny-advanced.72694/>\
Lands: <https://www.spigotmc.org/resources/53313/>\
Kingdoms: <https://www.spigotmc.org/resources/kingdomsx.77670/>\
FactionsUUID: <https://www.spigotmc.org/resources/factionsuuid.1035/>\
Konquest: <https://www.spigotmc.org/resources/konquest.92220/>
{% endhint %}

## Installation

To install the plugin on your server place the plugins ComplexTurrets and NBTAPI inside your plugins folder and start your server. Examples turret files will be generated in the **turrets** folder, you can use them as a reference or delete them.

## Placing a Turret

**1.** Use the `/ct give <turret> <player>` command to receive a Turret Block. You can use the command from the console. Remember to use a valid turret name. If there is a file called Burst.yml, then the turret name is just "Burst".

**2.** Place the Turret Block on the ground and right click it. A settings inventory will be opened associated with this turret. Here you can upgrade the turret to have better stats, add whitelisted players, enable or disable attacking entities and add ammunition.

![](https://36182188-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mad3k7lBtp2NnYSnJ6_%2F-Mad6RdJxwAp5NM5Y6vj%2F-MadAfpaEnEBA-HrGfp0%2F2021-05-26_11.56.05.png?alt=media\&token=e0be2d7e-cc93-4290-a5e0-8d31da500516)

**3.** Default turrets require ammunition to shoot so you must access the Ammunition inventory on the turret and enable the Infinite Ammo option (This item will only appear if you are an administrator or have the required permission). You can also give you ammunition by using the following command: `/ct giveammo <turret> <player> <amount>` Ammunition items are placed on the same inventory like the image below.

![](https://36182188-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mad3k7lBtp2NnYSnJ6_%2F-MadFy6t0q7yV3mr69AM%2F-MadGaSLyO9TQ0xwMbgq%2F2021-05-26_11.57.23.png?alt=media\&token=6a43673a-ecf3-486c-a853-f37d54351b0b)

**4.** Now you need to enable the turret in the previous inventory. If you want to add ammunition again, you have to disable the turret.
