Nucleus released this version on Feb 27, 2017

3.3 MB

This is the 1.11.2 build

Nucleus 0.25.0 is available for Sponge API 5.1 and Sponge API 6-SNAPSHOT. Documentation can be found at http://nucleuspowered.org/docs (command and permission references should already be up to date).

Note that there are now two builds for Nucleus. Use S5.1 for 1.10.2 servers, S6 for 1.11.2 servers. Downloads are at the bottom of the page.

NucleusMixins, an optional companion plugin for Nucleus, is available for Sponge API 5 (Minecraft 1.10.2) servers, and will provide a workaround for /invsee not working as intended, and enhanced world generation by hooking into Minecraft internals (known as “NMS” to some players). It is entirely optional, and may not work on heavily modded servers. If you wish to turn off either the /invsee or enhanced world generation mixins, you can do so by setting the relavent option in mixins.conf.

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

Important Changes & Notices

Rules are now in rules.txt

The previous way of setting rules in main.conf was very restrictive, so rules are now in the rules.txt file. All your rules will migrate, so no steps are immediately needed by you.

New Features

Would you like a few commands with that kit?

Command Kits are here! Perhaps one of the more requested features for Nucleus is the ability to add commands to kits, and they are kitted out with them now!

It’s very important to note that any command will be run by the console, so only give the ability to add commands to kits to highly trusted players. As a result, the kit command add permission, kit.command.add.base is in the NONE group for permissions to try to protect against rouge admins.

Viewing the commands in a kit

/kit command <kit> lists the commands, and if you have permission to remove commands, they can be removed from this list too.


Permission: kit.command.base

Adding a command

The command to add a command to a kit is /kit command add <kit> <command>, where the command should not start with a /, and anywhere you want to substitute the player’s name, you should add {{player}}.

So, to broadcast a player’s name, you could write: {{player}} just opened a kit, and this would broadcast dualspiral just opened a kit if I opened the kit. Similarly, if I wanted to smite someone who opened a kit, then I’d use smite {{player}}, etc.

Permission: kit.command.add.base

Removing and clearing commands

To remove commands: /kit command remove|- <kit> <command|index from list> To remove all commands: /kit command clear

I would normally recommend using the list to remove commands, but you can also type the full command to remove or use the (one-based) index from the /kit command list.

Permission: kit.command.remove.base

Edit GUI

I have also added an experiemental “edit” command which opens up an Inventory with books containing the commands that can be taken out, and replaced with new books. These books must only contain one command each, but can span multiple pages as long as no newlines exist.

You can try it with /kit command edit <kit>, with the permission kit.command.edit.base. Same caveats apply as with the add command.

Improved Timespan arguments.

A minor quality of life change, anywhere you can use a Timespan argument, such as 1h or 30m, you can now omit the unit if you want to specify seconds.

New Permission contexts for muted players

Much like for jailed players in the previous release, now if a player is jailed, they will now have an extra context:

  • The nucleus_muted context simply exists with value “true” if the player has been muted.

These contexts can be used to setup specialised permissions for when a player is muted when using a compatable permissions plugin.

Jailing and Muting countdown changes

There are now two new options in main.conf, jail.jail-time-counts-online-only and mute.mute-time-counts-online-only. If these are set to true, any jail/mute time served must be served online - the timer will pause when the player logs off.

Rules updates

As mentioned, rules are now in the rules.txt file. This file works exactly like the MOTD file, and tokens can be used in them. The title for the rules menu can be specified in main.conf.

Note that the /rules add and /rules delete commands have been removed.

Mail Filters

Mail Filters, which allow you to do rudamentary searching of messages, have been around for about a year, but some of them were broken. They’ve been re-written now.

You can use /mail read <filters>, where the filters are:

  • p:<player> - filter by player
  • c: - include the console (this is a new filter)
  • m:<word> - filter by substring in message
  • b:<days> - only show messages before this number of days
  • a:<days> - only show messages after this number of days

So, /mail read p:dualspiral c: m:test b:2 a:5 will return messages that were sent by either dualspiral or the console, containing the word test, sent between 2 (before) and 5 (after) days ago.

Developers - API updates

This is a large update for developers as we gear up for Nucleus 1.0

Repository: ‘http://repo.drnaylor.co.uk/artifactory/list/minecraft’. Dependency (1.10.2): ‘io.github.nucleuspowered:nucleus-api:0.25.0-S5.1’ Dependency (1.11.2): ‘io.github.nucleuspowered:nucleus-api:0.25.0-S6.0’

New Services and Events

Many new services have been added. They are:

  • NucleusBackService - for controlling the location /back sends players to.
  • NucleusMailService - for reading player mail
  • NucleusMuteService - for muting players
  • NucleusNameBanService - for banning usernames
  • NucleusPrivateMessageService - for managing reply targets and social spy
  • NucleusWarningService - for managing warnings

Events have also been added:

  • NucleusJailEvent (associated service is due for the next release)
  • NucleusMuteEvent
  • NucleusNameBanEvent
  • NucleusWarnEvent

NucleusMailEvent and Mail Filters

The NucleusMailEvent allows you to also use the same filters as above, but instead should create the filters through the API. The MailFilters are glorified Predicate<MailMessage> objects, so you can also create your own too.

Minor Changes & Enhancements

  • Mutes now notify the player when the mute expires.
  • Added startup message in the console to let owners know where to find help.
  • Added ability to generate a file containing Essentials equivalents.
  • Disable /r ?, so you can send ? as a reply.


  • Fixed /me
  • Fix commands.conf generation, remove errant nulls.
  • Fix teleport methods saying a teleportation was unsafe when it was actually cancelled.

Known Issues

  • /invsee does not work unless you are within 8 blocks of the target player. Use NucleusMixins to workaround this - though this currently doesn’t work for some heavily modded servers. If you have more information, please add it there.
  • Some players are finding that enhanced pre-generation isn’t giving output. This will work fine in 1.11.x.
  • There is an API, but this is subject to change.
  • Sometimes, an incorrect custom prefix might be selected. Nucleus uses whatever the permission plugin hands back, check your inheritance with the permissions plugin.

Commit History

What do I need to download?

I’m using Minecraft 1.11.2

Download Nucleus-0.25.0-1.11.2-S6.0-plugin.jar from this page

I’m also using PlaceholderAPI 3.5 or above

In addition, download NucleusGluon-1.0.2.jar