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.**
暂无评论，抢个沙发吧~