Dynamic Performance

Quick rating

Dynamic Performance

No reviews yet

A lightweight performance mod that keeps gameplay close to vanilla with adaptive view distance, simulation distance, and mob cap based on the server’s MSPT.

Performance & Optimization
Mod Loaders
NeoForge
Fabric
Quilt
Minecraft
26.2
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.
Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

CurseForge logo CurseForge Modrinth logo Modrinth

Compatibility

Supported Environments

Dev Environment
Client Unsupported
Server Required

About

Project Details

Type
Mod
License
GNU Lesser General Public License v3.0 or later
Latest Version
Dynamic Performance 0.2.0+26.1 NeoForge
Authors
CurseForge
Modrinth

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

Dynamic Performance

A lightweight performance mod that keeps gameplay close to vanilla with adaptive view distance, simulation distance, and mob cap based on the server's MSPT.

Ideal for server owners who want to stay close to vanilla while still having great server performance without disabling gameplay features, forcing restarts, or constantly changing settings by hand.

Why use this mod?

  1. Automatic lag reduction: Dynamically lowers simulation distance, view distance, and mob caps when needed to keep the server from lagging.
  2. Server-friendly scaling: Uses configurable performance levels, allowing you to control exactly what gets reduced first and how far it may go.
  3. Lightweight and passive: Only checks performance on a configurable interval instead of running heavy logic every tick.
  4. Flexible and Compatible: Works on dedicated servers, in singleplayer, and larger Fabric or NeoForge modded setups.
  5. Visible Performance Controls: Includes in-game commands for checking the current optimization state, reviewing the active config, and reloading config changes.

TL;DR: Keeps your server vanilla and feeling responsive, even during busy moments.

How it works

Dynamic Performance watches the server's average tick time in milliseconds per tick (MSPT). A healthy Minecraft server targets 20 TPS, which means each tick should stay below 50 ms.

When the configured lag threshold is reached, the mod starts with the first available performance level and continues further through the list if more reductions are needed. When the server has recovered below the recovery threshold, it scales settings back up in reverse order.

If the MSPT stays between the lag and recovery thresholds, no scaling changes are made. At that point, the server is considered stable. See the Performance States section for more details.

The scaling order can be set in the configuration file, which is covered in the Configuration section.

Installation

After adding mod to your world or server, you should be able to open the about panel, which is fully controllable with the mouse:

/dp about

or

/dynamicperformance about

about_panel

Status

The current performance state, MSPT, view distance, simulation distance, and mob cap percentage can be checked with:

/dp status

or

/dynamicperformance status

status_panel

Performance States

The following performance states get reported:

  • Optimal: Server performance is healthy and all configured levels are restored.
  • Stable: Server performance is between the recovery and lag thresholds.
  • Scaling Down: Server MSPT is high and settings can still be reduced.
  • Lagging: Server MSPT is high, but all configured levels are already at their minimum values.
  • Scaling Up: Server performance has recovered and settings can be restored.

Configuration

A config file is created at:

./config/dynamic-performance.json

Default contents:

{
  "interval": 15,
  "lag_threshold": 45.0,
  "recovery_threshold": 30.0,
  "levels": [
    {
      "type": "SIMULATION_DISTANCE",
      "max": 16,
      "min": 8,
      "increment": 1
    },
    {
      "type": "MOB_CAP_PERCENTAGE",
      "max": 100,
      "min": 75,
      "increment": 5
    },
    {
      "type": "SIMULATION_DISTANCE",
      "max": 8,
      "min": 5,
      "increment": 1
    },
    {
      "type": "MOB_CAP_PERCENTAGE",
      "max": 75,
      "min": 30,
      "increment": 15
    },
    {
      "type": "VIEW_DISTANCE",
      "max": 20,
      "min": 4,
      "increment": 2
    }
  ]
}

This config keeps the most visible change, view distance, as the last fallback while reducing server-side load earlier through simulation distance and mob spawning.

Options

  • interval: How often, in seconds, the server performance is checked and adjusted.
  • lag_threshold: MSPT value at which scaling down starts.
  • recovery_threshold: MSPT value at or below which scaling back up starts.
  • levels: Ordered scaling rules for view distance, simulation distance, and mob cap percentage.

Level Types

Supported level types:

  • VIEW_DISTANCE: Adjusts the server view distance.
  • SIMULATION_DISTANCE: Adjusts the server simulation distance.
  • MOB_CAP_PERCENTAGE: Adjusts the mob cap as a percentage of vanilla mob caps.

Each level has:

  • max: Highest value the mod may restore this setting to.
  • min: Lowest value the mod may reduce this setting to.
  • increment: Step size used when scaling up or down.

The order matters. Scaling down follows the list from top to bottom, while scaling back up follows it from bottom to top.

Active Configuration

The active configuration can be reviewed in-game with:

/dp config

or

/dynamicperformance config

config_panel

The screenshot shows the default config listed above.

Reload

After editing the config file, apply changes without restarting by running:

/dp reload

or

/dynamicperformance reload

If the config is invalid, the command reports the error and keeps the previous valid config active.

Contributing & Issues

I warmly welcome:

  • Bug reports
  • Feature requests
  • Pull requests

