PaperMC Despawned Items/io.fairyfox.papermc.despawneditems.throttle

Package-level declarations

Types

What the throttler decided to do with one despawning item.

class ThrottleManager(settingsSupplier: () -> ThrottleSettings, onlineLookup: (UUID) -> Player? = { null }, clock: () -> Long = System::currentTimeMillis)

Per-actor throttling of the despawn pipeline.

data class ThrottleQuota(val ratePerWindow: Int, val maxConcurrent: Int, val weight: Int, val bypass: Boolean = false)

The resolved per-actor allowance. One immutable snapshot of "how much of the despawn pipeline is this player entitled to right now".

Resolves a ThrottleQuota from permissions, mirroring the precedence io.fairyfox.papermc.despawneditems.limit.DespawnLimits already uses for location caps so admins only have to learn one pattern:

class TokenBucket(val capacity: Int, val windowMillis: Long, startMillis: Long = 0)

A classic token bucket: capacity tokens that refill smoothly over windowMillis.