GriefPrevention

https://docs.griefprevention.com
Admin
GriefPrevention is a Minecraft server plugin that automatically prevents grief and protects player...
Tokens:8,359
Snippets:107
Trust Score:6.8
Update:6 months ago
Show doc for...
Tokens:
Raw
### Database URL Example

Source: https://docs.griefprevention.com/configuration

This is an example of a standard Java database connectivity URL. The last part of the URL is the database name, which must be created manually.

```sql
jdbc:mysql://localhost:3306/gpdata
```

--------------------------------

### Define MinimumY Overrides

Source: https://docs.griefprevention.com/configuration

Example configuration for setting world-specific minimum claim depths.

```yaml
Claims:
  MinimumY: 16
  MinimumYOverrides:
    world_nether: 127
    creative_world: -2147483648
```

--------------------------------

### Create Database Command

Source: https://docs.griefprevention.com/configuration

This is a MySQL command to create a new database. Ensure you have the necessary permissions to execute this command.

```sql
create database mydatabase;
```

--------------------------------

### Configure Claim Limits and Dimensions

Source: https://docs.griefprevention.com/configuration

Individual configuration variables for defining initial blocks, accrual rates, and claim size constraints.

```yaml
Claims.InitialBlocks: 100
```

```yaml
Claims.BlocksAccruedPerHour: 100
```

```yaml
Claims.MaxAccruedBlocks: 80000
```

```yaml
MaximumNumberOfClaimsPerPlayer: 0
```

```yaml
Claims.AutomaticNewPlayerClaimsRadius: 4
```

```yaml
Claims.ExtendIntoGroundDistance: 5
```

```yaml
Claims.MinimumY: -2147483648
```

```yaml
Claims.MinimumYOverrides
```

```yaml
Claims.MinimumWidth: 5 and Claims.MinimumArea: 100
```

--------------------------------

### Configure Maven Repository for JitPack

Source: https://docs.griefprevention.com/api

Add the JitPack repository to your pom.xml to enable fetching dependencies from GitHub repositories.

```xml
	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>
```

--------------------------------

### Player Commands

Source: https://docs.griefprevention.com/commands

Commands available to regular players for managing their claims and interactions.

```APIDOC
## Player Commands

All of the permissions below start with ‘griefprevention.’. For example, ‘restorenature’ is ‘griefprevention.restorenature’. See the full list of permissions for more details.

### /AbandonClaim

**Description:** Deletes the claim you’re standing in.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /ClaimExplosions

**Description:** Toggles if explosions are allowed in the claim.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /Trust

**Description:** Gives another player permission to edit in your claim.

**Alias:** /t

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /UnTrust

**Description:** Revokes any permissions granted to a player in your claim.

**Alias:** /ut

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /AccessTrust

**Description:** Gives a player permission to use your buttons, levers, and beds.

**Alias:** /at

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /ContainerTrust

**Description:** Gives a player permission to use your buttons, levers, beds, crafting gear, containers, and animals.

**Alias:** /ct

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /TrustList

**Description:** Lists the permissions for the claim you’re standing in.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /SubdivideClaims

**Description:** Switches your shovel to subdivision mode, so you can subdivide your claims.

**Alias:** /sc

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /RestrictSubclaim

**Description:** Restricts a subclaim, so that it inherits no permissions from the parent claim.

**Alias:** /rsc

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /BasicClaims

**Description:** Puts your shovel back in basic claims mode.

**Alias:** /bc

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /PermissionTrust

**Description:** Grants a player permission to share his permission level with others.

**Alias:** /pt

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /Untrust All

**Description:** Removes all permissions for all players in your claim.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /AbandonAllClaims

**Description:** Deletes all of your claims.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /BuyClaimBlocks

**Description:** Converts server money to claim blocks.

**Alias:** /BuyClaim

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** buysellclaimblocks

### /SellClaimBlocks

**Description:** Converts claim blocks to server money.

**Alias:** /SellClaim

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** buysellclaimblocks

### /GivePet

**Description:** Gives away a tamed animal.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** givepet

### /ClaimsList

**Description:** Lists a player’s claims and claim block details.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claims

### /IgnorePlayer

**Description:** Ignores a target player’s chat messages.

**Alias:** /Ignore

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** ignore

### /UnIgnorePlayer

**Description:** Un-ignores a target player’s chat messages.

**Alias:** /UnIgnore

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** ignore

### /IgnoredPlayerList

**Description:** Lists all players currently ignored.

**Alias:** /IgnoreList

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** ignore

### /Siege

**Description:** Besieges a player (disabled by default).

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** siege

### /Trapped

**Description:** Gets a player out of a land claim he’s trapped inside.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** trapped

### /UnlockDrops

**Description:** Allows other players to pick up items you dropped when you died.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** unlockdrops
```

