Answers to Frequently Asked Questions
Nucleus is no longer receiving updates, and real-time support is no longer available. Developers are free to fork Nucleus, however if you do so, please use a differernt (enough) name.
The following FAQs may be slightly out of date, especially if they refer to potential features in the future.
Nucleus is, quite simply, the Ultimate Essentials Plugin for Sponge! Nucleus was born to bring a modern, modular and feature-rich Essentials style plugin that makes Sponge a viable choice for all server owners to cover the basics, whether they be vanilla servers or modded servers. It lets you get on with making your server unique with a solid base you can trust!
If you want more information on Sponge, see their website and documentation.
Please, take the time to read the rest of this FAQ too.
No.
Not yet, but it is being worked on.
Yeah, 1000 permission nodes can be daunting, and there is nothing stopping you, but we honestly recommend you do not. Other plugins may also not function as intended, a good example is GriefDefender. So, please, don’t use the wildcard.
Instead, Nucleus offers a way to setup our suggested permission sets, that should get you off the ground. You can learn more about how to set suggested permissions as part of our first time setup tutorial.
USER gives permissions to:
/afk, allowing themselves to be marked as AFK/me, to be able to write “action chat” (such as dualspiral wrote these docs)/time)/helpop to message staff/suicide/realname to find out what a player’s IGN is from a nickname/list/rules/spawn and /firstspawn/tpa, accept and deny requests, and use /tptoggle to blanket deny requests./warp to teleport to any available warp point (but if enabled, only to those they are given explicit permissions for)./getpos to get their own positionMOD gives permission to:
/tpahere to request someone to teleport to them.ADMIN gives permission to:
As the ADMIN set spans about 900 permission nodes, please forgive me for not listing it all here!
Yes! Nucleus has a system which wraps up the functions into units called “modules”. So, if you have a better banning plugin, turn off the ban module! Something else does chat? Turn off the chat module!
The modularisation of Nucleus allows for exciting plugin combinations
To turn off a module, in /config/nucleus/main.conf, scroll to the modules section and set the module to DISABLED. Then restart your server.
/help command!Nucleus does not touch the /help command. /help is a Sponge command - please see the Sponge Docs for more information (and permissions).
It’s important to note that no minecraft command is actually turned off.
To access a vanilla Minecraft command hidden by Nucleus, you can use /minecraft:<command>, such as
/minecraft:kill.
If you would rather have Minecraft use the command, but keep Nucleus’ available, use Sponge’s command alias feature.
In Sponge’s global.conf file, find the sponge.command.aliases section, and add <command>=minecraft to the list.
So, to set /kill to redirect to Minecraft, your aliases section should look like this:
aliases {
kill=minecraft
}
Nucleus’ kill is then available through /nucleus:kill
If you want to turn off Nucleus’ command completely without turning off the whole module, you can turn it off in commands.conf,
learn about how to do this in our commands configuration tutorial.
Most of Nucleus’ commands support warmups, cooldowns or costs. All the settings are in the /config/nucleus/commands.conf
file for setting options on a global basis. Note that you can either do this on a global basis by changing the commands.conf
file, or on a per player/group basis using permission options.
Learn more about how to set warmups, cooldowns and costs in our tutorial.
Yes, you can. This is described in the Connection Messages module documentation.
This is entirely dependent on your Permissions plugin. While Nucleus has a lot more to offer in terms of chat formatting, and we recommend that you look at the chat module documentation pages, by default, Nucleus will display prefixes, display names and suffixes in the chat message. Therefore, you just need the to set the prefix options in your prefix options, select commands for sample permission plugins are provided here.
For a user:
For a group:
This is implemented as the permission option/meta home-count, rather than a specific permission for performance reasons.
Consult your permission plugin on how to set this option, but for reference, commands for popular permission managers are shown below:
For users:
For groups:
You can read more about the home module here.
Check your permissions. Because of the way permissions work in Sponge, the permission a.b is the same as a.b.* in Bukkit. So, if
you’ve granted nucleus.kit to a player, they have access to redeem kits, bypass warmups and cooldowns, limits, can create kits and
create command kits, which allow them to run commands as the server. This is bad.
When setting up your server, please don’t be lazy and guess what the permissions are - check them using these docs, or use our role permissions to get started
Unfortunately so. See our list of compatibility issues on our compatibility page.
FTB Utilities tends to overwrite the chat formatting that Nucleus applies - it is particularly evident when the player name in the chat is green when that player is OP.
To disable the FTB Utilities chat formatting and restore Nucleus behaviour, look in the FTB Utilities configuration
and set B:override_chat to false then reload the FTBU mod or restart the server.
/back telling me there is nowhere to warp to?/back was designed to be more flexible than previous plugins, but that also means that configuring it can take a few more steps. If it
isn’t working, make sure you check the following:
nucleus.back.targets.death, nucleus.back.targets.portal, nucleus.back.targets.teleportmain.conf at back.* are set as you expect them to be.By default, Nucleus overrides this behaviour if you have custom spawn rules set. If you want bed spawns to override other
respawn logic, set spawn.affect-bed-spawn to false and reload the config.
Minecraft has a special spawn logic for new players:
You can fix this by running /gamerule spawnRadius 0 (shoutout to Karaga for discovering this!)
Have you got any chat management plugins installed? These plugins tend to override what Nucleus is doing, and while Nucleus tries to be as compatible as possible, some plugins do interfere, from duplicating sections to completely blowing away all of Nucleus’ formatting.
Before reporting this to the Nucleus issue tracker (see below), please remove ANY chat management plugin and test without. SimpleChat and UltimateChat, to name some of the more popular plugins, do alter the chat and can cause surprise to the server owners! While we can try to give you help in these scenarios, please bear in mind that anyone in the Nucleus Discord channel are there for Nucleus. That said, developers of some of these other plugins are also in our Discord channel and can help you directly too.
/rtp or some other teleport to a place no player has gone before!Chunk generation is slow. A general recommendation by most of the community is to do what is known as “pre-generation” of your world. Pre-generation creates chunks in your world before they are needed, so when someone does reach that chunk, it just has to be loaded, rather than generated first. This, in general, offers a moderate performance gain, however, do be careful to not pregenerate a large world!
Nucleus offers a way to do this in the world module. The command /world border gen [-a] [--save <time>] [world] allows you to pre generate
up to your world border. We recommend setting your world border to be about a 4000 block diameter around your spawn point (using the command
/world border set 4000 when stood at the centre), and then running /world border gen. This will generate your world, using 80% of the tick
time and save every 20 seconds.
If you want to try to run the pre-generation faster, you can change the same interval to be much higher, and run in “aggressive” mode. Adding
-a to the command indicates aggresive mode, where 90% of tick time is dedicated to the generation routines, and memory checks are turned off.
To increase the save interval, add --save <time> to your command, many server owners choose save intervals of two minutes.
Some configurations are:
/world border gen -a --save 1m - aggressive mode, 1 minute save intervals./world border gen -a --save 5m - aggressive mode, 5 minute save intervals./world border gen --save 2m - normal mode, 2 minute save intervals, usually used for live servers (which we do not recommend).We recommend you do this on a server with no players on!
If you get an error that states “An error occurred while running this command”, or Nucleus does something weird when you perform an action, please do the following (make sure you have console and filesystem access):
main.conf, set core.debug-mode to true and run /nucleus reload./nucleus info on your server, and get the file it generates.That’s it! The developers may ask for more information, they will direct you on how to get this info if it’s needed.
/help command!/back telling me there is nowhere to warp to?/rtp or some other teleport to a place no player has gone before!