LamMailBox

LamMailBox lets admins deliver items and rich-text messages to players who don’t need to be online. It’s a lightweight mailbox system for Paper/Folia 1.20+ that works from commands or plugin triggers.

Key Features

• Offline delivery: Send mail and item attachments to any player, anytime. Items stay server-side until claimed.
• Command-friendly: Use /lmb send or trigger it from other plugins for instant rewards, gifts, or event drops.
• Simple GUI: Players browse, read, and claim mail through an intuitive interface with inventory checks on pickup.
• Rich messages: Supports colour codes, \n line breaks, and unicode icons.
• Admin tools: Attach console commands, schedule future deliveries, set expirations, or limit repeats via max-runs.
• Bulk targets: player1;player2, allonline (snapshot of current players), or all (persistent for everyone).
• Automated mailings: Cron-style repeating jobs and first-join bundles with catch-up when the server restarts.
• Flexible storage: Choose between YAML or SQLite backends (SQLite recommended beyond ~1000 mails).
• Notifications: Chat, title, and sound alerts for new mail plus join reminders.
• Folia/Paper ready: Uses bundled FoliaLib scheduler for smooth cross-platform timing.

Limitations & Roadmap

• No cross-server syncing or Bungee/Velocity support yet.

Commands

Aliases: /mailbox, /mail

Additional Permissions

Setup

1. Drop the jar in plugins/ and start the server to generate config/database files.
2. Edit plugins/LamMailBox/config.yml to customize GUI text, slots, notification settings, and default expiry days. Set enabled: false on any button entry to remove it from the interface. Decoration fillers can run console commands via the commands list, with %player% and %uuid% placeholders.
3. Grant the permissions that fit your ranks.
4. Compose mail through the GUI or use /lmb send; set up recurring deliveries in mailings.yml for cron or first-join workflows (/lmb mailings shows status).

Documentation

Need examples or deeper guidance? Check the wiki:

• Home – overview and quick start.
• Sending Mail – GUI walkthrough, command syntax, bulk targets, attachments.
• Automated Mailings – cron tips, scenario library, catch-up behaviour, max-runs.
• Configuration – notifications, storage backends, permissions, GUI theming links.

Requirements

• Paper or Folia 1.20+
• Java 21 runtime
• YskLib 1.6.0 or above

Support

• Issues: GitHub
• Discord: YusakiDev

Deliver mail, gifts, and rewards while players are offline—no clunky chest exchanges needed.