BigEnderChest

Carousel Demo video

DonutEnderChest | Expandable Storage with Admin Management

A professional ender chest system featuring permission-based size upgrades, automatic backups, admin management tools, and complete data control for server owners.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What Does DonutEnderChest Do?

DonutEnderChest replaces Minecraft's default 27-slot ender chest with an expandable storage system. Players can earn up to 54 slots (6 rows) through permissions, while admins get powerful tools to view, backup, and restore player ender chests.

The Problem: Minecraft's vanilla ender chest is limited to 27 slots, which isn't enough for servers with extensive inventories, custom items, or progression systems. Server owners also lack tools to help players recover lost items or manage ender chest data.

The Solution: DonutEnderChest provides:

Expandable ender chests up to 6 rows (54 slots)
Permission-based size tiers for ranks
Automatic backup system with timestamps
Admin tools to view and manage player chests
Auto-save system prevents data loss
Complete customization options

How It Works:
1. Player opens ender chest block
2. Plugin replaces vanilla chest with custom GUI
3. Size determined by player's permissions
4. Items load from player's data file
5. Auto-saves periodically and on close
6. Admins can backup, view, or restore anytime

Perfect For:
[*]Servers with donation ranks/perks
[*]Progression-based storage upgrades
[*]Servers needing admin oversight
[*]Communities requiring item recovery
[*]Networks with custom items
[*]Any server wanting expandable storage

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Core Features

Permission-Based Size System
[*]Four Size Tiers: Grow with player progression

Default: 3 rows (27 slots) - Standard vanilla size
Tier 1: 4 rows (36 slots) - Permission: donutec.size.4
Tier 2: 5 rows (45 slots) - Permission: donutec.size.5
Tier 3: 6 rows (54 slots) - Permission: donutec.size.6

[*]Smart Priority System: Highest permission wins

Checks: donutec.size.6 → .5 → .4 → default
Player automatically gets largest size they have permission for
Seamless upgrades when permissions granted
No command needed to upgrade

[*]Safe Downgrade Handling: Items never lost

If player loses permission (demotion/expiration)
Items beyond new size stay in data file
Not visible in GUI but preserved
Appear again when permission restored

[*]Configurable System: Enable/disable tiers

Toggle permission sizing entirely
Set custom default size
Perfect for non-rank servers
Flexible for any setup

Comprehensive Backup System
[*]Automatic Backups: Manual admin control

/donutecadmin backup <player> creates backup
Stored in backups/<uuid>/ folder
Timestamped filename format
Independent file per backup

[*]Timestamp System: Clear organization

Format: yyyy-MM-dd_HH-mm-ss.yml
Example: 2026-01-10_14-30-45.yml
Easy to identify when backup created
Sorts chronologically in file system

[*]Backup Limit: Automatic cleanup

Configurable max backups per player (default: 10)
Oldest backup deleted when limit exceeded
Prevents excessive disk usage
Always keeps most recent backups

[*]Complete Data Storage: Everything saved

All items with NBT data
Enchantments preserved
Custom item data maintained
Exact slot positions saved

Admin Management Tools
[*]View Player Chests: Oversight capability

/donutecadmin view <player>
Opens player's ender chest in GUI
Shows actual items in real-time
Two modes: view-only or editable

[*]Editable Mode: Help or moderate

admin-view.editable: true in config
Admin can add/remove items
Changes save to player's chest
Perfect for helping stuck players

[*]View-Only Mode: Safe inspection

admin-view.editable: false in config
Admin can view but not change
No accidental modifications
Ideal for investigation/support

[*]Backup Management: Complete control

/donutecadmin backup <player> - Create backup now
/donutecadmin listbackups <player> - Show all backups
/donutecadmin restore <player> <file> - Restore from backup
/donutecadmin delete <player> - Delete all player data

[*]Data Recovery: Save players from mistakes

Player accidentally deletes items
Admin restores from backup
Items returned immediately
Player satisfaction maintained

Auto-Save System
[*]Periodic Saving: Never lose data

Saves all open ender chests automatically
Configurable interval (default: 300 seconds = 5 minutes)
Enable/disable in config
Runs in background

[*]Event-Based Saving: Immediate protection

Saves on chest close
Saves on server shutdown
Saves before backup creation
No manual save needed

[*]Crash Protection: Data integrity

Auto-save runs even during lag
Prevents rollbacks from crashes
Maintains latest state
Reliable storage

Customizable GUI
[*]Title Customization: Brand your chest

Custom title with color codes
Default: "&8ENDER CHEST"
Optional row count display
Example: "ENDER CHEST (6 rows)"

[*]Dynamic Titles: Show player info