--------------------------------

### Admin Commands

Source: https://docs.griefprevention.com/commands

Commands available to administrators for managing claims and server settings.

```APIDOC
## Admin Commands

All of the permissions below start with ‘griefprevention.’. For example, ‘restorenature’ is ‘griefprevention.restorenature’. See the full list of permissions for more details.

### /RestoreNature

**Description:** Switches the shovel tool to restoration mode.

**Alias:** /rn

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** restorenature

### /RestoreNatureAggressive

**Description:** Switches the shovel tool to aggressive restoration mode.

**Alias:** /rna

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** restorenatureaggressive

### /RestoreNatureFill

**Description:** Switches the shovel tool to fill mode.

**Alias:** /rnf

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** restorenatureaggressive

### /IgnoreClaims

**Description:** Toggles ignore claims mode.

**Alias:** /ic

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** ignoreclaims

### /AdminClaims

**Description:** Switches the shovel tool to administrative claims mode.

**Alias:** /ac

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** adminclaims

### /DeleteAllAdminClaims

**Description:** Deletes all administrative claims.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** adminclaims

### /AdminClaimsList

**Description:** Lists all administrative claims.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** adminclaims

### /AdjustBonusClaimBlocks

**Description:** Adds or subtracts bonus claim blocks for a player.

**Alias:** /acb

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** adjustclaimblocks

### /AdjustBonusClaimBlocksAll

**Description:** Adds or subtracts bonus claim blocks for all online players.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** adjustclaimblocks

### /SetAccruedClaimBlocks

**Description:** Updates a player’s accrued claim block total.

**Alias:** /scb

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** adjustclaimblocks

### /DeleteClaim

**Description:** Deletes the claim you’re standing in, even if it’s not your claim.

**Alias:** /dc

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** deleteclaims

### /DeleteAllClaims

**Description:** Deletes all of another player’s claims.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** deleteclaims

### /DeathBlow

**Description:** No description provided.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** deathbow

### /SoftMute

**Description:** Toggles whether a player’s messages will only reach other soft-muted players.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** softmute

### /GPreload

**Description:** Reloads Grief Prevention’s configuration settings. Does NOT totally reload the entire plugin.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** reload

### /TransferClaim

**Description:** Converts an administrative claim to a private claim.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** transferclaim

### /ClaimsList

**Description:** Lists information about a player’s claim blocks and claims.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claimslistother

### /Separate

**Description:** Forces two players to ignore each other in chat.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** separate

### /ClaimBook

**Description:** Gives a player a manual about claiming land.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** claimbook

### /DeleteClaimsInWorld

**Description:** Deletes all the claims in a world. Only usable at the server console.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** deleteclaimsinworld

### /DeleteUserClaimsInWorld

**Description:** Deletes all the non-admin claims in a world. Only usable at the server console.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** deleteclaimsinworld

### /UnlockDrops

**Description:** No description provided.

**Method:** N/A (Command)

**Endpoint:** N/A

**Perm:** unlockothersdrops
```

--------------------------------

### Trust Public Command

