ChestProtect

# ChestProtect A simple yet powerful Minecraft plugin for protecting chests with sign-based ownership and request system. **Made by juicyyfruittsnackss** - (https://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. ```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 &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 (https://dsc.gg/fruitsnacks). ## Credits Created by juicyyfruittsnackss. Visit (https://dsc.gg/fruitsnacks) for more plugins and support.