Admin view mode shows player name
Example: "Viewing: PlayerName's Ender Chest"
Clear visual indicator
Prevents confusion

[*]Sound Effects: Immersive experience

Open sound: BLOCK_ENDER_CHEST_OPEN
Close sound: BLOCK_ENDER_CHEST_CLOSE
Configurable volume and pitch
Enable/disable toggle

Reliable Data Storage
[*]UUID-Based Storage: Name-change safe

Stored in data/<uuid>.yml
Works after name changes
Unique per player
No conflicts

[*]Complete Item Serialization: Everything saved

Items with NBT data
Enchantments and attributes
Custom model data
Lore and display names
Potion effects
Book pages
Firework effects

[*]Slot Position Preservation: Exact layout

Items saved with slot numbers
Restore to exact positions
Player organization maintained
No random shuffling

Data Safety Features
[*]Backup Before Restore: Safety net

Auto-backup before restoring
Can undo accidental restores
Zero data loss risk
Professional safety

[*]Validation System: Error prevention

Checks if player exists before operations
Verifies backup files exist
Validates data integrity
Clear error messages

[*]Concurrent Access Prevention: No conflicts

Tracks which chests are open
Prevents double-open issues
Saves on close properly
Thread-safe operations

Complete Message System
[*]All Actions Confirmed: Clear feedback

Opened chest message
Saved message
Backup created message
Restore success message
Deletion confirmation

[*]Error Messages: Helpful guidance

Player not found
Backup not found
No backups available
No permission message
Clear explanations

[*]Color Support: Professional appearance

