Trust System

Trust System

GPExpansion enhances GriefPrevention's trust system with claim ID support and automatic trust management.

Overview

The trust system controls who can interact with your claim. GPExpansion adds:

• Claim ID parameter for remote trust management
• Automatic trust for renters
• Integration with rental and mailbox systems

Trust Levels

Level	Permission	Typical Use
Access	Enter, use buttons/levers	Visitors
Container	Access containers, animals	Friends
Build	Build, break, use items	Trusted players
Permission	Manage trust, change settings	Co-owners
Manager	Full claim control	Partners

Commands with ID Support

GPExpansion adds optional [claimId] to trust commands:

/claim trust <player> [claimId]
/claim untrust <player> [claimId]
/claim untrust all [claimId]
/claim accesstrust <player> [claimId]
/claim containertrust <player> [claimId]
/claim permissiontrust <player> [claimId]

Examples

Trust a player in claim 12345 while standing elsewhere:

/claim trust Steve 12345

Untrust everyone from a specific claim:

/claim untrust all 12345

Grant container access remotely:

/claim containertrust Alex 67890

Automatic Trust Management

Rental System

When a player rents your claim:

1. Start of rental - Automatic trust granted at "Build" level
2. During rental - Renter has full claim access
3. End of rental - Trust automatically revoked
4. Early eviction - Trust removed immediately

Note: You cannot manually untrust an active renter. Use /claim evict instead.

Mailbox System

For real-protocol mailboxes:

• Public container trust granted to all players
• Only for the mailbox container
• Doesn't affect other containers in claim

Trust Anywhere Permission

Use trust commands on any claim by ID:

Permission: griefprevention.trust.anywhere

Required for:

• Trusting in claims by ID
• Some remote trust operations
• Admin trust management

Restricted Subclaims

Subclaims can have different trust lists than parent claims:

/claim restrictsubclaim [claimId]

• Creates independent trust list
• Parent claim permissions don't apply
• Must manage trust separately

Trust Tracking

GPExpansion tracks trusted players in its database:

• Who was trusted
• When they were trusted
• Trust level granted
• Which claim they were trusted in

View trust history:

/claim trustlist [claimId]

Permissions

Permission	Description
griefprevention.trust	Trust players in own claims
griefprevention.trust.anywhere	Trust by claim ID
griefprevention.untrust	Untrust players
griefprevention.untrust.anywhere	Untrust by claim ID
griefprevention.accesstrust	Grant access trust
griefprevention.containertrust	Grant container trust
griefprevention.permissiontrust	Grant permission trust
griefprevention.manage.warp	Manage claim warps

Configuration

trust:
  track-changes: true
  notify-on-trust: true
  notify-on-untrust: true
  
  rental:
    trust-level: "build"
    auto-untrust: true
    
  mailbox:
    public-container-trust: true

Best Practices

1. Use appropriate levels - Don't over-trust
2. Review trust lists - Periodically check who's trusted
3. Remove inactive players - Clean up old trust entries
4. Use subclaims - For specific areas with different permissions
5. Monitor rental trust - Automatic but worth checking

Troubleshooting

Can't trust by ID?

• Need griefprevention.trust.anywhere permission
• Claim ID must be valid
• Must have permission to modify that claim

Renter still trusted after rental ended?

• Check if rental actually expired
• May need manual untrust if glitched
• Contact admin if trust persists

Trust command not working?

• Verify player name is spelled correctly
• Check trust level permission
• Ensure claim isn't a subclaim with restrictions

Migration from GriefPrevention

GPExpansion is fully compatible with GP trust data:

• Existing trusts work unchanged
• GP trust commands still function
• GPExpansion adds optional enhancements
• No data conversion needed