.png?fit=max&auto=format&n=VrRd9ylcA_lbpmt6&q=85&s=4eb75c6784eda09d9cdee2d5224ca0e8){kind=logo}
System Prerequisites
Before installing any Sentry Studios assets, please verify that your server environment meets our baseline technical requirements:Java 17 / 21 TargetFolia Multi-ThreadedPaper / Purpur 1.20 - 1.21.4
Server Platform
Native support for PaperMC, Purpur, and Folia (1.20.x through 1.21.x).
Dependencies
Vault (economy wipes), ProtocolLib (SentrySettings packet engine), and LuckPerms.
Database Engines
Zero-config embedded H2 or multi-server connection pooling on MySQL 8.0+ / MariaDB.
Standard Installation
1
Acquire Licensed Binaries
Download the latest production
.jar releases from the Sentry Studios Client Portal or BuiltByBit.2
Deploy to Plugins Directory
Transfer the jars to
/plugins using SFTP or your server management console (e.g. Pterodactyl, Multicraft).3
Install Companion Dependencies
Ensure necessary companion dependencies are present based on your chosen suite:
4
First Boot & Licensing
Start your server. Upon first boot, each plugin contacts the Sentry licensing cluster to validate your license key, generates embedded database tables, and produces default configuration trees:
Server Console
Recommended Directory Layout
A production-ready server running the Sentry suite will have a clean, modular file structure:plugins
DeluxeMenus
PlaceholderAPI.jar
ProtocolLib.jar
SentryLore
config.yml
messages.yml
license.yml
menu
SentrySettings
config.yml
messages.yml
license.yml
menu
SentryWipe
backups
config.yml
gui.yml
hooks.yml
license.yml
messages.yml
presets.yml
Vault.jar
Database Architecture: H2 vs MySQL
All Sentry products feature unified storage abstraction. Choose the engine best tailored for your architecture:- H2 Embedded (Single Server)
- MySQL / MariaDB (Network Sync)
Zero Configuration Required. H2 is a high-performance, embedded relational database that runs inside your server process without requiring an external MySQL server. It creates a local
.mv.db file in the plugin data folder.config.yml
- Pros: Ultra-fast, zero maintenance, native memory caching, immune to external network drops.
- Best for: Factions, Survival, Skyblock, Prison, or standalone competitive servers.
Common Setup Pitfalls
Plugin fails on startup with UnsupportedClassVersionError
Plugin fails on startup with UnsupportedClassVersionError
Your startup script or Docker container is running Java 8 (version 52) or Java 11 (version 55). Update your environment flags or container image to Java 17 (version 61) or Java 21 (version 65).
SentrySettings fails with ClassNotFoundException: com.comphenix.protocol...
SentrySettings fails with ClassNotFoundException: com.comphenix.protocol...
SentrySettings requires ProtocolLib to operate its client-side packet filters and PvP latency optimizers. Download the latest dev build of ProtocolLib compatible with your server version.
Placeholders appearing as raw %sentrywipe_...% or %sentrysettings_...%
Placeholders appearing as raw %sentrywipe_...% or %sentrysettings_...%
Ensure PlaceholderAPI is installed and active. Sentry plugins hook into PAPI on startup automatically. Run
/papi ecloud download Server and /papi reload to ensure base expansions are loaded.Official Community & Support
Need assistance configuring your server or integrating custom hooks? Join our verified Discord community or submit a ticket:Discord Community
Chat with active server owners, access configuration guides, and report issues.
Open a Support Ticket
Receive direct 1-on-1 developer support for enterprise setups and licensing questions.