Rental Signs

Rental Signs

Rental signs allow claim owners to rent out their claims to other players. GPExpansion handles automatic trust management, payment collection, and rental expiry.

How It Works

1. Owner places a rental sign in or near their claim
2. Renter clicks the sign to start renting
3. GPExpansion automatically grants trust to the renter
4. Payment is collected based on the configured economy type
5. Expiry removes trust and optionally restores claim from snapshot

Sign Formats

Short Format (Inside Claim)

Simple format for signs placed within the claim:

[rent]
<renewTime>
<ecoAmt>

With maximum rental duration:

[rent]
<renewTime> <maxTime>
<ecoAmt>

With explicit economy type:

[rent]
<renewTime> <maxTime>
<ecoType>
<ecoAmt>

Semicolon Format

Compact single-line format:

[rent]
<renewTime>;<ecoAmt>

With max time:

[rent]
<renewTime>;<ecoAmt>;<maxTime>

Condensed Format (Outside Claim)

For signs placed outside the claim, include the claim ID:

[rent]
<id>;<ecoAmt>;<renewTime>

Full format with economy type and max time:

[rent]
<id>;<ecoType>;<ecoAmt>;<renewTime>;<maxTime>

Line-Based Format (Outside Claim)

Traditional multi-line format:

[rent]
<claimId>
<renewal> [max]
<amount>

Parameters

Parameter	Description	Example
<renewTime>	How long each payment lasts	7d, 24h, 30m
<maxTime>	Maximum rental duration	30d, 2w
<ecoAmt>	Payment amount	100, $50
<ecoType>	Payment type	money, xp, claimblocks, items
<id>	Claim ID from /claim list	12345

Time Formats

• 30m - 30 minutes
• 24h - 24 hours
• 7d - 7 days
• 2w - 2 weeks

Economy Types

Type	Description
money	Vault economy currency (default)
xp	Experience points
claimblocks	GriefPrevention claim blocks
items	Items (configurable in config)

Setup Wizard

Use /rentclaim [claimId] for an interactive setup:

1. Run /rentclaim while standing in a claim
2. Follow the chat prompts to configure:
   • Price and duration
   • Maximum rental time
   • Payment type
   • Sign location
3. Place the sign as instructed

Managing Rentals

For Owners

Command	Description
/claim evict <player>	Evict a renter early
/claim collectrent	Collect pending rental payments

For Renters

• Click the rental sign to extend rental time
• Use /claim list to see your rented claims
• Build and manage within the claim during rental period

Sign Protection

Rental signs are protected:

• Only the claim owner can break the sign
• Only admins can break active rental signs
• Breaking a sign ends all active rentals

Permissions

Permission	Description
griefprevention.sign.create.rent	Create rental signs
griefprevention.rent	Rent claims from others
griefprevention.evict	Evict renters from your claims
griefprevention.collectrent	Collect rental payments

Configuration

signs:
  rent:
    enabled: true
    allow-renewals: true
    allow-item-payments: true
    allow-money-payments: true
    allow-claimblock-payments: true
    allow-experience-payments: true
    limits:
      max-signs: 5

Troubleshooting

Sign not working?

• Verify the sign format matches one of the supported formats
• Check player has griefprevention.sign.create.rent permission
• Ensure claim ID is correct for condensed format

Renter can't extend rental?

• Check if max rental time has been reached
• Verify renter has sufficient funds

Want to change rental terms?

• Break the existing sign (ends all rentals)
• Create a new sign with updated terms