Nucleus - The Ultimate Essentials Plugin

A new version has been released for Nucleus, it is available for download here.


This is a major release - Nucleus 2.4.0 for Sponge API version 7.3

This was built from Nucleus commit: d4ec0f9e9

Release Notes

If you’re having trouble, visit our Discord channel: https://discord.gg/A9QHG5H


API Changes

Added NucleusTextTemplate#getBody(CommandSource sender) and companion methods

In order to support sending broadcasts to Discord when using MagiBridge, the NucleusTextTemplate that is returned from NucleusTextTemplateEvent#getMessage() now has a set of getBody methods to support getting unprefixed messages.

Added isFirstJoin to NucleusKitEvent.Redeem

This allows plugin developers to know if a kit is being redeemed because a player has joined for the first time (at least as far as Nucleus is concerned).

Minor Changes

  • First join kits with commands will now have their commands executed a tick later to ensure that the player has completely joined.

General Notes

  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.

A new version has been released for Nucleus, it is available for download here.


This is a bug fix and minor feature release - Nucleus 2.4.1 for Sponge API version 7.3

This was built from Nucleus commit: c8e332612

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Minor Updates

Added a placeholder token to display the cooldown for a given kit

You can now add the token {{kitcooldown|<kitname>}} wherever Nucleus placeholders are parsed to display the cooldown for a given kit.

Bug Fixes

  • Fixed a startup issue preventing Nucleus from running in single player (thanks to Dockter)
  • Colour code permissions are now case insensitive
  • /me now displays correctly

General Notes

  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.

A new version has been released for Nucleus, it is available for download here.


This is a bug fix and minor feature release - Nucleus 2.4.1 for Sponge API version 7.3

This was built from Nucleus commit: c8e332612

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Minor Updates

Added a placeholder token to display the cooldown for a given kit

You can now add the token {{kitcooldown|<kitname>}} wherever Nucleus placeholders are parsed to display the cooldown for a given kit.

Bug Fixes

  • Fixed a startup issue preventing Nucleus from running in single player (thanks to Dockter)
  • Colour code permissions are now case insensitive
  • /me now displays correctly

General Notes

  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.

A new version has been released for Nucleus, it is available for download here.


This is a beta version of Nucleus 3.0.0 for Sponge API version 8.0

THIS IS A BETA VERSION. IT MAY NOT BE STABLE. DO NOT USE ON PRODUCTION SERVERS

Please report any issues to Github Issues (Issues · NucleusPowered/Nucleus · GitHub) CLEARLY stating the version of Nucleus you are using.

This was built from Nucleus commit: f9fb6074c

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Nucleus 3.0 BETA for Sponge API 8+ (Minecraft 1.16.5+)

Nucleus 3 is a major rewrite of pretty much the entire plugin to support SpongeAPI 8.0.

As it stands, Nucleus 3 is NOT 100% stable. Please help testing, and please let us know of any bugs on Github issues!

No docs are available either, but most of v3 will operate on a user level the same as v2. Documentation will follow at a later stage.

If you are upgrading from a previous version, data conversion is NOT GUARANTEED at this stage. Please make a backup BEFORE upgrading. AS ALWAYS, WE ARE NOT RESPONSIBLE FOR DATA LOSS.

Changes and updates will be provided in future release notes, but most of what you know should still be there.


General Notes

  • This is an BETA version. It may be unstable.
  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.

(The tag for this was set incorrectly, it is not lts)

1 Like

A new version has been released for Nucleus, it is available for download here.


This is a beta version of Nucleus 3.0.0 for Sponge API version 8.0

THIS IS A BETA VERSION. IT MAY NOT BE STABLE. DO NOT USE ON PRODUCTION SERVERS

Please report any issues to Github Issues (Issues · NucleusPowered/Nucleus · GitHub) CLEARLY stating the version of Nucleus you are using.

This was built from Nucleus commit: ae5d5dc02

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Nucleus 3.0 BETA

Nucleus 3 is a major rewrite of pretty much the entire plugin to support SpongeAPI 8.0.

As it stands, Nucleus 3 is NOT 100% stable. Please help testing, and please let us know of any bugs on Github issues!

No docs are available either, but most of v3 will operate on a user level the same as v2. Documentation will follow at a later stage.

If you are upgrading from a previous version, data conversion is NOT GUARANTEED at this stage. Please make a backup BEFORE upgrading. AS ALWAYS, WE ARE NOT RESPONSIBLE FOR DATA LOSS.

