Bukkit

Troubleshooting and Common Questions

Why does my config file keep resetting back to defaults?

Bukkit's configuration file system resets a configuration file (in whole or part) back to default values when it encounters formatting that it doesn't understand. Usually, the problem is that while editing the file, you accidentally made a small formatting mistake like forgetting a dash (-) or using a TAB to indent when you should be using spaces. Sometimes, text editors will even automatically insert tabs for you when you start a new line, so this is an easy mistake to make. I understand this is extremely frustrating, but I haven't found any good workaround. After making lage-scale edits to your config files, make a backup copy before you restart your server.

I gave a player permission to use a banned item. Why can't he use it?

Permissions plugins are notorious for being difficult. The likely problem is that what you think your config file means is actually not how your permissions plugin is interpreting the file. First, use your permissions plugin's "permissions dump" command for the player who's having the problem to confirm that he actually has the permission you think he does. If he doesn't, use an in-game slash command to grant the permission instead of editing the config file directly, so that the permissions plugin will do the config file editing for you.

I added a block to the world bans list. Why aren't all of those blocks removed from the world now?

Because scanning your entire world at once would be tremendously difficult for your server to process (producing a massive lag spike), TekkitCustomizer gradually scans the currently-loaded part of your world for contraband blocks. Specifically, it scans 5% of loaded chunks every minute. That means that it's somewhat unpredictable when the scanner will get to the chunk you're standing in, so if you want to see the scanner working, you may have to stand next to a contraband block for up to 20 minutes.

Why can't I disable special functions of items instead of entirely banning the item?

Put simply, Bukkit doesn't know what most of the Tekkit items are, and doesn't provide a way for me to "block" the use of special keystrokes like R, G, and C. Reportedly, the Tekkit Restrict plugin can do that for you, but it has a reputation for lagging and crashing servers, so be careful if you decide to give it a try. You can use both TekkitCustomizer and Tekkit Restrict side by side, with some configuration work.

I banned an item that a player has in a container. What do I do?

The easiest solution is to temporarily give the player permission for the item so that he can remove it himself. Or, you can visit him and remove the item for him. If the item is in his alchemy bag, the former option will be easier (otherwise you'll need another plugin to access his bag).