Add Flag.Builder minimumRank API

[tastybento]

Summary

• New Flag.Builder.minimumRank(int) lets addons declare the lowest rank that may be selected for a PROTECTION flag (default VISITOR_RANK, so fully backwards-compatible).
• The auto-assigned CycleClick listener is now constructed with the configured minimum, so the click-cycle in the settings panel will not let players select ranks below it (e.g. set minimumRank(MEMBER_RANK) to restrict a flag to Member/Sub-owner/Owner).
• build() clamps defaultRank up to minimumRank (with a logged warning) so a misconfigured flag still has a selectable default.
• Adds Flag.getMinimumRank() and Flag.getClickHandler() getters.

Test plan

• ./gradlew test --tests "world.bentobox.bentobox.api.flags.*" — all green
• New unit tests in FlagTest:
  • default minimumRank is VISITOR_RANK
  • Builder.minimumRank(MEMBER_RANK) is reflected on the built flag
  • the auto-assigned CycleClick carries the configured minimum (verified via reflection on the listener's minRank field)
  • defaultRank below minimumRank is clamped up

Notes

• No changes to CycleClick — the existing two-arg constructor and rank-bound enforcement in leftClick/rightClick already handle this; the Builder just exposes it.
• Binary-compatible: only additive methods, no signature or return-type changes.

🤖 Generated with Claude Code

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud