ChestProtect

ChestProtect

A simple yet powerful Minecraft plugin for protecting chests with sign-based ownership and request system.

Made by juicyyfruittsnackss - Made by juicyyfruittsnackss

Features

- Paper and Spigot Compatible: Protect chests by placing a sign with `:username:` format - Paper and Spigot Compatible: Claim chests directly using the `/claimchest` command - Paper and Spigot Compatible: Players can request temporary access to protected chests - Paper and Spigot Compatible: Clickable accept/deny buttons for chest owners - Paper and Spigot Compatible: Granular permission nodes for different functionality - Paper and Spigot Compatible: All messages can be customized in the config - Paper and Spigot Compatible: Minimal server resource usage - Paper and Spigot Compatible: Works with Paper, Spigot, and other forks

Installation

1. Download the latest version of ChestProtect 2. Choose the JAR file that matches your Minecraft version (e.g., `ChestProtect-1.0.0-mc1.21.4.jar` for Minecraft 1.21.4) 3. Place the JAR file in your server's `plugins` folder 4. Restart your server or use a plugin manager to load the plugin 5. Configuration files will be automatically generated on first run

Usage

Protecting a Chest

Method 1: Using Signs 1. Place a chest in the world 2. Place a sign on any side of the chest 3. Write `:username:` on any line of the sign (replace username with your name) 4. The sign will automatically format to show it's protected

Method 2: Using the Claim Command 1. Place a chest in the world 2. Place a sign on any side of the chest (can be blank) 3. Look at the chest and type `/claimchest` 4. The sign will automatically format to show it's protected

Requesting Access

1. Try to open a protected chest (you'll be shown a message that it's protected) 2. Click on the suggested command or type `/openrequest <owner>` manually 3. The owner will receive a notification with clickable Accept/Deny buttons 4. If accepted, you'll receive temporary access to open the chest once

Unlocking Your Own Chest

1. Look directly at your protected chest 2. Type `/unlockchest` 3. The chest protection will be removed, and anyone can access it

Commands

- `/openrequest <player>` - Request access to a player's protected chests - `/acceptrequest <player>` - Accept a chest access request - `/denyrequest <player>` - Deny a chest access request - `/unlockchest` - Remove protection from a chest you're looking at - `/claimchest` - Claim and protect a chest with an attached sign

Permissions

- `chestprotect.request` - Allows requesting chest access (default: true) - `chestprotect.accept` - Allows accepting chest access requests (default: true) - `chestprotect.deny` - Allows denying chest access requests (default: true) - `chestprotect.protect` - Allows protecting chests (default: true) - `chestprotect.unlock` - Allows unlocking your own protected chests (default: true) - `chestprotect.protect.others` - Allows protecting chests for other players (default: op) - `chestprotect.admin.unlock` - Allows unlocking any protected chest (default: op) - `chestprotect.admin` - Admin access to all protected chests (default: op)

Configuration

The plugin's configuration is stored in `plugins/ChestProtect/config.yml`. You can modify the request timeout duration and all messages shown to players.

```yaml

Time in seconds that access requests will remain valid

request_timeout: 60

Messages configuration

Use & for color codes, {0}, {1}, etc. for parameters

messages: prefix: "&8[&6ChestProtect&8] &r"

Error messages, success messages, etc.

See the default config for all available options

```

Version Compatibility

ChestProtect is fully compatible with PaperMC, and has been tested with Minecraft 1.21.4. It uses recommended best practices for plugin development and avoids any deprecated API methods where possible.

JAR files are named according to the Minecraft version they were built for (e.g., `ChestProtect-1.0.0-mc1.21.4.jar`), making it easy to select the correct version for your server.

Support

For support, feature requests, or bug reports, please join our Discord server at dsc.gg/fruitsnacks.

Credits

Created by juicyyfruittsnackss. Visit dsc.gg/fruitsnacks for more plugins and support.