SnDevelopmentServer Admins
SnLib is the shared runtime every Sn plugin depends on: learn a behavior once and you know it in every Sn plugin. You install a single plugins/SnLib.jar per server. From then on it is invisible infrastructure: it gives every Sn plugin the same config handling, language files, menus, permissions and update behavior.
This section is written for the person who runs the server, not for anyone writing Java. Because the behaviors are identical across the whole family, they are documented once here instead of in each plugin's docs.
If you learn a behavior in one Sn plugin, you have learned it for all of them.
If you also write plugins on top of SnLib, the developer-facing API lives in the Developers section. This section is only about running a server.
I want to...
| Task | Page |
|---|---|
| Change the wording of any message | Language Files |
| Recolor text with hex codes or gradients | Text, Colors and Numbers |
Show big numbers as 12.3K | Text, Colors and Numbers |
| Move or hide a menu button | Menus |
| Change what a click does, or restrict who sees a button | Menu Items and Clicks |
| Add pages or data-driven rows to a menu | Pagination, Regions and Templates |
| Change an item's material, name, lore or glow | Item Appearance Reference |
| Give an item a recipe, a cooldown or protection | Physical Items |
| Configure the selection wand | Physical Items |
| Run commands, sounds or titles from YAML | Actions and Requirements |
| Rename a command or translate its help | Customizing Commands |
| Move a plugin from SQLite to MySQL | Database Connection |
| Give staff access to admin commands | Permissions |
| Understand why a deleted key comes back | Configuration Files |
| Get update notices to my staff | Updates |
| Update SnLib itself | Updates |
| Capture debug output for a bug report | The /snlib Command |
Pages in this section
- Installation and Requirements - Java, supported servers, the version handshake and the restart rule.
- Configuration Files - the merge that updates your YAML without overwriting your edits.
- Text, Colors and Numbers - color codes, MiniMessage, the
[small]/[rgb]/[center]tags and number hints. - Language Files - every message, the prefix rules and safe fallbacks.
- Customizing Commands - command aliases and translatable help.
- Menus - the menu file: layout, sounds and close actions.
- Menu Items and Clicks - buttons, the per-click matrix and view requirements.
- Pagination, Regions and Templates - pages, data-driven regions and reusable templates.
- Item Appearance Reference - every appearance key, shared by menus and physical items.
- Physical Items -
items.yml: properties, protection, recipes and the wand. - Actions and Requirements - the
[tag] argumentmini-language and its conditions. - Database Connection - the
database:block, SQLite and MySQL. - Permissions - the
<plugin>.adminconvention and SnLib's own nodes. - Updates - the notify-only checker and the SnLib self-updater.
- The /snlib Command - the diagnostic command, subcommand by subcommand.
- Shared Value Formats - sounds, durations, cron and typed numbers.
- Troubleshooting - console lines you may see and their fixes.
Related pages
- Installation and Requirements - start here on a fresh server.
- The /snlib Command - your first diagnostic step when something looks off.
- Troubleshooting - when a console line needs decoding.