# How to Start

## 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.

![](/files/-MadAfpaEnEBA-HrGfp0)

**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.

![](/files/-MadGaSLyO9TQ0xwMbgq)

**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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajneb97.gitbook.io/complexturrets/how-to-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
