Skip to content

Add HYBRID option to 'despawn-range-shape' - #14494

Open
CatTeaA wants to merge 2 commits into
PaperMC:mainfrom
CatTeaA:Despawn_HYBRID
Open

CatTeaA wants to merge 2 commits into
PaperMC:mainfrom
CatTeaA:Despawn_HYBRID

Conversation

@CatTeaA

@CatTeaA CatTeaA commented Nov 17, 2026 •

Copy link
Copy Markdown

HYBRID combines the vanilla ellipsoid despawn range with a configurable cube range.

Entities inside both ranges are considered within the Despawn Radius; entities outside either range are considered in Immediate Despawn.

Some servers lower horizontal to fix the issue where mobs outside the simulation distance do not despawn.
However, this introduces two problems:

ELLIPSOID: Lowering horizontal makes the top and bottom of the ellipsoid increasingly sharp, reducing the effective spawning area when AFKing at high altitudes.

CYLINDER: The top and bottom of the cylindrical despawn range can differ significantly from the vanilla 128-block ellipsoid, potentially allowing mobs outside the vanilla range to avoid immediate despawning.

HYBRID: Addresses both issues by combining the configurable cube range with the vanilla 128-block ellipsoid as a dual check.

When horizontal is lowered, vertical remains at its default value. A mob is considered within the Despawn Radius only when it is inside both ranges.

Because simulation chunks are loaded as entire chunks, this approach provides an effective spawning area closer to vanilla in the common scenario where players AFK above mob farms.

Red: ELLIPSOID-> horizontal: 80/vertical: default
Green: ELLIPSOID-> vanilla(horizontal: default/vertical: default)
↓↓↓
2026-11-18_09 21 37

HYBRID -> horizontal: 80 / vertical: default
The intersection of the green and blue ranges represents the valid Despawn Radius.
↓↓↓

2026-11-18_09 21 55 QQ_1794968180590

↑↑↑
Gray: Simulation Distance Loading Range

@CatTeaA
CatTeaA requested a review from a team as a code owner November 17, 2026 08:50
@github-project-automation github-project-automation Bot moved this to Awaiting review in Paper PR Queue Nov 17, 2026
@CatTeaA
CatTeaA marked this pull request as draft November 17, 2026 21:09
- Because chunks are loaded as whole units, a cube is more suitable than a cylinder
@CatTeaA
CatTeaA marked this pull request as ready for review November 18, 2026 01:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Awaiting review

Development

Successfully merging this pull request may close these issues.

1 participant