To use some features of the plugin, you'll need to install other plugins. If you don't have these plugins, the feature(s) won't be enabled.

A modern permissions plugin (such as LuckPerms) is highly recommended

Vault (with an economy plugin that supports it), Treasury, PEconomy, or PlayerPoints is required for:

• Money Loot from Treasure Chests.
• The Ammo System.
• The money option with Pet Renaming.

Lib's Disguises and consequently ProtocolLib are required for:

• Morphs

After running UltraCosmetics for the first time, configuration files will be generated that you can edit. (Hint: when talking about configs, the key X.Y means the configuration option Y found in the section X.) Here are the most important settings to check out when installing the plugin:

• Treasure-Chests.Key-Price: how much it should cost to buy treasure chests through the GUI. Set to -1 to prevent purchasing, meaning they can only be obtained with /uc give key
• Menu-Item.Enabled: Set this to true if you want players to receive an unmovable ender chest in their hotbar which they can use to equip gadgets. When this is not enabled, players can still use /uc menu main to open the menu, if they have permission.
• Enabled-Worlds: a list of worlds where cosmetics (and the menu item) should be enabled. Defaults to * which is all worlds.

Now that you've configured the plugin (or at least started) you can test it. (If anything doesn't work, jump down to the troubleshooting section.) The main thing to test is the treasure chests.

1. Set yourself to standard user permissions, because treasure chests will only give you money (and won't give you cosmetics) if you're opped or otherwise have all UC permissions.
2. Open the GUI with the menu item or /uc menu main and click the tripwire hook button at the top. This should let you buy keys.
3. After you've bought a key, click the chest button to open the treasure chest.
4. Once you've finished opening the loot chests, equip and use one of the cosmetics you got from the treasure chest (again, through the GUI or the menu command.)

You need to install a supported economy bridge such as Vault, Treasury, or PEconomy, OR install PlayerPoints.

Treasure chests require a certain amount of space for the chests and blocks to be placed. Move to an open area and try again.

Make sure you correctly set Permission-Add-Command for your permissions plugin. Permission commands run from the console, so check the console to see if there are any error messages from the command or anything else that could help you figure out the problem.

This message means gadgets are disabled for your account specifically. Run /uc gadgets to re-enable gadgets.

If you're having an issue not covered here, or you have other questions, join the UltraCosmetics Discord server.