Changes and updates will be provided in future release notes, but most of what you know should still be there.

Changes from 3.0.0 Beta 1

The following issues have been addressed:

  • Sometimes, attempting to read the Spawn configuration when a player joins causes a null exception. This has been worked around, a proper fix is being investigated.
  • Nucleus no longer uses ResourcePacks for copying assets as they are not implemented in SpongeForge as of yet.

General Notes

  • This is an BETA version. It may be unstable.
  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.

A new version has been released for Nucleus, it is available for download here.


This is a bug fix and minor feature release - Nucleus 2.4.2 for Sponge API version 7.3

This was built from Nucleus commit: 0be223b55

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Kit Commands are now disabled by default

A very common question that comes up in the Nucleus support channels is “why can my players redeem kits without a cooldown?” This is invariably because server owners incorrectly assume that nucleus.kit is permission they need for accessing /kit. It is not. The permission is nucleus.kit.base.

The reason that nucleus.kit works is because in Sponge, nucleus.kit is the same as Bukkit’s nucleus.kit.*. As a result, by granting nucleus.kit you are giving players the ability to bypass cooldowns, redeem kits as many times as they like, and create kits – including command kits. These permissions are super dangerous to let anyone have. If you are running a server and you have given the nucleus.kit permission to players - whitelist your server and kick all players RIGHT NOW while you fix permissions and check for any kits that you didn’t make.

Because this is too common a problem, this update to Nucleus will disable commands in kits by default. You will need to go into the kits section of the config to re-enable them, then reload your config in the normal way. I apologise to those of you that have entered your permissions properly, however I do not want to continue seeing servers put themselves into a dangerous position because they have guessed the permissions they need to use, rather than read the docs, therefore not using the base suffix to permissions.

Please note that this defaults to false for EVERYBODY, as I want to try to catch servers that are doing this so they are protected while they fix their permissions.


General Notes

  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.
1 Like

A new version has been released for Nucleus, it is available for download here.


This is a beta version of Nucleus 3.0.0 for Sponge API version 8.1

THIS IS A BETA VERSION. IT MAY NOT BE STABLE. DO NOT USE ON PRODUCTION SERVERS

Please report any issues to Github Issues (Issues · NucleusPowered/Nucleus · GitHub) CLEARLY stating the version of Nucleus you are using.

This was built from Nucleus commit: 2ad7280

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Nucleus 3.0 BETA

Nucleus 3 is a major rewrite of pretty much the entire plugin to support SpongeAPI 8.0.

As it stands, Nucleus 3 is NOT 100% stable. Please help testing, and please let us know of any bugs on Github issues!

No docs are available either, but most of v3 will operate on a user level the same as v2. Documentation will follow at a later stage.

If you are upgrading from a previous version, data conversion is NOT GUARANTEED at this stage. Please make a backup BEFORE upgrading. AS ALWAYS, WE ARE NOT RESPONSIBLE FOR DATA LOSS.

Changes and updates will be provided in future release notes, but most of what you know should still be there.

Changes from 3.0.0 Beta 2

Thank you to everyone who has been reporting issues to be, either directly or via Github Issues

  • Home related commands now function correctly.
  • Commands that open an Inventory GUI now function correctly.
  • /vanish now works correctly
  • Fix exception when getting some messages
  • Fix staff chat not working as expected
  • Disabled kit commands by default to protect servers against misconfigured permissions.
  • Now using SpongeAPI 8.1

Changes from 3.0.0 Beta 1

The following issues have been addressed:

  • Sometimes, attempting to read the Spawn configuration when a player joins causes a null exception. This has been worked around, a proper fix is being investigated.
  • Nucleus no longer uses ResourcePacks for copying assets as they are not implemented in SpongeForge as of yet.

General Notes

  • This is an BETA version. It may be unstable.
  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.
1 Like

A new version has been released for Nucleus, it is available for download here.


This is a beta version of Nucleus 3.0.0 for Sponge API version 8.1

THIS IS A BETA VERSION. IT MAY NOT BE STABLE. DO NOT USE ON PRODUCTION SERVERS

Please report any issues to Github Issues (Issues · NucleusPowered/Nucleus · GitHub) CLEARLY stating the version of Nucleus you are using.

This was built from Nucleus commit: 878aaca

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Nucleus 3.0 BETA

Nucleus 3 is a major rewrite of pretty much the entire plugin to support SpongeAPI 8.0.

As it stands, Nucleus 3 is NOT 100% stable. Please help testing, and please let us know of any bugs on Github issues!

