Skip to content

docs(limits): document the limits:exempt entity tag - #108

Merged
tastybento merged 1 commit into
masterfrom
docs/limits-exempt-entities
Sep 26, 2026
Merged

tastybento merged 1 commit into
masterfrom
docs/limits-exempt-entities

Conversation

@tastybento

Copy link
Copy Markdown
Member

Documents the entity exemption tag added in BentoBoxWorld/Limits#305 (closes BentoBoxWorld/Limits#304).

Adds a For developers: exempting entities section to the Limits page, just before the changelog. It covers:

  • how to tag an entity with limits:exempt in Paper's spawn consumer, with an example
  • what a tagged entity skips: limit checks, counting, count changes on death, removal and portals, and recounts
  • that the tag survives chunk unloads and restarts, and that Limits isn't needed as a dependency (Limits.EXEMPT_KEY is the same key)
  • a warning to tag only at spawn time

The feature isn't released yet, so the section is marked "Coming in the next release after 1.30.2". The changelog entry can be added when the release notes are written.

zensical build succeeds. The only warnings are two existing anchor warnings on the Biomes page.

🤖 Generated with Claude Code

Other plugins can spawn entities that Limits ignores by tagging them
with the persistent data key limits:exempt in the spawn consumer
(BentoBoxWorld/Limits#304, #305). Adds a developer section with an
example, what the tag does, and the rule to tag only at spawn time.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tastybento
tastybento merged commit 561ffb9 into master Sep 26, 2026
2 checks passed
@tastybento
tastybento deleted the docs/limits-exempt-entities branch September 26, 2026 14:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add an API for addons to exempt selected entities from limit enforcement and tracking

1 participant