Sign Limits

Sign Limits

Sign limits control how many GPExpansion signs players can create. Limits can be set per-claim or per-player.

Default Limits

These are the starting values in config.yml:

defaults:
  max-rent-signs-per-claim: 1
  max-mailbox-signs-per-claim: 1
  max-sell-signs-per-claim: 1
  max-self-mailboxes-per-claim: 3
  max-global-claims-per-player: -1  # -1 = unlimited

Per-Claim Limits

Most sign types are limited per claim:

Sign Type	Default	Meaning
Rental signs	1	One rental per claim
Mailbox signs	1	One purchasable mailbox per claim
Sell signs	1	One sell sign per claim
Self-mailboxes	3	Three instant mailboxes per claim

Why per-claim?

• Prevents sign spam in individual claims
• Allows multiple claims to each have signs
• Encourages claim quality over quantity

Per-Player Limits

Global claims are limited per player:

Feature	Default	Meaning
Global claims	-1	Unlimited global listings

Note: -1 means unlimited. Set to a number to limit.

Permission Overrides

Grant higher limits with permission nodes:

Syntax

griefprevention.sign.limit.<type>.<number>

Examples

Allow 5 rent signs per claim:

griefprevention.sign.limit.rent.5

Allow 10 self-mailboxes:

griefprevention.sign.limit.self-mailbox.10

Allow unlimited sell signs:

griefprevention.sign.limit.sell.-1

Sign Type Names

Use these in permission nodes:

Sign Type	Permission Name
Rental	rent
Sell	sell
Mailbox (purchasable)	mailbox
Self-Mailbox	self-mailbox
Global	global

Admin Bypass

Players with griefprevention.admin bypass all limits.

Checking Limits

For Players

Players can see their limits:

/claim limits

Shows:

• Current signs of each type
• Maximum allowed
• Remaining slots

For Admins

Check any player's limits:

/gpx max <type> check <player>

Example:

/gpx max rent check Steve

Modifying Limits

Via Config

Edit config.yml and reload:

/gpx reload

Changes apply to future signs. Existing signs remain.

Via Commands

Temporarily adjust a player's limits:

/gpx max <type> <action> <player> <amount>

Actions:

• add - Add to current limit
• take - Subtract from limit
• set - Set to specific value

Examples:

Give Steve 5 extra rent signs:

/gpx max rent add Steve 5

Reduce Alice's mailboxes by 2:

/gpx max mailbox take Alice 2

Set Bob to exactly 10 self-mailboxes:

/gpx max self-mailbox set Bob 10

Limit Behavior

What Happens When Limit Reached?

Players attempting to create signs beyond their limit see:

&cYou have reached the maximum of X rent signs for this claim.

Do Broken Signs Count?

No, broken signs free up the slot immediately.

What About Existing Signs?

• Signs placed before limit reduction remain
• New signs follow current limits
• No retroactive removal

Can Limits Be Negative?

• 0 = No signs allowed
• -1 = Unlimited signs
• Positive numbers = Specific limit

Group Limits

Set limits for permission groups in your permission plugin:

Example: LuckPerms

Default group:

/lp group default permission set griefprevention.sign.limit.rent.1
/lp group default permission set griefprevention.sign.limit.self-mailbox.3

VIP group:

/lp group vip permission set griefprevention.sign.limit.rent.5
/lp group vip permission set griefprevention.sign.limit.self-mailbox.10
/lp group vip permission set griefprevention.sign.limit.sell.3

MVP group:

/lp group mvp permission set griefprevention.sign.limit.rent.10
/lp group mvp permission set griefprevention.sign.limit.self-mailbox.25

Best Practices

Recommended Default Limits

Server Size	Rent	Self-Mailbox	Sell
Small (<50)	2	5	2
Medium (50-200)	1	3	1
Large (200+)	1	2	1

VIP Tier Suggestions

Tier	Extra Signs	Other Benefits
VIP	2-3x default	Color codes
MVP	5x default	Unlimited global
Legend	10x default	Near-unlimited

Economy Balancing

Higher limits can be a donation perk:

• Provides value without pay-to-win
• Doesn't affect core gameplay
• Encourages sign usage

Troubleshooting

Player says they can't create signs

• Check /gpx max <type> check <player>
• Verify effective permissions
• Check for conflicting negative permissions

Limits not applying?

• Permission nodes must be exact
• Check permission plugin inheritance
• Verify no wildcard conflicts

Too many signs causing lag?

• Lower default limits
• Audit existing signs with /gpx logs signs
• Consider per-region limits

Configuration Reference

defaults:
  # These apply if no permission override
  max-rent-signs-per-claim: 1
  max-mailbox-signs-per-claim: 1
  max-sell-signs-per-claim: 1
  max-self-mailboxes-per-claim: 3
  max-global-claims-per-player: -1

Permission priorities:

1. Admin bypass (griefprevention.admin)
2. Specific number permission (griefprevention.sign.limit.rent.5)
3. Config defaults