No docs are available either, but most of v3 will operate on a user level the same as v2. Documentation will follow at a later stage.

If you are upgrading from a previous version, data conversion is NOT GUARANTEED at this stage. Please make a backup BEFORE upgrading. AS ALWAYS, WE ARE NOT RESPONSIBLE FOR DATA LOSS.

Changes and updates will be provided in future release notes, but most of what you know should still be there.

Changes from 3.0.0 Beta 3

This is a quick fix to prevent the biggest errors with commands. Future updates will refine these.

  • Fix NPE in certain failure conditions
  • Workaround to commands where messages may not be displayed.

Changes from 3.0.0 Beta 2

Thank you to everyone who has been reporting issues to be, either directly or via Github Issues

  • Home related commands now function correctly.
  • Commands that open an Inventory GUI now function correctly.
  • /vanish now works correctly
  • Fix exception when getting some messages
  • Fix staff chat not working as expected
  • Disabled kit commands by default to protect servers against misconfigured permissions.
  • Now using SpongeAPI 8.1

Changes from 3.0.0 Beta 1

The following issues have been addressed:

  • Sometimes, attempting to read the Spawn configuration when a player joins causes a null exception. This has been worked around, a proper fix is being investigated.
  • Nucleus no longer uses ResourcePacks for copying assets as they are not implemented in SpongeForge as of yet.

General Notes

  • This is an BETA version. It may be unstable.
  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.

A new version has been released for Nucleus, it is available for download here.


This is a beta version of Nucleus 3.0.0 for Sponge API version 8.1

THIS IS A BETA VERSION. IT MAY NOT BE STABLE. DO NOT USE ON PRODUCTION SERVERS

Please report any issues to Github Issues (Issues · NucleusPowered/Nucleus · GitHub) CLEARLY stating the version of Nucleus you are using.

This was built from Nucleus commit: adf49e9

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Nucleus 3.0 BETA

Nucleus 3 is a major rewrite of pretty much the entire plugin to support SpongeAPI 8.0.

As it stands, Nucleus 3 is NOT 100% stable. Please help testing, and please let us know of any bugs on Github issues!

No docs are available either, but most of v3 will operate on a user level the same as v2. Documentation will follow at a later stage.

If you are upgrading from a previous version, data conversion is NOT GUARANTEED at this stage. Please make a backup BEFORE upgrading. AS ALWAYS, WE ARE NOT RESPONSIBLE FOR DATA LOSS.

Changes and updates will be provided in future release notes, but most of what you know should still be there.

Changes from 3.0.0 Beta 4

  • This reverts the workaround below, make sure you’re using the latest versions of Sponge.
  • Fix /tpa not working with an Unknown Error.

Changes from 3.0.0 Beta 3

This is a quick fix to prevent the biggest errors with commands. Future updates will refine these.

  • Fix NPE in certain failure conditions
  • Workaround to commands where messages may not be displayed.

Changes from 3.0.0 Beta 2

Thank you to everyone who has been reporting issues to be, either directly or via Github Issues

  • Home related commands now function correctly.
  • Commands that open an Inventory GUI now function correctly.
  • /vanish now works correctly
  • Fix exception when getting some messages
  • Fix staff chat not working as expected
  • Disabled kit commands by default to protect servers against misconfigured permissions.
  • Now using SpongeAPI 8.1

Changes from 3.0.0 Beta 1

The following issues have been addressed:

  • Sometimes, attempting to read the Spawn configuration when a player joins causes a null exception. This has been worked around, a proper fix is being investigated.
  • Nucleus no longer uses ResourcePacks for copying assets as they are not implemented in SpongeForge as of yet.

General Notes

  • This is an BETA version. It may be unstable.
  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.

A new version has been released for Nucleus, it is available for download here.


This is a beta version of Nucleus 3.0.0 for Sponge API version 8.1

THIS IS A BETA VERSION. IT MAY NOT BE STABLE. DO NOT USE ON PRODUCTION SERVERS

Please report any issues to Github Issues (Issues · NucleusPowered/Nucleus · GitHub) CLEARLY stating the version of Nucleus you are using.

This was built from Nucleus commit: 1060818

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Nucleus 3.0 BETA

Nucleus 3 is a major rewrite of pretty much the entire plugin to support SpongeAPI 8.0.

As it stands, Nucleus 3 is NOT 100% stable. Please help testing, and please let us know of any bugs on Github issues!

No docs are available either, but most of v3 will operate on a user level the same as v2. Documentation will follow at a later stage.

