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!
@decebaldecebal
Oh, I thought I checked that table and it was safe. I must have made a mistake. I'll check again and update the default list as necessary. Thanks!
I noticed that players could craft banned items while using a project table.I think that the table needs to be added to the default list of ownership bans.
@mrcheesete0
I've been running my server on the current Tekkit with my 1.2.5 R5 plugins without any problem.
of course another great plugin from BigScary.
Just a quick question that will make me sound like an idiot, but I have been away at Navy Boot Camp for 2 months so I am a bit out-dated on the bukkit world. will 1.2.5 R5 plugins work on R4? Because I believe the most recent tekkit is 1.2.5 R4.1 of bukkit
@DepokBoy
Yeah sorry, the world anchor also is a severe performance issue for servers. It might look nice and be fun to build with, but it's not welcome in multiplayer. :)
@CDew123
I don't quite understand what you're telling me? Please explain a little more. Also, it looks like you're not on the latest version - there are no crafting bans by default in the latest version.
Hello, I got a problem. The CraftingBanned is auto making the bans. Check. I dont wanna bann energy collector -.- :(
- 126:0:Energy Collector I - 126:1:Energy Collector II - 126:2:Energy Collector III - 223:1:Tesla Coil - 264:*:Diamond - 263:*:Coal/Charcoal - 263:*:Coal/Charcoal - 15:*:Iron Ore - 14:*:Gold Ore - 73:*:Redstone Ore - 331:*:Redstone Dust - 140:5:Copper Ore - 49:*:Obsidian - 248:*:Tin Ore - 140:4:Tin Ore - 30217:*:Sticky Resin - 289:*:Gunpowder - 351:4:Lapis Lazuli - 110:*:Mycelium - 2:*:Grass
Absolutely brilliant plugin. Thank you so much!
just a minor complain.... I was editing the config and found 214:*:world anchor. Just wanted to tell you that world anchor is 214:0, 214:1 is concrete block, which I happen to like building with. ;)
@zlepper
It's possible but I won't do it. This is the only time in many months of plugin development that I've seen a delay in getting a file approved. If it keeps up, I will consider taking action. But not for just this one instance, because the process changes you're suggesting would add a lot more work for me for each update.
@bigscary
It's not a discussion per se, more like "tekkit blaze rod" on youtube :) . Look around there with the keywords tekkit and infinite, and you'll be hanging your head in shame.
@bigscary
i do know how to where to download thank you ;) i've been using this plugin almost since it launched :) is it plossible for you to use mediafire, or pages like that for an early download link, or do bukkit have to accept changes to the description too? if so, then how about making a forum post, in the minecraft forum, where we can download 'em early, and then just updating the page when you launch a new version? just a sugestion, but it's up to you to decide. you can ofcouse still use bukkit dev
Hey guys one of my test server players is telling me some folks were PvPing (even though I have it turned off), and he thinks they were using mining lasers to do it. I can't confirm right now due to Mojang's authentication system being shut down - does anyone know if mining lasers can be used as a workaround to pvp?
@GothicM
I dunno why, but the bukkit dev guys haven't approved it, yet. You can click the blue "files" link at the top of the page to download it.
@Koowluh
Yes, but it's possible that players will use those to create banned items, which will then be taken away from them. So they will have wasted their resources, which they will complain about. :) You have to decide which way you want it.
Will you please link me that discussion you found? On my server, I've seen players using block breakers to harvest from cobblestone generators, and deployers + block breakers to harvest bonemeal-grown grass and flowers. For now I'm going to leave those particular loops alone, because I think they're unbearably slow and difficult to scale out. I haven't done the math on the grass thing, though.
@bigscary
when is the update gonna be downloadable, right now the plugin doesn't block anything at all?
@bigscary
Can't tell you how much we appreciate you trying make Tekkit playable for the masses. With your crafting bans lifted and ownership bans affected, automatic crafting tables could be allowed again no?
I read up on a blaze rod EMC farm too by the way, which looks like another infinite "crap diamonds" loop. Perhaps something for you to look at too? On an editted note, this seems to be done with an energy condenser, which is most likely already banned.
Again, appreciate all the time and effory you put into this. I'm considering a (monetary) donation too, and I encourage everyone to do so.
So, wheres update? :D
1.4 Updates!
Due to extensive recommended ban changes, I recommend everyone delete their config files to get the new defaults. HOWEVER if you have customized your config file, you should make a copy first so that after you get the new defaults, you can copy/paste your customizations back in.
Sorry for the trouble, it seems Tekkit is more broken than I thought. :\ Had to add some more bans and adjust a few.
Important lesson I learned recently: Pressing C with the phil stone equipped gets the player a crafting interface which bypasses all the crafting bans! Unfortunately, banning that ring would finish off EE altogether, since it's the most basic item and used to craft the transmutation tablets. I've tightened the contraband scanning in response, but you should expect that some players will get banned items very briefly (they won't be able to do any damage with them) because they use this method for crafting. Be prepared to explain to your players that to avoid crafting banned items and wasting their materials, they should use a crafting table rather than the Philosopher's stone to do their crafting.
@Narodino123
Yeah it's not a great system, do talk to Bukkit guys about it. :)
I don't see the issue, BUT it's possible that when you uploaded it to pastebin, pastebin changed your tabs to spaces. Check at the beginning of each line to make sure you have spaces rather than tabs.
Is the entire file resetting, or only a part of it? If only a part of it, which part?
Aye thats what im using. so the plugin goes back because i have made i tiny mistake... damn feels like god damn programming.. -.-
hehe ahh well notthing left to do than closing watch the file
Edit: I cant really see whats i have done wrong dunno if you maybe can spot the error here my file: http://pastebin.com/nvsg9LSq
@Narodino123
This is a common problem with all plugins and their config files. If you make even a very minor formatting error when editing the file, the file will revert back to its defaults. The most common mistake is using tabs instead of spaces to do indenting, and I recommend NotepadPlusPlus (it's free) to help you catch mistakes while editing. :)
I don't get it i have installed the plugin, and then i edit the config file to allow Redmatter and darkmatter tools, and disallow some other items, but when ever i start the server the config file just goes back to the default setting. what am i doing wrong? or is this a plugin on made for those items already in the default?