Package Locker

Package Locker

When a player’s inventory is full during a package claim, items don’t vanish — they go to the package locker. It’s overflow storage, holding items until the player has room to collect them.

---

How It Works

1. Player claims a package from their mail
2. Courier tries to place items in the player’s inventory
3. If the inventory’s full, overflow items land in the player’s package locker
4. Player gets notified that items are waiting
5. Player claims locker items later when they’ve got space

Note

Pokemon don’t go to the locker. If a player’s party is full, Pokemon go straight to PC storage instead.

---

Player Commands

Command	What It Does
/mail locker	View what’s in your locker
/mail locker claim	Claim all locker items into your inventory

If your inventory’s still full when you run /mail locker claim, items that don’t fit stay in the locker.

---

Configuration

Configure locker behavior in config/courier/config.conf:

lockerExpirationHours = 24
lockerCleanupIntervalMinutes = 30

lockerExpirationHours : Hours before unclaimed locker items expire and are permanently deleted. Default: 24.

lockerCleanupIntervalMinutes : How often the cleanup task runs to purge expired items. Default: 30.

---

Admin Commands

Command	What It Does
/mailadmin locker cleanup	Manually trigger a cleanup cycle, purging all expired items immediately

Useful after server maintenance or when you need to free up storage outside the normal schedule.

---

Expired Items Are Gone Forever

Once locker items expire, they’re permanently deleted. No undo. Make sure your expiration window is generous enough for your player base — especially if you’ve got players in different time zones or who don’t log in every day.

Tip

Remind players to claim locker items promptly. Consider adding a note to your server’s MOTD, or use Courier’s notification system to alert players with pending locker items when they log in.

---

Next Steps

That’s the full core system. Head back to Mail if you need a refresher, or check out Notifications to configure how players are alerted to new mail and locker items.