Перейти к содержимому
Mineforgian

LamMailBox

A mailbox system for Minecraft servers that allows players to send items, messages, and commands between each other.

Загрузки
471
Подписчики
4
Обновлён
2 июля 2026 г.
Лицензия
GPL-3.0-only

Опубликован 18 сентября 2025 г.

Исходный кодСообщить об ошибке

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.

main page mail creation page

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

  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

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

Ченджлог

1.7.4Релиз1.21.9, 1.21.10, 1.21.11 · 2 июля 2026 г.
  • 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).
1.7.2Релиз1.21.9, 1.21.10, 1.21.11 · 26 июня 2026 г.
  • 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.
1.7.1Релиз1.21.9, 1.21.10, 1.21.11 · 15 июня 2026 г.

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.
1.7.0Релиз1.21.9, 1.21.10, 1.21.11 · 13 июня 2026 г.

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.
1.6.0Релиз1.21.9, 1.21.10, 1.21.11 · 19 января 2026 г.
1.5.4Релиз1.21.9, 1.21.10, 1.21.11 · 5 января 2026 г.
  • Fix Messaging with latest ysklib 1.6.9 (Required)
1.5.3Релиз1.21.8, 1.21.9, 1.21.10 · 10 октября 2025 г.

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.
1.5.2Релиз1.21.8, 1.21.9, 1.21.10 · 8 октября 2025 г.

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.

Комментарии

Загружаем…