LamMailBox
A mailbox system for Minecraft servers that allows players to send items, messages, and commands between each other.
Автор: YusakiDev7064обновлён 2 июл. 2026 г.
Механики игрыУправлениеУтилиты
Описание
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 sendor 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,
\nline 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), orall(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
| Command | Permission | Description |
|---|---|---|
/lmb | lammailbox.open | Open your mailbox |
/lmb <player> | lammailbox.open.others | View another player's mailbox |
/lmb view <id> | (no permission) | View mail by ID (if you can access it) |
/lmb as <player> | lammailbox.view.as | View mail UI as another player |
/lmb send <player> <message> | lammailbox.admin | Send mail via command or console |
/lmb mailings | lammailbox.admin | View cron/first-join automation dashboard |
/lmbreload | lammailbox.reload | Reload configuration files |
/lmbmigrate <from> <to> | lammailbox.migrate | Migrate mail between storage backends (yaml/sqlite) |
Aliases: /mailbox, /mail
Additional Permissions
| Permission | Description |
|---|---|
lammailbox.compose | Create and send new mail through GUI |
lammailbox.items | Add items to mail when composing |
lammailbox.delete | Delete sent mail from sent mail view |
Setup
- Drop the jar in
plugins/and start the server to generate config/database files. - Edit
plugins/LamMailBox/config.ymlto customize GUI text, slots, notification settings, and default expiry days. Setenabled: falseon any button entry to remove it from the interface. Decoration fillers can run console commands via thecommandslist, with%player%and%uuid%placeholders. - Grant the permissions that fit your ranks.
- Compose mail through the GUI or use
/lmb send; set up recurring deliveries inmailings.ymlfor cron or first-join workflows (/lmb mailingsshows 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
Deliver mail, gifts, and rewards while players are offline—no clunky chest exchanges needed.
Галерея
Последние версии
Все версии →release
LamMailBox 1.7.4
1.7.42 июл. 2026 г.144Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur
Что нового
- Fixed "Message not found" appearing in the receiver slot of the mail creation screen after selecting a receiver.
- Fixed the page indicator button potentially showing "Message not found" instead of the page number.
- The config updater now restores any missing options from the default config on startup, not just messages. Existing values and customizations are always preserved (a backup is created first).
release
LamMailBox 1.7.2
1.7.226 июн. 2026 г.16Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11folia, paper, purpur
Что нового
- Fixed the Command Items button showing "Message not found" instead of its name.
- Fixed scheduled delivery and expiry times showing `%schedule_time%` text instead of the real time (or "Not set").
- Fixed the current message preview disappearing while composing mail.
release
LamMailBox 1.7.1
1.7.115 июн. 2026 г.31Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11folia, paper, purpur
Что нового
## LamMailBox 1.7.1
### Fixed
- Fixed sent-mail views allowing players to place or drag items into read-only GUI slots.
- Fixed player-inventory click paths that could bypass GUI cancellation in mailbox views.
- Players without `lammailbox.compose` no longer see the Create Mail or View Sent Mail buttons.
### Notes
- No config changes required.
- Existing `settings.permissions.compose` controls both main mailbox action buttons.
release
LamMailBox 1.7.0
1.7.013 июн. 2026 г.18Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11folia, paper, purpur
Что нового
## LamMailBox 1.7.0
### Fixed
- Fixed the Add Items menu saving GUI control buttons as real mail attachments.
- The Back button will no longer be added to the player's inventory or included in sent mail items.
- Customized item editor control slots in `config.yml` are now respected consistently.
### Improved
- Save and close behavior in the Add Items menu now use the same item collection logic, preventing control items from leaking into mail contents.
- Added regression coverage for the Add Items menu control-slot behavior.
release
LamMailBox 1.6.0
1.6.019 янв. 2026 г.57Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11folia, paper, purpur
Что нового
- Add Manual Mailings
More info here: https://github.com/LamaliaNetwork/LamMailBox/wiki/Automated-Mailings#manual-trigger
release
LamMailBox 1.5.4
1.5.45 янв. 2026 г.122Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11folia, paper, purpur
Что нового
- Fix Messaging with latest ysklib 1.6.9 (Required)
release
LamMailBox 1.5.3
1.5.310 окт. 2025 г.68Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10folia, paper, purpur
Что нового
## Highlights ✨
- **Config-driven command aliases** – `/lmb` now syncs its aliases from `settings.command-aliases.lmb`, falling back to legacy configs and updating live on `/lmbreload` so clickable prompts always point at the primary alias.
## Configuration & UX 🛠️
- Default `config.yml` bumped to version 1.7 with expanded comments, optional custom-model-data hooks, and unified placeholder handling across messages and GUI elements.
## Dependency Notes 📦
- Requires **YskLib 1.6.7+** for the updated MessageManager and command alias utilities.
release
LamMailBox 1.5.2
1.5.28 окт. 2025 г.27Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10folia, paper, purpur
Что нового
This is a light maintenance release that swaps LamMailBox onto the shared YskLib messaging helper and tidies a few internal workflows. Gameplay, commands, and configs behave exactly as before.
## Updates ✨
- **MessageManager integration (internal)** – messages are now cached at startup via YskLib, trimming a little overhead when the plugin sends frequent notifications.
- **Dual placeholder support everywhere** – both `{placeholder}` and legacy `%placeholder%` formats are accepted across commands, GUIs, and config entries.
- Small responsiveness improvements from polishing GUI click handling and item rendering paths.
## Fixes 🛠️
- Strengthened error handling in GUI click events to prevent potential edge-case issues
- Improved code maintainability to enable faster bug fixes in future releases
## Changes 🔄
- Config version incremented to 1.7 to reflect the placeholder helper swap (existing `%placeholder%` lines remain valid—no edits required).
- YskLib dependency bumped to **1.6.4+** so the shared MessageManager feature is available.
- Internal GUI helpers were grouped into focused classes for navigation, pagination, styling, and command item composition to keep future maintenance simple.
release
LamMailBox 1.5.1
1.5.14 окт. 2025 г.49Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9folia, paper, purpur
Что нового
## Updates ✨
- Added pagination to mailbox and sent mail GUIs, keeping each viewer's page state and exposing configurable previous/next buttons plus a page indicator.
- Introduced custom model data support across GUI decorations, command items, and mailings so resource-pack overrides display consistently in previews and persisted mail.
- Expanded composer and review screens with back buttons and editor shortcuts, making it easier to jump between the mailbox, sent list, and item editors while drafting mail.
## Fixes 🛠️
- Apply configuration-driven item meta without overwriting existing lore or custom model data, preserving detailed previews for stored mail, decorations, and command bundles.
- Restored legacy command items by falling back to the generic action key when specialized metadata is missing, keeping older configurations clickable.
## Changes 🔄
- Raised the default configuration schema to 1.6 and added pagination/back-button/custom-model entries throughout `config.yml`, alongside matching guidance in `mailings.yml`.
- SQLite storage now migrates `mail_command_items` to add a `custom_model_data` column and persists the optional value parallel to YAML command item definitions.
## Notes 📌
- Use the command item editor's new custom model button to set a numeric model id or type `CLEAR` to reset, and update page button slots/materials to fit your layout before deployment.
- `%current%` and `%total%` placeholders populate the pagination indicator text; translate the new config messages/titles if you localize player-facing strings.
- If you upgraded from v1.5 or earlier, edit `gui.main.items.mail-display.slots` to free the bottom row (slots 37–44) so the next-page button has room; otherwise pagination controls stay hidden.
- Back up your data before upgrading so the automatic column migration and config updater can run safely, then `/lmbreload` to refresh GUI layouts after adjusting defaults.
release
LamMailBox 1.5.0
1.5.03 окт. 2025 г.22Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9folia, paper, purpur
Что нового
## Updates ✨
- Introduced automated mailings defined in `mailings.yml`, supporting cron-based schedules, first-join delays, permission gates, and Folia-safe delivery with automatic player notifications.
- Added the `/lmb mailings` admin command with live status reporting (last/next run previews, run counters) backed by YAML and SQLite repositories.
- Expanded the mail composer: schedule or expire deliveries via the GUI clock, build reusable console command bundles with the new command-item editor, and preview current receivers/messages directly in the interface.
- Upgraded `/lmb send` to accept inline sections (`| [commands] | schedule:YYYY:MM:DD:HH:mm | expire:YYYY:MM:DD:HH:mm`) so console and admins can queue timed or command-driven mail in one call.
## Fixes 🛠️
- Blocked players from mailing themselves and added capacity checks before accepting new receivers to prevent overfilled mailboxes.
- Restricted bulk recipient and command attachment actions to admins, ensuring permission checks mirror the GUI workflow.
- Added sent-mail deletion confirmation and safeguarded composer/item GUI closures so items return to players instead of being lost.
- Normalized `allonline` targets to snapshot current online players before storage, ensuring scheduled deliveries reach the correct recipients.
## Changes 🔄
- Bumped configuration schema to 1.4 with expanded messages, titles, and GUI metadata plus the new `mailings.auto-cleanup` toggle for status pruning.
- Mail records now capture optional schedule and expiry timestamps, defaulting expiration from `settings.default-expire-days` when unspecified.
- Command attachments persist as structured "command items" (YAML `command-items` section or SQLite `mail_command_items` table) while retaining legacy command lists for backward compatibility.
## Notes 📌
- Cron expressions follow the UNIX format (`m h dom mon dow`); disable any definition by setting `enabled: false`.
- `mailings.yml` is generated on first run—review default examples before enabling automation in production.
- Back up your YAML/SQLite data before upgrading; the plugin will auto-create the new `mail_command_items`/`mailing_status` tables and `mailing-status.yml` file on startup.
- Reloading via `/lmbreload` refreshes mailing definitions, runs auto-cleanup, and reports active IDs for quick verification.