If you are upgrading from a previous version, data conversion is NOT GUARANTEED at this stage. Please make a backup BEFORE upgrading. AS ALWAYS, WE ARE NOT RESPONSIBLE FOR DATA LOSS.

Changes and updates will be provided in future release notes, but most of what you know should still be there.

Changes from 3.0.0 Beta 5

Fixes user and general data not being saved due to various bugs.

Changes from 3.0.0 Beta 4

  • This reverts the workaround below, make sure you’re using the latest versions of Sponge.
  • Fix /tpa not working with an Unknown Error.

Changes from 3.0.0 Beta 3

This is a quick fix to prevent the biggest errors with commands. Future updates will refine these.

  • Fix NPE in certain failure conditions
  • Workaround to commands where messages may not be displayed.

Changes from 3.0.0 Beta 2

Thank you to everyone who has been reporting issues to be, either directly or via Github Issues

  • Home related commands now function correctly.
  • Commands that open an Inventory GUI now function correctly.
  • /vanish now works correctly
  • Fix exception when getting some messages
  • Fix staff chat not working as expected
  • Disabled kit commands by default to protect servers against misconfigured permissions.
  • Now using SpongeAPI 8.1

Changes from 3.0.0 Beta 1

The following issues have been addressed:

  • Sometimes, attempting to read the Spawn configuration when a player joins causes a null exception. This has been worked around, a proper fix is being investigated.
  • Nucleus no longer uses ResourcePacks for copying assets as they are not implemented in SpongeForge as of yet.

General Notes

  • This is an BETA version. It may be unstable.
  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.

A new version has been released for Nucleus, it is available for download here.


This is a beta version of Nucleus 3.0.0 for Sponge API version 8.1

THIS IS A BETA VERSION. IT MAY NOT BE STABLE. DO NOT USE ON PRODUCTION SERVERS

Please report any issues to Github Issues (Issues · NucleusPowered/Nucleus · GitHub) CLEARLY stating the version of Nucleus you are using.

This was built from Nucleus commit: 81b5162

Release Notes

If you’re having trouble, visit our Discord channel: Nucleus


Nucleus 3.0 BETA

Nucleus 3 is a major rewrite of pretty much the entire plugin to support SpongeAPI 8.0.

As it stands, Nucleus 3 is NOT 100% stable. Please help testing, and please let us know of any bugs on Github issues!

No docs are available either, but most of v3 will operate on a user level the same as v2. Documentation will follow at a later stage.

If you are upgrading from a previous version, data conversion is NOT GUARANTEED at this stage. Please make a backup BEFORE upgrading. AS ALWAYS, WE ARE NOT RESPONSIBLE FOR DATA LOSS.

Changes and updates will be provided in future release notes, but most of what you know should still be there.

Changes from 3.0.0 Beta 6

  • Creating a kit using /kit create or editing using /kit edit no longer causes duplicate items when adding a stack to the inventory
  • Kits now load from file, the loading routine was incomplete and failing
  • An error that occurred when running /seen has been resolved
  • User homes are now retains across server restarts (they were saved, but not loaded properly)

Changes from 3.0.0 Beta 5

Fixes user and general data not being saved due to various bugs.

Changes from 3.0.0 Beta 4

  • This reverts the workaround below, make sure you’re using the latest versions of Sponge.
  • Fix /tpa not working with an Unknown Error.

Changes from 3.0.0 Beta 3

This is a quick fix to prevent the biggest errors with commands. Future updates will refine these.

  • Fix NPE in certain failure conditions
  • Workaround to commands where messages may not be displayed.

Changes from 3.0.0 Beta 2

Thank you to everyone who has been reporting issues to be, either directly or via Github Issues

  • Home related commands now function correctly.
  • Commands that open an Inventory GUI now function correctly.
  • /vanish now works correctly
  • Fix exception when getting some messages
  • Fix staff chat not working as expected
  • Disabled kit commands by default to protect servers against misconfigured permissions.
  • Now using SpongeAPI 8.1

Changes from 3.0.0 Beta 1

The following issues have been addressed:

  • Sometimes, attempting to read the Spawn configuration when a player joins causes a null exception. This has been worked around, a proper fix is being investigated.
  • Nucleus no longer uses ResourcePacks for copying assets as they are not implemented in SpongeForge as of yet.

General Notes

  • This is an BETA version. It may be unstable.
  • Some plugins and mods are known to be incompatible with Nucleus. See Compatibility for more information.