Skip to content
Ren edited this page Apr 23, 2023 · 13 revisions

» Home » FAQ

Q:

I'm getting the error "A Minecraft profile has not been created for you, or was unable to be retrieved" when trying to do anything. How do I solve this?

A:

This is often caused by one or more plugins failing to load. Check your logs for "UnknownDependencyException: (plugin)" and install the required plugin(s). You can also reference Module Dependencies to see which modules are required for your desired setup.


Q:

I can't log in, it's telling me "There is no Minecraft profile service available". How do I solve this?

A:

You need a players implementation. Install rpk-players-bukkit. It's worth reading through Module dependencies to ensure you have all of the required modules.


Q:

I can't build! How do I fix that?

A:

Players without a character are blocked from interacting with the world in any way. In order to start building, you need to create a character with /character new


Q:

Do you support PlaceholderAPI?

A:

Yes! Each plugin with placeholders lists them on its respective configuration page, for instance see https://github.com/RP-Kit/RPKit/wiki/Characters-Configuration#placeholders


Q:

What are the lib plugins for? Do I need them?

A:

The lib plugins allow modules to seamlessly operate with areas of functionality without knowing the underlying implementation. This means servers can write their own plugins for common functionality, e.g. characters, and have the rest of RPKit work with it. You need the lib plugins for the areas of functionality you want to support. See Module Dependencies for which ones you need.

For most servers that do not have their own developer, you should install the lib plugin and the reference implementation. For example, if you want character cards, this would mean installing rpk-character-lib and rpk-characters.


Q:

I'm using LuckPerms. Do you support that?

A:

Yes, kind of.

For normal operation, RPKit requires some features beyond the base Bukkit permissions API. This includes offline permissions lookups. LuckPerms supports this, but the Bukkit permissions API doesn't. RPKit uses its own library, rpk-permissions-lib, for this kind of operation. In order to link LuckPerms and rpk-permissions-lib, an additional plugin is required, called "luckperms-rpkit-bridge". This has historically been distributed on-demand through the Discord.

So while for most servers I'd recommend using rpk-permissions-lib + rpk-permissions, if you have an existing setup you're happy with that uses LuckPerms, you can use rpk-permissions-lib + luckperms-rpkit-bridge + LuckPerms.

rpk-permissions additionally supports character-dependent permissions, which aren't a feature of LuckPerms since LuckPerms isn't aware of the character system (and doesn't need to be). This means you can assign permissions groups to a character, for instance if a player gains access to certain commands for managing tax as a monarch, or gains access to commands for vampirism from another plugin when they are a vampire.


Q:

I installed the JARs but the config isn't being generated / commands aren't working / plugin isn't working. What am I doing wrong?

A:

Check your /plugins - if the plugin is showing up in red, it has failed to enable for some reason. Check your startup log for errors. More often than not, you will have missed a dependency - refer to Module dependencies. If not, take a look at the error, see what it is describing, and see if you can correct the issue.

If the plugin is not showing up in /plugins or the startup log at all (i.e. doing a search for the plugin's name does not give you any results), then the file isn't being picked up by the server. Either it doesn't have the .jar extension, or it is not in the correct folder.

Clone this wiki locally