Installation
Requirements, step-by-step setup, first run, and the plugin folder layout.
This page gets AT-MailBox running on your server. For the buy links, see Download.
Requirements
| Requirement | Needed | Notes |
|---|---|---|
| Spigot or Paper | Yes | Minecraft 1.21 and newer |
| Java | Yes | Java 17 |
| TheAPI | Yes | Config, database, and GUI backend |
| PlaceholderAPI | Optional | Enables the %atmailbox_*% placeholders |
TheAPI is a hard dependency, not a soft one. AT-MailBox declares depend: TheAPI,
so the server refuses to enable the plugin if TheAPI is missing. You get a clean
error in console, not a crash.
JDBC database drivers (SQLite, MySQL, MariaDB, H2) are downloaded automatically by TheAPI. You do not install any driver yourself.
Install steps
Install TheAPI
Download TheAPI and drop it
into plugins/. AT-MailBox will not enable without it.
Install PlaceholderAPI (optional)
If you want the %atmailbox_*% placeholders, drop PlaceholderAPI into plugins/
too. Skip this if you do not use placeholders.
Add AT-MailBox
Move the AT-MailBox jar into plugins/.
Start the server
Start or restart the server. On first run the plugin writes its config and language files (see the layout below).
Check the config
Open plugins/AT-MailBox/config.yml and set your storage backend and capacity
tiers. SQLite works with zero setup. See Configuration.
First run
The first time the server enables AT-MailBox it creates these files:
The default storage backend is SQLite, which writes a single database file inside the plugin folder. Nothing else is needed to start using the mailbox.
Optional integrations
- PlaceholderAPI. Once installed, AT-MailBox hooks in automatically and exposes placeholders for the unclaimed count, capacity, and more. See Placeholders.
- MySQL or MariaDB. To share one mailbox database across a network, set
database.typeand the connection details. See Storage.