Skip to content

Implementing Project Poseidon In Production

Rhys B edited this page Jul 12, 2020 · 2 revisions

Implementing Project Poseidon In Production

Please read this whole page before implementing Project Poseidon on your server, especially if your server is public.


General Infomation

Although Project Poseidon is a drop-in replacement for regular CraftBukkit, please make sure to test Project Poseidon outside of the production environment (generally good practice) before making the full change over to Poseidon.

Plugin Compatibility

Project Poseidon is built on top of CraftBukkit CB1060-1092, meaning Poseidon should be already compatible with most if not all Bukkit plugins, however, there can always be exceptions. Plugins that use reflections on CraftBukkit such as Spout, Oreobfuscators, etc may not function on Poseidon if method or function names have been changed. Please make sure to test Poseidon's compatibility with these types of plugins before deploying to production.

Plugins that directly scan and use data in the player data directory in the world folder might have issues if using UUIDs to save player data, although no publically known plugins do this. This conflict can be fixed by getting player data files by the players UUID (Developers), or by disabling saving player data by UUIDs in the Poseidon config (Server Owners).

Player Data (Inventories, Positions) Conversion

By default, Poseidon will convert player data from being saved under usernames to under UUIDs, similar to modern servers. This conversion allows for players to change their usernames on Mojangs website without losing their inventories, or positions. A player's data will be converted when they join, resaving their data under the appropriate UUID. The conversion process will affect a servers ability to change back to regular CraftBukkit or to another server software that doesn’t support Mojang UUIDs. If you are not sure if you will use Poseidon in the long term, you can disable UUID support in Poseidon.yml by setting settings.save-playerdata-by-uuid in poseidon.yml to false.

Issues And Bugs

Please report any issues or bugs you have on the issues page or contact us through our Discord. We will be more than happy to assist with any issues.