Clean to Dustbin Mod-秋风扫落叶

A server-side mod for Minecraft Forge 1.20.1 that automatically collects and stores all dropped items in an accessible dustbin.

Features

🗑️ Smart Dustbin System

Automatically collects and saves all dropped items worldwide
6-row large chest interface with multi-page support
Red stained glass pane navigation buttons for intuitive operation
Real-time display of current page number
Previous page button hidden on first page, next page button hidden on last page

⏰ Scheduled Cleanup Mechanism

Configurable cleanup interval
12 reminder broadcasts before cleanup:
- 1 minute reminder
- 30 seconds reminder
- Countdown from 10 seconds to 1 second
Broadcasts the number of collected items after cleanup

📝 Highly Configurable

Customizable reminder messages
Adjustable cleanup interval
Configurable dustbin pages
Flexible configuration options

🎮 Convenient Command System

/ljt - Open dustbin interface
/ljt <page> - Jump directly to specified page
/ljt reload - Reload configuration (requires admin permission)

Installation

Ensure your server has Forge 1.20.1 installed
Download the clean-to-dustbin-x.x.x.jar file
Place the jar file into your server's mods folder
Start the server, the mod will generate configuration files automatically
Modify the configuration files as needed

Usage

Opening the Dustbin

Enter /ljt command in-game
The dustbin interface will open as a 6-row large chest

Page Navigation

Previous Page: Click the red stained glass pane at the bottom-left (row 6, column 3)
Current Page: The sign in the middle displays current page and total pages
Next Page: Click the red stained glass pane at the bottom-right (row 6, column 5)

Direct Jump

Enter /ljt <page> to jump directly to the specified page
Example: /ljt 3 jumps to page 3

Configuration Options

Configuration file is located at serverconfig/cleantodustbin-server.toml, you can customize the mod behavior through the following options:

Option	Type	Default	Description
`CLEANUP_INTERVAL`	Integer	3600	Cleanup interval in seconds
`DUSTBIN_PAGES`	Integer	5	Number of dustbin pages
`REMINDER_MESSAGES`	String List	Built-in messages	Reminder messages before cleanup

Custom Reminder Messages Example

REMINDER_MESSAGES = [
    "&aItem cleanup will start in 1 minute!",
    "&aItem cleanup will start in 30 seconds!",
    "&aItem cleanup will start in 10 seconds!",
    "&aItem cleanup will start in 9 seconds!",
    "&aItem cleanup will start in 8 seconds!",
    "&aItem cleanup will start in 7 seconds!",
    "&aItem cleanup will start in 6 seconds!",
    "&aItem cleanup will start in 5 seconds!",
    "&aItem cleanup will start in 4 seconds!",
    "&aItem cleanup will start in 3 seconds!",
    "&aItem cleanup will start in 2 seconds!",
    "&aItem cleanup will start in 1 second!"
]

Command Description

Command	Permission	Description
`/ljt`	All players	Open dustbin interface
`/ljt <page>`	All players	Jump directly to specified page
`/ljt reload`	Admin	Reload configuration file

Interface Description

Dustbin Interface Layout

┌─────────────────────────────────────────────────┐
│                                                 │
│                                                 │
│                                                 │
│                                                 │
│                                                 │
│                                                 │
│  [Red Glass]  [Sign]  [Red Glass]               │
│  [Prev Page]  [Page]  [Next Page]               │
└─────────────────────────────────────────────────┘

Red Glass Buttons: Click to switch pages
Sign: Displays current page and total pages
Item Slots: Stores collected dropped items

Development Information

Tech Stack

Minecraft Forge: 1.20.1
Java: 17
Gradle: 8.8

Project Structure

clean-to-dustbin/
├── src/main/java/com/example/cleantodustbin/
│   ├── CleanToDustbin.java          # Main mod class
│   ├── config/ModConfig.java        # Configuration class
│   ├── command/DustbinCommand.java  # Command handling
│   ├── cleanup/CleanupScheduler.java # Cleanup scheduler
│   └── dustbin/                     # Dustbin related
│       ├── DustbinManager.java      # Dustbin management
│       ├── DustbinInventory.java    # Dustbin inventory
│       └── DustbinContainer.java    # Dustbin container
└── build.gradle                     # Gradle configuration

Notes

This mod only runs on the server, no client installation required
Ensure the server has enough memory to store dustbin data
Clean the dustbin regularly to avoid excessive memory usage
Use /ljt reload command to reload configuration after modification

License

MIT License

Support

If you have any issues or suggestions, please submit an Issue or Pull Request.

Enjoy a clean Minecraft world! 🎉

Clean to Dustbin/秋风扫落叶