FAQ

Do I need any other plugins?

No. ProTools has no hard dependencies. Drop it in and it works on Paper and Folia for Minecraft 1.21 and newer.

Does it work on Folia?

Yes. ProTools is built for Folia as well as Paper.

Why did my tool disappear?

Every tool self-destructs after a set number of days, shown as a countdown in its lore. When the timer hits zero the item is removed. Change how long tools last with tool-duration-days in the config. See Configuration.

Can I stop tools from expiring?

The timer is always on, but you can set tool-duration-days to a very large value so tools effectively never expire.

How do players get tools?

Tools are not crafted. Give them out with /protools get <tool> [player], or let players pick them from the /protools list menu. See Commands.

Can I turn a tool off?

Yes. Set that tool's enabled value to false under tools in the config, then run /protools reload. It disappears from the menu and can no longer be given.

Do tools break or take damage?

Not by default. tools-unbreakable is true, so tools never lose durability. Set it to false if you want them to wear down.

The item name shows tags like <red>. What is wrong?

ProTools uses the MiniMessage format for all text. Make sure your tags are well-formed, for example <red>text</red> or <#FF5555>text</#FF5555>. The MiniMessage guide covers the syntax.

Does it support PlaceholderAPI?

Not at this time. ProTools does not expose placeholders.

My Recall Crystal will not teleport me.

You need to set a location first: right-click a block to bind the crystal, then right-click the air to teleport back to it. If you have not set one, the crystal tells you in chat.

Can I change what item a tool looks like?

Yes. Change the item value for that tool in the config to any valid Minecraft material, then reload. Keep the tool's id key unchanged.

How do I limit a tool to staff?

Set that tool's protools.use.<tool> node to false for normal players and true for the rank you want. See Permissions.