> For the complete documentation index, see [llms.txt](https://wiki.halosdev.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.halosdev.com/halos-player-spoofer/setup-guide/spigot-plugin-configurations.md).

# Spigot Plugin Configurations

## Step 1 - Configure Security Features

First thing that I highly recommend that you do to keep the plugin hidden is change the plugins details. The configuration option can be found in the config.yml . 

```yaml
plugin_info: # Modify plugin information
  name: "HalosPlayerSpoof" # Name that appears when using /plugins
  authors: [ "HalosDev" ] # Author that appears when using /version
  version: "1.0.0" # Version that appears when using /version
  command_proxy: "spoof" # Change the name of the main plugin command
```

## Step 2 - Configure Fluctuation. (Skip if running Velocity/Bungeecord)

Fluctuation will be the backbone to how the plugin works and spoofs your player counts. The configuration config may be a little tricky to get correct for your server. 

```yaml
provider:
  # Available types: NAMEMC, LOCAL
  type: NAMEMC
  # This URL is ONLY relevant if your using namemc account generator.
  url: https://api.namemc.com/server/mc.hypixel.net/likes
min-delay: 5
max-delay: 30
max-fake: 50
# Define how many real players need to be online before fluctuation will start.
# If set to -1 it will always run.
min-real-players: -1
# Customize LifeSpan.
# How long a fake player will stay on the server before leaving.
# Numbers are in mins here.
min-lifespan: 5
max-lifespan: 10
```

This field is very important. This will control min and max of spoof players on your server. The percentages will fluctuate in between and will not go under or over.

```yaml
max-fake: 50
```

This setting will determine at what real player count will flucation turn on. If you have a smaller server I suggest you do 1-5. Bigger servers you can do more. 

```yaml
min-real-players: -1
```

## Step 3 - Configure Ping Module

Setting the ping will make your spoof players look more legit when looked at from the tab list. So it is make sure you set them correctly. 

```yaml
  ping:
    enabled: true
    settings:
      delay-min: 10
      delay-max: 25
      ping-min: 50
      ping-max: 150
```

## Step 4 - Configure Ranks Module

The ranks module is a very important module to have configured. So that spoofed players will have ranks to match the real players on your server.

```yaml
enabled: true
min-delay: 30
max-delay: 60
persistent-ranks: true
ranks:
  default: 100
```

If you have a Minecraft network, we recommend going to the next page and learn how to setup our Network sync option.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://wiki.halosdev.com/halos-player-spoofer/setup-guide/spigot-plugin-configurations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.