26
Step 1: Gather Performance Data from Your Server
Birdflop does not scan your server directly; instead, it analyzes performance reports generated by your server. It is highly recommended to uúe spark, as it provides the most detailed and modern profiling.
Method A: Using the Spark Plugin (Recommended)
1. Install the spark plugin on your server (supports Paper, Purpur, Fabric, etc.).
2. Wait for a high-player-count period or when the server is actively lagging (TPS dropping).
3. Run the following command in the console or in-game: /spark profiler --timeout 300 (This monitors server performance for 5 minutes).
4. Once completed, Spark will generate a link formatted like [https://spark.lucko.me/XXXXXX](https://spark.lucko.me/XXXXXX). Copy this link.
Method B: Using Paper Timings (For older versions)
1. Ensure Timings is turned on by running /timings on.
2. Let the server run during a lag spike for 10–15 minutes, then run: /timings paste.
3. Copy the generated link ([https://timings.aikar.co/?id=](https://timings.aikar.co/?id=)...).
Step 2: Input the Link into the Birdflop Analyzer
Once you have the report link, you can analyze it using one of two
Method 1: Via the Birdflop Web Tools
1. Go to the Birdflop resource page: birdflop.com/resources.
2. Select either “Spark Profile Analyzer” or “Paper Timings Analyzer” depending on the tool you used.
3. Paste your link into the text field and click “Analyze”.
Method 2: Via the Botflop Discord Bot
If you are in the Birdflop Discord server or have invited the **Botflop** bot to your own staff server:
* Simply paste the Spark or Timings link directly into the chat channel. The bot will instantly analyze it and reply with a list of optimization suggestions.
Step 3: Interpret Results & Fix the Lag
Birdflop will categorize its findings by severity: “Critical”, “High”, “Medium”, and “Loơ”. Here are the most common issues flagged by the tool and how to fix them:
1. Misconfigured Server Files
Birdflop compares your current settings (paper-world-defaults.yml, purpur.yml, spigot.yml) against community-tested optimization standards.
The fix: The analyzer explicitly states which line in which file needs adjustments.
Example: It might suggest lowering entity-activation-range from 32 to 24 or reducing the simulation-distance. Open your server files, locate those lines, change the values, and save.
2. Heavy Resource-Hogging Plugins
Under the CPU profiling section, Birdflop will pinpoint exactly which plugin is consuming too much processing time per tick (if tick duration exceeds “50ms”, the server drops TPS).
The Fix:
* Optimize the plugin's internal config (e.g., increase task intervals, decrease scan radius).
* Update the plugin to its latest version.
* If it remains unoptimized, look for a lightweight alternative that performs the same function.
3. Garbage Collection (GC) & Memory Issues
If the analysis shows constant red spikes in Garbage Collection, it means the server's Java process is pausing frequently to clear out memory, causing micro-stutters.
The fix: Use Birdflop's built-in **Flags Generator** on their website. Input your allocated server RAM, and it will generate an optimized set of “Aikar's Flags”. Copy and paste these flags into your server startup script/panel flags.
4. Excessive Entities or Tile Entities
The analyzer will warn you if the number of mobs, dropped items, or complex blocks (like Hoppers and Chests) is overloading the server.
The fix:
* Implement hopper-limiting or mob-stacking features if necessary.
* Use the /spark tickmonitoring command in-game to track down the exact coordinates/chunks causing the lag spikes and inspect them manually.
Admin tips:
“Dont - Over-Optimize”: You do not need to change every single value to the absolute minimum. Focus strictly on resolving the “Critical” and “High” warnings first to preserve the vanilla gameplay experience.
Vertify the results: After applying changes and restarting the server, let it run for a while, generate a brand-new Spark profile, and compare it to the old one to verify that your TPS has stabilized.
https://www.birdflop.com/resources/analyze
Birdflop does not scan your server directly; instead, it analyzes performance reports generated by your server. It is highly recommended to uúe spark, as it provides the most detailed and modern profiling.
Method A: Using the Spark Plugin (Recommended)
1. Install the spark plugin on your server (supports Paper, Purpur, Fabric, etc.).
2. Wait for a high-player-count period or when the server is actively lagging (TPS dropping).
3. Run the following command in the console or in-game: /spark profiler --timeout 300 (This monitors server performance for 5 minutes).
4. Once completed, Spark will generate a link formatted like [https://spark.lucko.me/XXXXXX](https://spark.lucko.me/XXXXXX). Copy this link.
Method B: Using Paper Timings (For older versions)
1. Ensure Timings is turned on by running /timings on.
2. Let the server run during a lag spike for 10–15 minutes, then run: /timings paste.
3. Copy the generated link ([https://timings.aikar.co/?id=](https://timings.aikar.co/?id=)...).
Step 2: Input the Link into the Birdflop Analyzer
Once you have the report link, you can analyze it using one of two
Method 1: Via the Birdflop Web Tools
1. Go to the Birdflop resource page: birdflop.com/resources.
2. Select either “Spark Profile Analyzer” or “Paper Timings Analyzer” depending on the tool you used.
3. Paste your link into the text field and click “Analyze”.
Method 2: Via the Botflop Discord Bot
If you are in the Birdflop Discord server or have invited the **Botflop** bot to your own staff server:
* Simply paste the Spark or Timings link directly into the chat channel. The bot will instantly analyze it and reply with a list of optimization suggestions.
Step 3: Interpret Results & Fix the Lag
Birdflop will categorize its findings by severity: “Critical”, “High”, “Medium”, and “Loơ”. Here are the most common issues flagged by the tool and how to fix them:
1. Misconfigured Server Files
Birdflop compares your current settings (paper-world-defaults.yml, purpur.yml, spigot.yml) against community-tested optimization standards.
The fix: The analyzer explicitly states which line in which file needs adjustments.
Example: It might suggest lowering entity-activation-range from 32 to 24 or reducing the simulation-distance. Open your server files, locate those lines, change the values, and save.
2. Heavy Resource-Hogging Plugins
Under the CPU profiling section, Birdflop will pinpoint exactly which plugin is consuming too much processing time per tick (if tick duration exceeds “50ms”, the server drops TPS).
The Fix:
* Optimize the plugin's internal config (e.g., increase task intervals, decrease scan radius).
* Update the plugin to its latest version.
* If it remains unoptimized, look for a lightweight alternative that performs the same function.
3. Garbage Collection (GC) & Memory Issues
If the analysis shows constant red spikes in Garbage Collection, it means the server's Java process is pausing frequently to clear out memory, causing micro-stutters.
The fix: Use Birdflop's built-in **Flags Generator** on their website. Input your allocated server RAM, and it will generate an optimized set of “Aikar's Flags”. Copy and paste these flags into your server startup script/panel flags.
4. Excessive Entities or Tile Entities
The analyzer will warn you if the number of mobs, dropped items, or complex blocks (like Hoppers and Chests) is overloading the server.
The fix:
* Implement hopper-limiting or mob-stacking features if necessary.
* Use the /spark tickmonitoring command in-game to track down the exact coordinates/chunks causing the lag spikes and inspect them manually.
Admin tips:
“Dont - Over-Optimize”: You do not need to change every single value to the absolute minimum. Focus strictly on resolving the “Critical” and “High” warnings first to preserve the vanilla gameplay experience.
Vertify the results: After applying changes and restarting the server, let it run for a while, generate a brand-new Spark profile, and compare it to the old one to verify that your TPS has stabilized.
https://www.birdflop.com/resources/analyze