Legacy color codes (&a, &c, etc.)
Hex colors (&#RRGGBB)
Custom prefix
Formatted placeholders

Advanced Configuration
[*]Flexible Defaults: Adapt to your server

Default rows (3/4/5/6)
Permission system toggle
Auto-save interval
Backup limits
Sound settings

[*]Admin Controls: Fine-tune behavior

Admin view editability
Backup folder location
Timestamp format
Message customization

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands

Player Commands

Code:

/donutec - Opens your ender chest

Admin Commands

Code:

/donutec reload - Reloads configuration
/donutecadmin view <player> - View player's ender chest
/donutecadmin backup <player> - Create backup of player's chest
/donutecadmin listbackups <player> - List all backups for player
/donutecadmin restore <player> <backupfile> - Restore from backup
/donutecadmin delete <player> - Delete all player data

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

Code:

donutec.use                  - Open your ender chest
                               Default: true

donutec.size.4               - 4 rows (36 slots)
                               Default: false

donutec.size.5               - 5 rows (45 slots)
                               Default: false

donutec.size.6               - 6 rows (54 slots)
                               Default: false

donutec.admin                - All admin permissions
                               Default: op

donutec.admin.view           - View player ender chests
                               Default: op

donutec.admin.backup         - Create backups
                               Default: op

donutec.admin.listbackups    - List backups
                               Default: op

donutec.admin.restore        - Restore backups
                               Default: op

donutec.admin.delete         - Delete player data
                               Default: op

donutec.admin.reload         - Reload configuration
                               Default: op

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Configuration

Code:

# Default ender chest size (rows)
default-rows: 3

# Permission-based sizes
permission-sizes:
  enabled: true
  sizes:
    4: "donutec.size.4"
    5: "donutec.size.5"
    6: "donutec.size.6"

# GUI settings
gui:
  title: "&8ENDER CHEST"
  update-title-with-rows: true

# Sound effects
sound:
  enabled: true
  open: "BLOCK_ENDER_CHEST_OPEN"
  close: "BLOCK_ENDER_CHEST_CLOSE"
  volume: 1.0
  pitch: 1.0

# Auto-save system
auto-save:
  enabled: true
  interval: 300  # seconds

# Backup system
backups:
  enabled: true
  folder: "backups"
  format: "yyyy-MM-dd_HH-mm-ss"
  max-backups-per-player: 10

# Admin view mode
admin-view:
  editable: true  # false for view-only

# Messages (all customizable)
messages:
  prefix: "&7[&bDonutEC&7]&r "
  opened: "{prefix}&aOpened your ender chest!"
  backup-created: "{prefix}&aBackup created: &e{file}"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Use Case Examples

Donation Rank Progression

Code:

default-rows: 3
permission-sizes:
  enabled: true

# Give permissions based on rank:
# Free: No extra permissions (3 rows)
# VIP: donutec.size.4 (4 rows)
# MVP: donutec.size.5 (5 rows)
# Legend: donutec.size.6 (6 rows)

Use Case: Donation server where ender chest size is a perk. Free players get 27 slots, while Legend rank gets 54 slots. Clear progression incentive for donations.

In-Game Progression System

Code:

default-rows: 3
permission-sizes:
  enabled: true

# Grant permissions through quests/achievements:
# Complete "Storage Master" quest → donutec.size.4
# Reach level 50 → donutec.size.5
# Complete endgame raid → donutec.size.6

Use Case: RPG server where ender chest upgrades are earned through gameplay. Players unlock larger chests by completing challenges, not donating.

Uniform Storage (No Ranks)

Code:

default-rows: 6
permission-sizes:
  enabled: false

Use Case: Small community server where everyone gets maximum storage. No ranks or progression, just quality-of-life improvement for all players.

Admin Recovery Server

Code:

auto-save:
  enabled: true
  interval: 180  # 3 minutes

backups:
  enabled: true
  max-backups-per-player: 20

admin-view:
  editable: true

Use Case: Server with frequent item loss issues. Frequent auto-saves and many backups ensure admins can recover players' items. Editable admin view lets staff help directly.

Investigation/Moderation Server

Code:

admin-view:
  editable: false  # View-only mode

backups:
  enabled: true
  max-backups-per-player: 50

Use Case: Server where admins need to investigate duplication exploits or verify player inventories. View-only mode prevents accidental changes during investigation. Many backups track history.

High-Performance Server

Code:

auto-save:
  enabled: true
  interval: 600  # 10 minutes

sound:
  enabled: false  # Reduce packet overhead

Use Case: Large network with hundreds of players. Longer auto-save interval reduces disk I/O. Sounds disabled to minimize packet usage. Performance optimized.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Workflow Examples

1. Player Opens Ender Chest

Player right-clicks ender chest block
EnderChestListener intercepts event
Checks highest permission tier player has
Creates GUI with appropriate row count
Loads items from data/<uuid>.yml
Opens custom GUI to player
Plays open sound if enabled

2. Player Stores Items

Player drags items into ender chest
Items placed in slots normally
Auto-save runs every configured interval
Items saved to player data file
Player closes chest
Final save triggered on close
Close sound plays if enabled

3. Admin Views Player Chest

Admin uses /donutecadmin view PlayerName
System checks if player exists
Loads player's ender chest data
Opens in admin's view with special title
If editable mode: Admin can modify items
On close: Changes save to player's file (if editable)
Confirmation message sent

4. Player Loses Items (Accident)

Player accidentally deletes valuable items
Player contacts admin for help
Admin runs /donutecadmin backup PlayerName
Current state backed up with timestamp
Admin checks /donutecadmin listbackups PlayerName
Finds backup from before deletion
Admin runs /donutecadmin restore PlayerName 2026-01-09_10-30-00.yml
Items restored from backup
Player's ender chest now has items back

5. Rank Upgrade

Player purchases VIP rank (or earns through progression)
Permission donutec.size.5 granted
Player opens ender chest
System detects new permission
Creates 5-row (45 slot) GUI instead of previous 3-row
All old items load in same positions
2 extra rows now available for use

6. Server Crash Recovery

Server crashes unexpectedly
Auto-save ran 2 minutes before crash
Server restarts
Players open ender chests
Items from 2 minutes ago loaded
Maximum 2 minutes of data loss
Much better than vanilla (lose everything)

7. Admin Investigation

Suspicion of duped items
Admin sets admin-view.editable: false
Admin views multiple player chests with /donutecadmin view
Inspects for suspicious items
Can't accidentally modify during investigation
Takes screenshots for evidence
Uses backup system to check historical data

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Performance Features

Optimized Data Handling
[*]Efficient YAML serialization
[*]Only loads data when chest opened
[*]Saves only when changes occur
[*]No constant background processing
[*]Minimal memory footprint

Smart Storage Management
[*]UUID-based file organization
[*]One file per player (not one database)
[*]Easy manual backup (just copy folder)
[*]No database overhead
[*]Fast file I/O operations

Data Integrity
[*]Auto-save prevents loss on crashes
[*]Backup system creates recovery points
[*]Concurrent access tracking prevents conflicts
[*]Complete item serialization maintains NBT
[*]Save-on-close guarantees latest state

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FAQ

Q: What happens if a player loses their rank/permission?
A: Items beyond the new size limit stay in their data file. They're hidden but not deleted. When permission restored, items reappear.

Q: Can players access ender chests from different locations?
A: Yes! Just like vanilla, the ender chest is shared across all locations. Open any ender chest block to access your expanded storage.

Q: Does this work with vanilla ender chests?
A: Yes, it completely replaces vanilla ender chest behavior. When any player opens an ender chest block, they get the custom GUI.

Q: Can admins add items to players' chests?
A: Yes! Set admin-view.editable: true and use /donutecadmin view <player> to add or remove items.

Q: What if I want admins to only view, not edit?
A: Set admin-view.editable: false in config. Admins can view but cannot modify items.

Q: How often should auto-save run?
A: Default 300 seconds (5 minutes) is good balance. Shorter intervals = more disk writes. Longer = more potential data loss on crash.

Q: Where are backups stored?
A: In plugins/DonutEnderChest/backups/<player-uuid>/ folder. Each backup is a separate timestamped YAML file.

Q: Can I manually create backups before risky operations?
A: Yes! Use /donutecadmin backup <player> anytime to create a backup instantly.

Q: What happens when max-backups-per-player is reached?
A: The oldest backup is automatically deleted when a new backup is created.

Q: Can I give everyone 6 rows by default?
A: Yes! Set default-rows: 6 and permission-sizes.enabled: false in config.

Q: Does this work on BungeeCord/Velocity networks?
A: Each backend server has separate ender chests. For shared ender chests across network, you'd need a shared database (future feature).

Q: Can I customize the sounds?
A: Yes! Change sound.open and sound.close to any valid sound name. Adjust volume and pitch too.

Q: What if a player joins with existing vanilla ender chest items?
A: Their vanilla ender chest items are NOT automatically imported. This plugin starts fresh. Manual transfer needed if desired.

Q: Can I restore a backup while the player is online?
A: Yes, but their chest should be closed first. Best practice is to ask player to close chest before restoring.

Q: How do I delete ALL backups for a player?
A: Delete the folder plugins/DonutEnderChest/backups/<player-uuid>/ manually, or use /donutecadmin delete <player> to delete data (but not backups).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Dependencies & Requirements

Required
[*]Minecraft: 1.13+ (Paper/Spigot/Purpur)
[*]Java: Java 8+ (Java 17+ for Minecraft 1.18+)

Included Libraries
[*]XSeries: Cross-version sound compatibility (bundled)
[*]Lombok: Code generation (bundled)

Optional
None - completely standalone!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation

1. Download DonutEnderChest.jar
2. Place in /plugins folder
3. Restart server (creates config.yml)
4. Configure permissions for ranks if desired
5. Adjust config settings (auto-save, backups, etc.)
6. Reload with /donutec reload or restart
7. Done! Players now have expandable ender chests

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Why Choose DonutEnderChest?

Professional Admin Tools
[*]View and manage player storage
[*]Create backups on-demand
[*]Restore lost items easily
[*]Complete oversight capability
[*]Help players efficiently

Progression-Friendly
[*]Perfect for donation ranks
[*]Great for in-game progression
[*]Clear upgrade path for players
[*]Incentivizes engagement
[*]Fair and balanced

Data Safety First
[*]Auto-save prevents data loss
[*]Backup system enables recovery
[*]Timestamp tracking shows history
[*]Never lose player items
[*]Professional reliability

Complete Customization
[*]Every message customizable
[*]All sounds configurable
[*]Flexible size system
[*]Admin mode options
[*]Adapts to any server

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Support

Need help? Have suggestions? Found a bug?

Contact: moessoe97 on BuiltByBit

Discord: https://discord.gg/jsyct6TW9x

Documentation: Complete configuration guide included

Bug Reports: Open a ticket in our Discord

Feature Requests: Always welcome!

If you enjoy this plugin, please leave a

review!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Give your players expandable storage with professional admin tools for complete control!

Latest reviews

KervsCantCPVP
5.00 star(s)
Saturday at 11:05 PM
Version: v1.1.0

The plugin is good but can you support it with hex colors and make the backups for all players in every hour or 30 minutes depends on the user

moessoe97

Thank you so much for your review! I just put a update out, i hope you like it, and if you have any other suggestions for any of my plugins, feel free to join my discord so we can make it happen.

Upvote 0 Downvote

ryoniciro
5.00 star(s)
Apr 23, 2026
Version: v1.0.3

I like the plugin, but I found a bug, when the inventory is full and you hold an item from the enderchest on the cursor then press esc/close enderchest then the item will disappear and not drop

moessoe97

Thank you for your review, ill fix this today

Upvote 0 Downvote

waltz
5.00 star(s)
Mar 11, 2026
Version: v1.0.0

plugin has a lot of potential especially with a built in restoration system.

please make this into a paid plugin and keep improving and updating the plugin!

moessoe97

Thank you so much for your review!

If you have any questions, suggestions or bugs that i need to fix you can allways contact me.

Best regards,
Milan
- Moessoe97

Contact: moessoe97 on BuiltByBit

Contact: moessoe97 on Discord

Discord Group: https://discord.gg/jsyct6TW9x

Upvote 0 Downvote

BigEnderChest v1.1.1

Overview Updates (6) Reviews (3) History

Latest reviews