Please open issues or PRs on GitHub.

License

This project is licensed under the LGPLv3 License. See LICENSE for details.

Dynamic Performance

A lightweight performance mod that keeps gameplay close to vanilla with adaptive view distance, simulation distance, and mob cap based on the server's MSPT.

Ideal for server owners who want to stay close to vanilla while still having great server performance without disabling gameplay features, forcing restarts, or constantly changing settings by hand.

Why use this mod?

  1. Automatic lag reduction: Dynamically lowers simulation distance, view distance, and mob caps when needed to keep the server from lagging.
  2. Server-friendly scaling: Uses configurable performance levels, allowing you to control exactly what gets reduced first and how far it may go.
  3. Lightweight and passive: Only checks performance on a configurable interval instead of running heavy logic every tick.
  4. Flexible and Compatible: Works on dedicated servers, in singleplayer, and larger Fabric or NeoForge modded setups.
  5. Visible Performance Controls: Includes in-game commands for checking the current optimization state, reviewing the active config, and reloading config changes.

TL;DR: Keeps your server vanilla and feeling responsive, even during busy moments.

How it works

Dynamic Performance watches the server's average tick time in milliseconds per tick (MSPT). A healthy Minecraft server targets 20 TPS, which means each tick should stay below 50 ms.

When the configured lag threshold is reached, the mod starts with the first available performance level and continues further through the list if more reductions are needed. When the server has recovered below the recovery threshold, it scales settings back up in reverse order.

If the MSPT stays between the lag and recovery thresholds, no scaling changes are made. At that point, the server is considered stable. See the Performance States section for more details.

The scaling order can be set in the configuration file, which is covered in the Configuration section.

Installation

After adding mod to your world or server, you should be able to open the about panel, which is fully controllable with the mouse:

/dp about

or

/dynamicperformance about

about_panel

Status

The current performance state, MSPT, view distance, simulation distance, and mob cap percentage can be checked with:

/dp status

or

/dynamicperformance status

status_panel

Performance States

The following performance states get reported:

  • Optimal: Server performance is healthy and all configured levels are restored.
  • Stable: Server performance is between the recovery and lag thresholds.
  • Scaling Down: Server MSPT is high and settings can still be reduced.
  • Lagging: Server MSPT is high, but all configured levels are already at their minimum values.
  • Scaling Up: Server performance has recovered and settings can be restored.

Configuration

A config file is created at:

./config/dynamic-performance.json

Default contents:

{
  "interval": 15,
  "lag_threshold": 45.0,
  "recovery_threshold": 30.0,
  "levels": [
    {
      "type": "SIMULATION_DISTANCE",
      "max": 16,
      "min": 8,
      "increment": 1
    },
    {
      "type": "MOB_CAP_PERCENTAGE",
      "max": 100,
      "min": 75,
      "increment": 5
    },
    {
      "type": "SIMULATION_DISTANCE",
      "max": 8,
      "min": 5,
      "increment": 1
    },
    {
      "type": "MOB_CAP_PERCENTAGE",
      "max": 75,
      "min": 30,
      "increment": 15
    },
    {
      "type": "VIEW_DISTANCE",
      "max": 20,
      "min": 4,
      "increment": 2
    }
  ]
}

This config keeps the most visible change, view distance, as the last fallback while reducing server-side load earlier through simulation distance and mob spawning.

Options

  • interval: How often, in seconds, the server performance is checked and adjusted.
  • lag_threshold: MSPT value at which scaling down starts.
  • recovery_threshold: MSPT value at or below which scaling back up starts.
  • levels: Ordered scaling rules for view distance, simulation distance, and mob cap percentage.

Level Types

Supported level types:

  • VIEW_DISTANCE: Adjusts the server view distance.
  • SIMULATION_DISTANCE: Adjusts the server simulation distance.
  • MOB_CAP_PERCENTAGE: Adjusts the mob cap as a percentage of vanilla mob caps.

Each level has:

  • max: Highest value the mod may restore this setting to.
  • min: Lowest value the mod may reduce this setting to.
  • increment: Step size used when scaling up or down.

The order matters. Scaling down follows the list from top to bottom, while scaling back up follows it from bottom to top.

Active Configuration

The active configuration can be reviewed in-game with:

/dp config

or

/dynamicperformance config

config_panel

The screenshot shows the default config listed above.

Reload

After editing the config file, apply changes without restarting by running:

/dp reload

or

/dynamicperformance reload

If the config is invalid, the command reports the error and keeps the previous valid config active.

Contributing & Issues

I warmly welcome:

  • Bug reports
  • Feature requests
  • Pull requests

Please open issues or PRs on GitHub.

License

This project is licensed under the LGPLv3 License. See LICENSE for details.

Screenshots

Gallery

  • About Panel Message
    About Panel Message About Panel Message
  • Status Panel Message
    Status Panel Message Status Panel Message
  • Config Panel Message
    Config Panel Message Config Panel Message
  • About Panel Message
    About Panel Message
  • Status Panel Message
    Status Panel Message
  • Config Panel Message
    Config Panel Message

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Total Downloads
CurseForge
<1,000
Modrinth
<1,000
Last Updated
CurseForge
Modrinth
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works