Admin Commands

Admin Commands

GPExpansion provides powerful administrative commands for server management.

GPX Command (/gpx)

Main admin command for GPExpansion management.

Subcommands

Command	Description
/gpx reload	Reload configuration and language files
/gpx debug	Toggle debug logging mode
/gpx max <type> <action> <player> <amount>	Modify player sign limits
/gpx accruals <action>	Check and modify claim block accrual profiles

Reload Command

/gpx reload

• Reloads config.yml
• Reloads lang.yml
• Re-initializes economy hooks
• Clears caches

Permission: griefprevention.admin

Debug Command

/gpx debug

Toggles debug logging:

• Sign activation details
• Economy transaction logs
• Trust change tracking
• Error stack traces

Permission: griefprevention.admin

Max Command

Modify player sign creation limits:

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

Types:

• sell - Sell sign limits
• rent - Rental sign limits
• mailbox - Purchasable mailbox limits
• self-mailboxes - Self-mailbox limits
• globals - Global claim limits

Actions:

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

Examples:

/gpx max sell add Steve 5
/gpx max rent take Alice 2
/gpx max mailbox set Bob 10
/gpx max self-mailboxes add AllPlayers 3

Permission: griefprevention.admin

Accruals Command

Manage claim block accrual profiles, claim block caps, claim count caps, and per-player overrides:

/gpx accruals check [player]
/gpx accruals group <group> set|add|remove <per-hour|max-blocks|max-claims|all> <amount>
/gpx accruals player <name> set|add|remove|reset <per-hour|max-blocks|max-claims|all> [amount]
/gpx accruals creategroup <name> [blocks-per-hour] [max-blocks] [max-claims] [permission]
/gpx accruals deletegroup <name>

Examples:

/gpx accruals check Steve
/gpx accruals group vip set max-claims 10
/gpx accruals player Steve set per-hour 30
/gpx accruals player Steve reset all
/gpx accruals creategroup elite 50 * 20

Permission: griefprevention.admin

See Claim Block Accruals for the full configuration and matching rules.

Claim Management Commands

Admin Claim List

/claim adminlist
/adminclaimlist
/adminclaimslist

Lists all claims on the server with:

• Owner name
• Claim ID
• Location
• Size
• Coordinates

Permission: griefprevention.admin

View Other Players' Claims

/claim list <player>

View claims for any player.

Permission: griefprevention.claim.list.other

Modify Any Claim

Most /claim subcommands support claim IDs for remote management:

/claim name "Admin Edited" 12345
/claim global true 12345
/claim setspawn 12345
/claim ban PlayerName 12345

Permission: griefprevention.admin or specific .other permissions

Snapshot Commands

Manage rental restoration snapshots:

Create Snapshot

/claim snapshot create [claimId]

Saves current claim state for later restoration.

List Snapshots

/claim snapshot list [claimId]
/claim snapshot list all

View snapshots for a claim or all claims.

Remove Snapshot

/claim snapshot remove <snapshotId>

Delete a specific snapshot by ID.

Permission: griefprevention.restoresnapshot

Sign Administration

Break Protected Signs

Admins can break any GPExpansion sign:

• Rental signs with active rentals
• Mailbox signs
• Sell signs

Permission: griefprevention.sign.admin.break or griefprevention.admin

Override Limits

Admins bypass all sign limits:

• No per-claim limits
• No global player limits
• Unlimited signs of all types

Global Claim Moderation

Approve Global Claims

If approval is required in config:

/claim global approve <claimId>
/claim global deny <claimId>

Permission: griefprevention.global.approval

Player Limit Management

Check Current Limits

/gpx max <type> check <player>

Shows current effective limits for a player.

Bulk Operations

Set limits for all players with a permission:

/gpx max rent set %group.vip% 5

Data Management

Import/Export

/gpx export <format>
/gpx import <file>

Export claim data to various formats or import from backups.

Database Operations

/gpx db migrate <target>
/gpx db backup
/gpx db verify

Manage data storage and migration.

Debugging Tools

Check Sign Data

/gpx debug sign <location>

View detailed information about a sign at specific coordinates.

Verify Claim Data

/gpx debug claim <claimId>

Display internal claim data and GPExpansion metadata.

Test Economy

/gpx debug economy <player> <amount>

Test economy transactions without actual money changes.

Log Commands

View Sign History

/gpx logs signs [player] [timeframe]

View sign creation/break history.

View Rental History

/gpx logs rentals [claimId] [timeframe]

View rental start/end history.

View Mailbox History

/gpx logs mailboxes [claimId] [timeframe]

View mailbox deposit history.

Emergency Commands

Force End Rental

/claim evict <player> <claimId> --force

Immediately end a rental without refunds.

Force Transfer Claim

/claim transfer <player> <claimId> --force

Transfer ownership immediately.

Clear All Signs

/gpx clear signs <claimId> [type]

Remove all GPExpansion signs from a claim.

Tab Completion

All admin commands support tab completion:

• Player names
• Claim IDs
• Valid types and actions
• File paths

Audit Trail

GPExpansion logs admin actions to:

• Console
• Log file (plugins/GPExpansion/logs/admin.log)
• Database (if enabled)

Logged events:

• Sign limit changes
• Snapshot operations
• Claim modifications
• Debug mode toggles

Best Practices

1. Test in staging - Try commands on test server first
2. Make backups - Before bulk operations
3. Use claim IDs - Avoid ambiguity with player names
4. Check permissions - Verify effective permissions with debug
5. Log actions - Enable audit logging for accountability