Skip to content

MagicCobblestoneGenerator: explain where exhaustion period and cooldown are set - #136

Merged
tastybento merged 1 commit into
masterfrom
docs/mcg-exhaustion-cooldown
Nov 17, 2026
Merged

tastybento merged 1 commit into
masterfrom
docs/mcg-exhaustion-cooldown

Conversation

@tastybento

Copy link
Copy Markdown
Member

Summary

A server admin asked on Discord how to change the generator exhaustion cooldown. The Exhaustion Limit button in the GUI only sets the block count, and the docs didn't say where the period and cooldown are set.

Changes to the Generator exhaustion (rate limiting) section:

  • Where the settings live: a table showing which setting is in config.yml, which is in the GUI/template, and which are global only, plus the file path and a YAML example.
  • How it works: the steps as the code runs them (StoneGeneratorManager.canGenerateBlock), including that the count only resets when the period ends, so a cooldown shorter than the period doesn't end the pause early. Adds a worked example and the two status placeholders.
  • Per-tier limit: how to set it in the GUI and the template, and what -1, 0 and a positive number mean.
  • Fixed notification-cooldown wording: it's limited per island and generator, not per player.

Test plan

  • mkdocs build passes

🤖 Generated with Claude Code

…down are set

Admins could not find how to change the exhaustion cooldown: the GUI
button only sets the block limit. Add a table showing which setting
lives where, the config.yml path and YAML example, a step-by-step
description of how period and cooldown interact (the generator stays
stopped until both the cooldown and the period are over), and the
per-tier limit values. Fix notification-cooldown wording (per island
and generator, not per player).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.

1 participant