Skip to content
Cristóbal Veas edited this page Dec 16, 2025 · 7 revisions

Welcome to the Akropolis wiki!

Akropolis is a modern Minecraft hub server solution that is based on DeluxeHub by ItsLewizz. It contains almost all of its features and configuration files are almost the same, so you can just drop your configuration into the plugin's directory, make a few modifications and use it.

The main difference between Akropolis and DeluxeHub is that Akropolis uses more modern technologies, like MiniMessage, the Paper API and updated Java versions. While this give us some performance and usability benefits, it also means that we won't be giving support to older versions of Minecraft and other Minecraft server software that isn't derivated from Paper, which is not the case of DeluxeHub. Simply use what you feel meets your needs.

Quick guides

Install

To use this plugin just a grab a binary from the releases page or compile it yourself and drop it into your plugins/ directory. Take in mind that you will need to be running the latest version of Paper (there could be a delay if there was a recent Minecraft update) so Akropolis can run properly. You can download Paper from here.

Compile

Compiling Akropolis is pretty simple, just one command and you're ready to go:

Linux (and other UNIX derivatives):

./gradlew shadowJar

Windows:

gradlew.bat shadowJar

Then you will find the binary under the build/libs/ directory.

Report bugs or request features

Reporting a bug or requesting a feature can be useful for further development of the plugin. To do that you just need to fill one of the issue templates we made for you: Click here to report a bug or click here to request a feature.

Contribute

At the moment we don't have a lot of requirements to contribute, just make sure to clarify the features or fixes that you introduce in your pull request and try to follow the Conventional Commits specification.

FAQ

What is MiniMessage?

The MiniMessage format is a simple string representation of chat components, designed to be easy for end users to learn, and for developers to extend.

This modern format allows us to include hovers, gradients and more inside Akropolis in a simple way, by replacing the legacy format that can be confusing for new Minecraft players and using intuitive tags that describe what they're doing. A pretty straightforward way to learn about this format is to checkout the documentation. There's also a previewer available if you want to test how your message will be seen beforehand: MiniMessage Viewer.

Why is Akropolis ignoring my PAPI placeholder?

To maintain consistency across the plugin, Akropolis parses PlaceholderAPI's placeholders inside a custom tag <papi:placeholder> where placeholder is your PAPI placeholder without %. A few examples can be seen below:

  • %luckperms_prefix% -> <papi:luckperms_prefix> (or <luckperms_prefix> if you use MiniPlaceholders!)
  • %progress_bar_{bungee_survival}_c:&a■_p:&e■_r:&7■_l:10_m:100_fullbar:&aCompleted!% -> <papi:'progress_bar_{bungee_survival}_c:&a■_p:&e■_r:&7■_l:10_m:100_fullbar:&aCompleted!'> (notice that we use quotes when a placeholder has special characters)

What is MiniPlaceholders?

MiniPlaceholders is an alternative to plugins like PlaceholderAPI, that supports MiniMessage natively, so there's no need to do any weird conversions internally when using this kind of placeholders. Also, they look a lot nicer than using the previously described PAPI tag. You can find more information about it by taking a look at the MiniPlaceholders' documentation!