![Chest Protect Description](https://cdn.modrinth.com/data/cached_images/d84e226274e605cda6262a4b4077ba14d454c8e4.png)

Text version

**A comprehensive Minecraft Bukkit plugin that automatically protects containers with friend lists, visual indicators, ownership transfer, and automatic cleanup for inactive players.** ## 🔒 **Core Protection Features** ### **Automatic Container Protection** - **Instant Protection**: All containers are automatically protected when placed by players - **Extensive Container Support**: Protects 30+ container types including: - **Storage**: Chests, Trapped Chests, Barrels, Ender Chests - **All Shulker Boxes**: All 17 colors (configurable) - **Processing**: Furnaces, Blast Furnaces, Smokers, Brewing Stands - **Redstone**: Dispensers, Droppers, Hoppers - **Utility**: Beacons, Anvils, Enchanting Tables, Lecterns, Jukeboxes, and more - **Double Chest Support**: Automatically protects both halves of double chests - **SQLite Database**: Persistent protection storage with efficient indexing ### **Access Control System** - **Owner-Only Access**: Only the player who placed the container can access it by default - **Admin Bypass**: Configurable admin override with permission `chestprotect.admin.bypass` - **Break Protection**: Prevents unauthorized players from breaking protected containers ## 👥 **Friend System** ### **Global Friend Lists** - **Add Friends**: `/chestprotect friend add ` - Add players to your friend list - **Remove Friends**: `/chestprotect friend remove ` - Remove players from your list - **View Friends**: `/chestprotect friend list` - See all your friends - **Clear List**: `/chestprotect friend clear` - Remove all friends at once ### **Friend Access Benefits** - **Global Access**: Friends can access ALL your protected containers - **Offline Player Support**: Add friends even when they're not online - **Cached Performance**: Friend lists are cached for fast access checking - **Database Persistence**: Friend relationships survive server restarts ## 🎨 **Visual Indicators** ### **Particle Effects System** - **Real-time Visual Feedback**: See protection status with particle effects - **Color-Coded Indicators**: - 🟢 **Green Particles** (Happy Villager) - Containers you own - 🔵 **Blue Particles** (Enchant) - Containers your friends shared with you - 🔴 **Red Particles** (Angry Villager) - Protected containers you can't access - **Smart Display**: Only shows particles within 10 blocks of players - **Performance Optimized**: Updates every 2 seconds to minimize lag - **Configurable**: Enable/disable visual indicators in config ## 🔄 **Ownership Transfer** ### **Container Transfer System** - **Easy Transfer**: `/chestprotect transfer ` - Transfer ownership to another player - **Look-at-Target**: Simply look at the container you want to transfer (no coordinates needed) - **Instant Transfer**: Ownership changes immediately with database update - **Notifications**: Both players receive confirmation messages - **Validation**: Ensures you own the container and target player exists ## 🧹 **Automatic Cleanup** ### **Inactive Player Management** - **Last Access Tracking**: Records when containers were last opened - **Automatic Expiry**: Removes protections from containers unused for 30+ days (configurable) - **Background Cleanup**: Runs automatically every 24 hours - **Manual Cleanup**: Admins can trigger cleanup with `/chestprotect cleanup` - **World Cleanup**: Removes containers from deleted worlds ## ⚙️ **Advanced Configuration** ### **Hopper Control** - **Configurable Hopper Access**: Choose whether hoppers can extract/insert items from protected containers - **Complete Block Prevention**: When disabled, hoppers cannot interact with protected containers at all - **All Container Types**: Works with chests, furnaces, dispensers, and all other containers ### **Customizable Messages** - **Color Code Support**: Full `&` color code support in all messages - **Dynamic Placeholders**: `{container}` placeholder shows the actual container type - **Multilingual Ready**: All messages configurable in config.yml - **Admin Notifications**: Separate messages for admin bypass actions ### **Protection Settings** - **Admin Bypass Toggle**: Enable/disable admin override permissions - **Double Chest Protection**: Auto-protect both halves of double chests - **Shulker Box Toggle**: Enable/disable shulker box protection - **Placement Notifications**: Configure whether players see protection messages ## 📊 **Information & Statistics** ### **Player Information** - **Protection Stats**: `/chestprotect info` shows: - Number of containers you have protected - Number of friends in your list - Auto-cleanup expiry setting - **Database Queries**: Real-time statistics from the database ## 🛡️ **Security Features** ### **Database Security** - **SQLite Backend**: Lightweight, reliable database storage - **Prepared Statements**: Prevents SQL injection attacks - **Transaction Safety**: Atomic operations for data consistency - **Index Optimization**: Fast lookups even with thousands of containers ### **Permission System** - **Granular Permissions**: Separate permissions for each feature - **Default Access**: Basic features available to all players by default - **Admin Controls**: Admin-only commands properly protected - **Permission Inheritance**: Logical permission hierarchy ## 🚀 **Performance Features** ### **Optimization Systems** - **Friend List Caching**: Friend lists cached in memory for instant access - **Efficient Database Queries**: Indexed database with optimized SQL - **Minimal Visual Impact**: Visual indicators limited to nearby containers only - **Asynchronous Tasks**: Cleanup operations don't impact server performance ### **Resource Management** - **Lightweight Design**: Minimal memory footprint - **Smart Caching**: Only caches frequently accessed data - **Automatic Cleanup**: Background tasks prevent database bloat ## 💻 **Commands Reference** | Command | Description | Permission | |---------|-------------|------------| | `/chestprotect` | Show help menu | `chestprotect.use` | | `/chestprotect friend add ` | Add friend | `chestprotect.friend` | | `/chestprotect friend remove ` | Remove friend | `chestprotect.friend` | | `/chestprotect friend list` | List friends | `chestprotect.friend` | | `/chestprotect friend clear` | Clear friends | `chestprotect.friend` | | `/chestprotect transfer ` | Transfer ownership | `chestprotect.transfer` | | `/chestprotect info` | View statistics | `chestprotect.info` | | `/chestprotect cleanup` | Clean expired containers | `chestprotect.admin.cleanup` | | `/chestprotect reload` | Reload config | `chestprotect.admin.reload` | **Aliases**: `/cp`, `/protect`, `/lockchest` work for `/chestprotect` ## 🔧 **Technical Requirements** - **Minecraft Version**: 1.21+ (API version 1.21) - **Server Software**: Bukkit, Spigot, Paper - **Dependencies**: SQLite JDBC driver (usually included) - **Java Version**: Java 17+ (matches Minecraft 1.21 requirements) ## 📋 **Installation** 1. Download ChestProtect.jar 2. Place in your server's `/plugins/` folder 3. Restart server to generate default configuration 4. Customize settings in `/plugins/ChestProtect/config.yml` 5. Reload config with `/chestprotect reload` ## ✨ **Key Benefits** - **Zero Configuration**: Works immediately with sensible defaults - **User Friendly**: Simple commands and clear feedback messages - **Admin Friendly**: Comprehensive admin tools and controls - **Performance Conscious**: Optimized for servers with many players - **Feature Rich**: Advanced functionality without complexity - **Reliable**: Robust database storage and error handling --- **This plugin provides exactly what's implemented - no more, no less. Every feature described here is fully functional and tested.**

Advertisement: [![PlayerCONSOLE ad](https://cdn.modrinth.com/data/cached_images/d058bf6c8422c553e1843b0cb2efcb237d345e39.png)](https://www.spigotmc.org/resources/%E2%9C%A8%E3%80%90%E2%98%85-player%E2%9C%A6console-%E2%98%85%E3%80%91%E2%9C%A8-%E2%8E%AE-remote-admin-panel-50-off-%E2%8E%AE-velocity-support-file-managing-%E2%9B%8F%EF%B8%8F.126241/)

ChestProtect

ChestProtect 1.2

Список изменений

Файлы

Метаданные

Канал релиза

Номер версии

Загрузчики

Версии игры

Загрузок

Дата публикации

Загрузил

ID версии