Skip to content

Documentation Improvement: Clarify Entity Activation Range Effects #713

@JoField08

Description

@JoField08

💡 Summary and Context

While troubleshooting item lag and rubber-banding behavior during water transport on a Paper server, the root cause was identified as the entity-activation-range configuration - specifically for miscellaneous entities (items). Although the configuration works as intended, the current documentation is unclear for users who are not already familiar with Paper's internal mechanics, making it difficult to understand the impact of this setting and diagnose related issues.

For reference: https://discord.com/channels/289587909051416579/289587909051416579/1458912177921724580

✨ Core Features / Desired Solution

  • Improve the documentation description for entity-activation-range.
  • Clearly explain that item entities (e.g., dropped items in water streams) are affected by activation range and may tick at slower rates when outside player proximity.
  • May describe how reduced tick rates can cause visual rubber-banding, lag, or apparent "backward teleportation" of items.
  • Provide clear guidance on disabling the feature (e.g., setting values to 0) and what that implies.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions