ChestProtect

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

Made by juicyyfruittsnackss - dsc.gg/fruitsnacks

Features

• Simple Sign-Based Protection: Protect chests by placing a sign with :username: format
• Direct Chest Claiming: Claim chests directly using the /claimchest command
• Request-Based Access: Players can request temporary access to protected chests
• Interactive Chat Components: Clickable accept/deny buttons for chest owners
• Permission System: Granular permission nodes for different functionality
• Configurable Messages: All messages can be customized in the config
• Optimized Performance: 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.

# 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.