> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Optimize spigot.yml in Minecraft

> Fine-tune your server's entity and item logic. Learn how to optimize entity activation ranges and merge radii within spigot.yml to maximize CPU performance.

## Deep Performance Tuning: spigot.yml

The `spigot.yml` file provides granular control over the most CPU-intensive components of the Minecraft engine: entity AI logic and item lifecycle management. Tuning these settings is an essential requirement for servers with high player populations or communities that use massive automated entity farms. By calibrating how the server "wakes up" mobs and how it aggregates dropped items, you can reclaim significant hardware resources while maintaining a high-fidelity gameplay experience.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Intermediate
  </Card>

  <Card title="Time" icon="clock">
    8 Minutes
  </Card>
</CardGroup>

***

## Strategic Optimization Variables

To improve your server's Ticks Per Second (TPS), we recommend applying the following modifications to your `spigot.yml` registry.

### 1. Entity Activation Range

This is the most impactful setting for performance. It dictates the physical distance (in blocks) a player must be from an entity for its AI logic to initialize. Entities outside this radius will remain stationary, consuming negligible CPU cycles.

* **`animals`:** Set to **`16`** (Default 32).
* **`monsters`:** Set to **`24`** (Default 32).
* **`misc`:** Set to **`8`** (Default 16).

### 2. Physical Merge Radius

The merge radius logic instructs the server to "clump" dropped items and experience orbs together into a single stack. This reduces the total number of unique entities the server must track and calculate physics for.

* **`item`:** Set to **`4.0`** (Default 2.5).
* **`exp`:** Set to **`6.0`** (Default 3.0).

***

## Technical Maintenance Registry

These settings manage the automatic purging of entities and inactive logic loops.

| Technical Variable            | Default Value | Optimized Value | Strategic Purpose                                                       |
| :---------------------------- | :-----------: | :-------------: | :---------------------------------------------------------------------- |
| **`arrow-despawn-rate`**      |     `1200`    |    **`300`**    | Reduces projectile persistence from 60 seconds to 15 seconds.           |
| **`item-despawn-rate`**       |     `6000`    |    **`4000`**   | Purges "trash" items every 3.3 minutes to reclaim world memory.         |
| **`tick-inactive-villagers`** |     `true`    |   **`false`**   | Prevents out-of-range villagers from performing expensive pathing math. |
| **`mob-spawn-range`**         |      `8`      |     **`6`**     | Restricts spawns to areas players can actually observe.                 |

***

<Note>
  ### Identifying Bottlenecks

  If you have applied these optimizations and still experience server stuttering, we recommend using the **[Spark Profiler](/games/minecraft/profiling-server-lag-with-spark)**. This tool will help you identify if a specific world region or specialized entity (such as a massive villager trading hall) is circumventing these global limits.
</Note>

***

<Note>
  ### Need Extra Help?

  If you encounter any issues, our support team is ready to assist:

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **Spigot:** Efficiency maximized.
</div>