Tekkit Customizer
Use this plugin to ban items and blocks for Bukkit, Tekkit, and FTB servers using the Bukkit API. TekkitCustomizer removes banned items from the world and player inventories. It is easy to configure, can be applied retroactively, and automatically logs confiscated items. It requires no permissions plugin unless exceptions are need for certain players. The plugin settings default to commonly-banned Tekkit items.
Because every story that starts with "We decided to start up a Server..." shouldn't end with "...so we had to reset the world."
Installation
Copy the .jar file into your plugins folder to install the plugin. Then restart the server or use a plugin manager to load the plugin.
Configuration
An entry in the config file (config.yml) to ban ALL wool looks like this:
35:*:wool:because pink wool is for girls
- The first part is the material ID.
- The second part is the data value. Some blocks have the same ID, but a different data value. For instance, white wool is 35:0, while pink wool is 35:6. If you put an asterisk, that means ban ALL data values for the given material ID.
- The third part is for your reference. It will appear in the logs to shorthand what the various IDs and data values mean.
- The fourth part is the reason for the ban. It will be shown to players at useful times such as when a player tries to craft a banned item. If you don't fill in the reasons for your bans, you will be constantly asked why various items are banned.
After you edit your ban list, use /ReloadBannedItems to update the bans in-game. If your config.yml file "resets itself", that means you made a formatting mistake while editing the file. NotepadPlusPlus is a free file editor perfect for editing YAML files
A full list of Block IDs will help you add banned items. You can also get the block IDs and Data Values by using /blockinfo (requires /op or tekkitcustomizer.blockinfo permission). This tells you the information about the item you're holding and the one you're pointing at in the world. Some items have a different values in your inventory as opposed to ones place in the world (eg. a door item in the inv vs a placed door in the world).
Making Ban Exceptions
A player who has /op automatically ignores bans as with any player with permission:
tekkitcustomizer.*
You can make individual ban exceptions to give some players to generally banned items through permission nodes. Here are various examples, which should help you understand without further explanation.
- tekkitcustomizer.35.*.use - tekkitcustomizer.35.6.place - tekkitcustomizer.35.*.craft - tekkitcustomizer.35.6.own - tekkitcustomizer.35.6.* - tekkitcustomizer.35.*.*
You can't prevent a specific player's placed block from being removed from the world as this plugin does not track who owns placed blocks in the world.
Types of Bans
Usage Bans
This ban prevents players from using an item, which means left-click or right-click while the item is in-hand. This works well for items like the Mining Laser, but won't stop players from using items which benefit from passive use (eg. modded armors, Talisman of Repair, etc.). You will need a crafting ban or ownership ban to prevent players from getting those items at all.
It's not possible for any plugin to prevent a player from using an item when it is activated by a keystroke (eg. R, G, C, etc.), which are common especially for Equivalent Exchange items. This is why many EE items are on the default ownership bans list even though their functions are not all really ban-worthy.
Crafting Bans
This ban prevents players from crafting an item. When the player tries to craft the item, they get a message that they can't. This is the most player-friendly approach to preventing players from getting banned items. Forge mods don't always hook into Bukkit, meaning its possible for players to get banned items through some automatic or non-crafting approach (eg. alchemy). When you crafting-ban an item, test for workarounds, which may lead you to ban additional items to prevent those workarounds. The contraband scanner will help you identify the existence of workarounds by creating log messages each time it takes an item out of a player's inventory.
Ownership Bans
This ban prevents player from picking up an item from the ground or from a container (eg. a chest). If a player doesn't have permission to own an item, they won't be able to craft it. The contraband scanner will search each player's inventory for ownership-banned items and actually remove them without warning, notification, or compensation. Any items which are actually found in a player's inventory which the player doesn't have permission for will trigger a log entry, so you can follow-up with an investigation to find out how the player managed to get the item in the first place.
Placement Bans
This ban prevents a player from building a block in the world. A player that already has an item which is later placement-banned can still trade it with another player or break it down into energy (EE mod) to get some value out of it.
It is recommend to place most or all placement ban items to your crafting ban list. This will prevent your players from unknowingly spending their resources to craft a block which they then can't place in the world like they planned leading to them feeling cheated and likely complaining. The only exception you might make to this rule is for an item which can't be placed, but is still useful because it's an ingredient in another recipe for an item you haven't banned.
World Bans
This ban will retroactively remove the placed block from the world through the contraband scanner. This is great if you need to ban an item, but also know it's in the world (eg. energy collectors and world anchors). This will help clean up newly-banned items without having to search your entire world for them. There are exceptions to this removal as the scanner can't determine who owns the block.
Similar to the ownership ban, this ban will trigger a log message when a contraband block is removed, along with its location so that you may investigate to find out how the block got there in the first place.
Notes
Download the correct CraftBukkit version for your server as labelled on the uploaded files as major Bukkit API changes occurred between 1.2.5 to 1.4.7.
The default ban list is made for Classic Tekkit based on hands on testing done by BigScary. Before deciding to remove items from this list, be sure to read the reasons for default bans to understand why it was originally removed. If you are running FTB, Tekkit Lite, or other mod packs, do your own research for what you want banned and change the config file accordingly.
Save yourself some time! Check our Frequently Asked Questions page for the answer to your question. If you found a bug, make a ticket and include your config file.
The following features are planned for the next release:
- Vastly improved performance (Confirmed)
- Add configurable scanner settings (Confirmed, in progress)
- Change in config file structure (Confirmed, in progress)
- Change in permission nodes (Tentative, investigating)
- Consolidate Usage Bans and Placement Bans (Tentative, investigating)
- Consolidate Ownership Bans and Crafting Bans (Tentative, investigating)
- Dropped 1.2.5 support (Tentative)
- Dropped explosion prevention support (Confirmed)
Donations
Unlike other players who have a choice to play the game, my commitment to development and administration usually means I cannot and I'm fine with that choice. A lot of my free time is actually spent designing, developing, testing, and fixing plugins like this one to make Minecraft more enjoyful for all players. If you like this plugin, please consider sending me a donation by clicking the button below :) Thanks!
EDIT: used /blockinfo to get the ID for insulated redalloy wire, turns out to be 136:1 Now I put "- 136:1" into the crafting ban, but on server startup it changes to "- 8161" and will not restrict crafting of the item.
ideas?
edit, also doing it for wirelessredstone jammer and transmitter, as well as railcraft items. can this plugin prevent those?
any way to prevent a range of sub-ids? for instance, I'd like to prevent any covers and panels from being placed, but allow all the wires in block 136.
@SmoothNanners
You'd basically be giving infinite diamonds to players who pay for that, and non-paying players might hate you for it. The donators would have to work at first to build up to it, but eventually they'd be generating diamonds for free just by standing near a machine that spits them out at material cost.
Also, consider that those requesting players might be thinking that they will use the energy for something other than diamonds. If you explain to them that most of the high-end EE stuff is banned anyway, then they may no longer be interested in the collectors.
@zlepper
So I looked into it a bit. He's making it impossible to craft banned items (without any workarounds) by removing the recipes. I can add an option for that, but the trouble is that removing a recipe makes it impossible for you to make any exceptions. For example, you couldn't have a recipe available in one world but not another, or available to donators and admins but not guests. If you remove a recipe from the server, it's gone for all worlds and all players, period. Also, if you ban a recipe, then you don't have any opportunity to deliver an explanatory message to players about the reason for the ban, so you'll be constantly explaining to players why different items are banned.
The "max number of collectors placed" type feature sounds good on the surface, but the issue is that a say a player comes over and breaks your energy collector, you don't get your allowance back to replace the stolen collector - the rule is for number of placements, not for number of that block in the world at a time. So if I put 10 HV solar arrays down and that's the max, then I'm not allowed to put down any more - even if somebody else comes and destroys them. :\
@bigscary
You should talk with the creator of tekkitrestrict, i'm using both plugins, and they make for some very good result, hopefully even better when the big 1.00 update comes out in a few weeks.
I personally think he and you could make the tekkit experience very awesome, since your plugins are supporting each other very fine, and he seems to have found a way to ban crafting from more than the original crafting table.
right now he's also working on makking custom EMS values, which could end op breaking your plugin. Just to warn you.
@bigscary: Fantastic plugin! It's way better than just using modifyworld alone. Keep up the great work! Also, a player suggested that I set up a donation package at a certain price that will enable the usage of energy collectors (mk I or mk II at least) due to a high demand for it. Personally, do you think that this is a bad idea? I'm not very familiar with the usage of energy collectors myself, so I wouldn't know.
@jake0o0
Thanks for the compliment. I hadn't heard of Tekkit Restrict. I'll look into it to see if it gives me any ideas for features.
I'd have to say, this is 10x better than tekkit restrict, it has less features but is a LOT more reliable :)
@rad12345678901
If players can't break blocks, then they only have the items you give them. So why do you need to ban anything?
You don't need a plugin to prevent players from building/breaking. Just put the world in adventure mode.
i do know tekkit, 1 that was a quick work over and i may have missed a couple things 2 its going to be a non block breaking hunger games server, so im going to get a plugin that makes it so nothing can break a block. or it auto respawns. which takes out mining laser and countless other items 3 this means nothing can be placed so that takes out nukes, tnt, both types of cataclysts, and the reactor plus what else can be placed. 4 the map is going to be reset each round so all the rings, the amulets, and further more will greif, but it will only be for 5 minutes. can you point anything else out?
@wumpyc
Thanks, I will look into that. I'd not heard of it.
@rad12345678901
If you're fine with only two banned items, then you don't know Tekkit and your server is doomed. There's a reason there are 60+ items on the default list - because 60+ items can ruin your shit. :)
Yes, the config file is very easy to use. Just remove the lines for the items you don't want banned.
default ban list? ring of ignition? idk about you but id probably be fine with only 2 banned items, abyss helm (invincibility) and quantum chest (invincibility) please tell me changing the default ban list is as easy as adding a banned item, just like a literal list you can access and edit.
@wumpyc
I didn't realize I had removed it? I will check. It should still be on the list, and if it was removed, that was my mistake.
@iorunner
Yeah. :\ Sorry to hear that!
I set up a tekkit world without this plugin and now I have to reset the map.
Love this mod. Been using it since you released pretty much.
Only thing... Just started using multiverse, and want different ban lists for a world. I've managed to exclude the other world from the main ban list but I don't seem to be able to set up a second list, it keeps reverting to a single list when reloaded. Is there a way to have sperate ban lists or is this not supported.
May I ask why Ring of Ignition was removed from the default ban list?
@vivek115
Hey Vivek, did you reboot your server after that change? Unfortunately, /reloadbanneditems can't put recipes back into the recipe list. The only way I could do that would be to reset all the server recipes, which could interfere with other plugins you have. :) Try rebooting to see if it fixes your issue.
Hi, I use the latest version of your plugin on my tekkit server. It has served us well and I love the addition of reasons for items bans, but I have encountered an issue. It seems setting the disabled uu matter recipes to false doesnt affected those recipes being banned. A reason of fix would be awesome in the next version.
Thanks!
@Karnekdo
That was my mistake, I've fixed it. Thanks! :)
It is not possible to fix crafting banned items with a plugin except to remove the recipes entirely, which will confuse players and make it impossible for you to make any exceptions, for example allowing those items in specific worlds, or for specific player groups. The Tekkit mod developers have to fix their code. I've added that crafting table to my ban list for now.
@GothicM
I can't fix it. Bukkit limitation. :\
It would be a gread idea to have a log file where all the scanner entries were saved for later checks.
@Karnekdo
There is probably an issue where he forgot to change the version to 1.2.5. The automatic crafting tables were added to the default ban list, if you don't want them banned, just removed the entry in the list and type /reloadbanneditems ingame.