{"id":54839,"date":"2026-06-03T04:17:11","date_gmt":"2026-06-03T01:17:11","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/"},"modified":"2026-06-03T04:17:11","modified_gmt":"2026-06-03T01:17:11","slug":"dearu","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/","title":{"rendered":"DearU"},"content":{"rendered":"
\n

# \ud83d\udcec DearU<\/p>\n

### A modern mailbox plugin for Paper\/Folia servers<\/p>\n

![Kotlin](https:\/\/kotlinlang.org\/)
\n![Java](https:\/\/openjdk.org\/)
\n![Paper](https:\/\/papermc.io\/)
\n![License](LICENSE)<\/p>\n<\/div>\n

## \u2728 Features<\/p>\n

– \ud83d\udcee **Mailbox System** – Players can receive and manage their mail through a beautiful GUI
\n– \ud83d\udce6 **Package Support** – Send single items or multi-item packages to players
\n– \ud83d\udcbe **Database Abstraction** – Built-in support for SQLite and MySQL
\n– \u26a1 **Async Operations** – Non-blocking mail operations using `CompletableFuture`
\n– \ud83c\udfa8 **Modern API** – Clean Java interface for plugin developers
\n– \ud83d\udee0\ufe0f **Command Aliases** – Customizable command aliases<\/p>\n

## \ud83d\udcc1 Project Structure<\/p>\n

“`
\nDearU\/
\n\u251c\u2500\u2500 api\/ # Java module with public interfaces
\n\u2502 \u2514\u2500\u2500 DearU # Main plugin interface
\n\u2502 \u251c\u2500\u2500 Mailbox # Async mailbox operations
\n\u2502 \u251c\u2500\u2500 Mail # Sealed interface for mail types
\n\u2502 \u2502 \u251c\u2500\u2500 SingleMail # Single item mail
\n\u2502 \u2502 \u2514\u2500\u2500 PackageMail # Multi-item package
\n\u2502 \u251c\u2500\u2500 MailSender # Mail sender representation
\n\u2502 \u2514\u2500\u2500 MailboxManager # Mailbox instance manager
\n\u2502
\n\u2514\u2500\u2500 core\/ # Kotlin module with implementations
\n \u2514\u2500\u2500 DearUPlugin # Main plugin class
\n \u251c\u2500\u2500 DearUConfiguration # Config system
\n \u251c\u2500\u2500 DatabaseManager # Database abstraction
\n \u251c\u2500\u2500 MailboxManagerImpl # Mailbox implementation
\n \u2514\u2500\u2500 MailboxGui # GUI implementation
\n“`<\/p>\n

## \ud83d\ude80 Getting Started<\/p>\n

### Requirements<\/p>\n

– **Java 21** or higher
\n– **Paper\/Folia** server (latest version)<\/p>\n

### Installation<\/p>\n

1. Build the plugin:
\n “`bash
\n .\/gradlew build
\n “`<\/p>\n

2. Find the JAR in `core\/build\/libs\/`<\/p>\n

3. Place it in your server’s `plugins\/` folder<\/p>\n

4. Restart your server<\/p>\n

### Configuration<\/p>\n

Edit `plugins\/DearU\/config.yml` to customize:<\/p>\n

“`yaml
\n# Database settings (SQLite\/MySQL)
\ndatabase:
\n sql:
\n type: SQLITE # or MYSQL
\n mysql:
\n host: localhost
\n port: 3306
\n database: dearu
\n username: root
\n password: password<\/p>\n

# Command aliases
\ncommands:
\n mailbox:
\n aliases:
\n – mail
\n – \uc6b0\ud3b8\ud568
\n“`<\/p>\n

## \ud83d\udcbb Development<\/p>\n

### Build Commands<\/p>\n

“`bash
\n# Build the project
\n.\/gradlew build<\/p>\n

# Run test server (Paper)
\n.\/gradlew runServer<\/p>\n

# Run Folia test server
\n.\/gradlew runFolia<\/p>\n

# Clean build artifacts
\n.\/gradlew clean
\n“`<\/p>\n

### API Usage<\/p>\n

#### Sending Mail<\/p>\n

“`java
\nimport com.bindglam.dearu.DearU;
\nimport com.bindglam.dearu.mail.*;<\/p>\n

\/\/ Get plugin instance
\nDearU dearU = DearUProvider.get();<\/p>\n

\/\/ Send single item mail
\nMail singleMail = Mail.single(
\n MailSender.server(),
\n itemStack,
\n “Welcome to our server!”
\n);
\ndearu.mailboxManager().getMailbox(playerUUID)
\n .putMail(singleMail);<\/p>\n

\/\/ Send package mail
\nPackageMail.Body body = PackageMail.bodyBuilder()
\n .name(“Welcome Package”)
\n .content(itemStack1)
\n .content(itemStack2)
\n .build();<\/p>\n

Mail packageMail = Mail.packaged(
\n MailSender.player(senderUUID),
\n body,
\n “Here’s your starter kit!”
\n);
\ndearu.mailboxManager().getMailbox(playerUUID)
\n .putMail(packageMail);
\n“`<\/p>\n

#### Reading Mail<\/p>\n

“`java
\nimport com.bindglam.dearu.Mailbox;
\nimport java.util.concurrent.CompletableFuture;<\/p>\n

Mailbox mailbox = dearU.mailboxManager().getMailbox(playerUUID);<\/p>\n

\/\/ Get all mail (async)
\nCompletableFuture> future = mailbox.mails();
\nfuture.thenAccept(mails -> {
\n for (Mailbox.IdentifiedMail identified : mails) {
\n Mail mail = identified.mail();
\n \/\/ Process mail…
\n }
\n});<\/p>\n

\/\/ Get specific mail by ID
\nCompletableFuture mailFuture = mailbox.mail(mailId);
\nmailFuture.thenAccept(identified -> {
\n if (identified != null) {
\n Mail mail = identified.mail();
\n \/\/ Process mail…
\n }
\n});
\n“`<\/p>\n

## \ud83c\udfd7\ufe0f Architecture<\/p>\n

### Managerial Pattern<\/p>\n

All managers implement the `Managerial` interface:<\/p>\n

“`kotlin
\ninterface Managerial {
\n fun start(context: Context)
\n fun end(context: Context)
\n}
\n“`<\/p>\n

Managers are initialized in plugin lifecycle:
\n“`kotlin
\nval managers = listOf(DatabaseManager, MailboxManagerImpl)
\nmanagers.forEach { it.start(Context(this, dearUConfig)) }
\n“`<\/p>\n

### Database Abstraction<\/p>\n

Uses `DatabaseLib` for unified SQL operations:<\/p>\n

– **SQLite** – Default, uses `database.db` in plugin data folder
\n– **MySQL** – Configurable for production use<\/p>\n

### Configuration System<\/p>\n

Nested class-based configuration using `ConfigLib`:
\n“`kotlin
\nclass Commands {
\n val mailbox = createExtendedComplexField { CommandField(“mailbox”) }
\n}
\n“`<\/p>\n

## \ud83d\udd27 Dependencies<\/p>\n

### Runtime Dependencies
\n– **ConfigLib** (1.0.0) – Configuration system
\n– **DatabaseLib** (1.0.4) – Database abstraction
\n– **semver4j** (6.0.0) – Version comparison<\/p>\n

### Build Dependencies
\n– **Shadow Plugin** – JAR shading and relocation
\n– **RunPaper** – Test server management<\/p>\n

## \ud83d\udcdd License<\/p>\n

This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n

## \ud83e\udd1d Contributing<\/p>\n

Contributions are welcome! Please feel free to submit a Pull Request.<\/p>\n

## \ud83d\udcde Support<\/p>\n

– \ud83d\udc1b Report bugs via GitHub Issues
\n– \ud83d\udca1 Feature requests welcome
\n– \ud83d\udcd6 Check the code documentation for more details<\/p>\n

—<\/p>\n

\n

Made with \u2764\ufe0f for the Minecraft community<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

A paper plugin for mailbox<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"dearu","_minecraft_project_id":"EmibqDVx","_minecraft_author":"bindglam","_minecraft_license":"MIT","_minecraft_downloads":15,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"dearu.zip","_minecraft_size_bytes":3559074,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:50:02.114596Z","_minecraft_date_created":"2026-03-12T02:54:39.596849Z","_minecraft_date_modified":"2026-03-08T08:36:14.513246Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/dearu","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-03T01:17:15+00:00","_minecraft_import_hash":"bd71a5e59073d7188cf5670a043239e2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,126,127,128,91,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-54839","mod","type-mod","status-publish","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-storage","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nDearU - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"DearU - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A paper plugin for mailbox\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/dearu\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/dearu\\\/\",\"name\":\"DearU - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"datePublished\":\"2026-06-03T01:17:11+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/dearu\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/dearu\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/dearu\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"DearU\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"DearU - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/","og_locale":"en_US","og_type":"article","og_title":"DearU - Minecraft","og_description":"A paper plugin for mailbox","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/","name":"DearU - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"datePublished":"2026-06-03T01:17:11+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/dearu\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/dearu\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"DearU"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/54839","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=54839"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=54839"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=54839"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=54839"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}