Source: https://docs.griefprevention.com/configuration

This command trusts all players to build within the specified claim. When used after an admin claim, it effectively disables GriefPrevention's protections in that area while preventing other players from claiming it.

```java
/trust public
```

--------------------------------

### GriefPrevention Admin Claim Command

Source: https://docs.griefprevention.com/configuration

Use this command to create an administrative claim that can overlap with areas protected by other plugins. This is often a prerequisite for disabling GriefPrevention's protections in specific zones.

```java
/adminclaims
```

--------------------------------

### Add GriefPrevention Dependency

Source: https://docs.griefprevention.com/api

Include the GriefPrevention dependency in your pom.xml with the provided scope.

```xml
	<dependency>
	    <groupId>com.github.GriefPrevention</groupId>
	    <artifactId>GriefPrevention</artifactId>
	    <version>16.18.2</version>
            <scope>provided</scope>
	</dependency>
```

--------------------------------

### GriefPrevention Permission Nodes

Source: https://docs.griefprevention.com/permissions

A list of available permission nodes for managing GriefPrevention functionality.

```APIDOC
## GriefPrevention Permissions

### Description
This list details the permission nodes used to control access to GriefPrevention features, commands, and administrative tools.

### Permissions List
- **griefprevention.abandonallclaims** - Allows the player to abandon all of their claims using /abandonallclaims (Default: true)
- **griefprevention.adjustclaimblocks** - Allows the player to adjust bonus claim blocks
- **griefprevention.adminclaims** - Allows creating, deleting, and building in administrative claims
- **griefprevention.buysellclaimblocks** - Allows the player to buy/sell claim blocks (Default: true)
- **griefprevention.claims** - Necessary for claims-related slash commands (Default: true)
- **griefprevention.claimslistother** - Grants access to /claimslist
- **griefprevention.createclaims** - Allows players to create claims with the claim creation tool (Default: true)
- **griefprevention.deleteclaims** - Allows the player to delete and resize other player’s claims
- **griefprevention.eavesdrop** - Allows the player to see private messages like /tell
- **griefprevention.eavesdropsigns** - Allows the player to receive notifications about newly-placed signs
- **griefprevention.extendclaim.toolbypass** - Allows a player to extend a claim without a modification tool
- **griefprevention.ignoreclaims** - Allows the player to ignore claims using /ignoreclaims
- **griefprevention.lava** - Allows placing lava where the player has build permission
- **griefprevention.notignorable** - Makes a player immune to the /ignore command
- **griefprevention.overrideclaimcountlimit** - Allows a player to bypass the total claim count limit
- **griefprevention.premovementchat** - Allows the player to chat without having to move first
- **griefprevention.restorenature** - Allows the use of the /restorenature command
- **griefprevention.restorenatureaggressive** - Allows the use of the /restorenatureaggressive command
- **griefprevention.seeinactivity** - Allows player to see how long a claim owner has been offline
- **griefprevention.seeclaimsize** - Allows player to see the size of another player’s claim
- **griefprevention.siegeimmune** - Makes a player immune to the /siege command
- **griefprevention.spam** - Allows the player to bypass the spam protection
- **griefprevention.transferclaim** - Grants access to the /transferclaim command
- **griefprevention.trapped** - Allows the player to teleport outside a player’s claim when trapped
- **griefprevention.visualizenearbyclaims** - Allows the player to visualize nearby land claims
```

--------------------------------

### Disable Spawn Protection

Source: https://docs.griefprevention.com/faq

To disable vanilla Minecraft's spawn protection, change the 'spawn-protection' value to '0' in the server.properties file and restart the server.

```properties
spawn-protection=0
```

--------------------------------

### Remove Message from messages.yml

Source: https://docs.griefprevention.com/faq

To remove a message from messages.yml, modify the corresponding line to contain only a blank string. Use two quotes (single or double) for an empty string.

```yaml
  IgnoringClaims:
    Text: ""
```
Tokens:
Raw