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!
Update...Cmon this is outdated and only works when it wants to
Can a option be added to only prevent storing (in chests, furnaces, etc) and dropping? That way people can have the item, but not share it.
@JoeLinder
im having issue with mcpc+ r1.1 and higher, it look like inventory event and crafting event are changed because when i craft some (ic2,bc3 and other few mods still respect tekkitcustomizer events) banned item i can use them normaly, only world ban and placement ban still working well
@marubal21
yes tekkitcustomizer works with mcpc+ 1.5.2
does this work for MCPC+ 1.5.2?
The TekkitCustomizer dupe bug has been fixed on any version of MCPC #542 and up
Master software developer blood of MCPC+ has put out a new version that we believe will fix the dupe bug! http://ci.md-5.net/job/MCPC-Plus/542/
So let me know if that fixes the problem, and if it does be sure to thank blood because he had to put up with my shit for an extended period of time today! -Canvox
@Redstoner_Pro
Are you sure your entries were structured in a way the perms plugin understands them. Some perms plugins want thing entered a certain way even if the permission is listed differently on the plugin or mod in questions page.
Hi, I absolutely love your plugin. I have a question about ID's without meta data. When I just skip the meta data part if an item doesn't have meta data the config places a really nice and helpful comment after the entry saying it doesn't understand the entry. Wish more plugins did that to be honest. I can fix it by adding a * but I worry about items that don't have meta data but still have another item with meta data using the same ID. If I * the first item the second item will also be banned even if I don't want it. I saw in the default config that there was an entry with a 0 and to my knowledge I've never seen a meta data with 0 so I was thinking that was the value to use when an item doesn't have meta data but not being sure I was hoping someone who had figured this out could answer my question. Sorry for my lengthy post and thanks to all who take the time to read it.
An example is Railcrafts World Anchor...its ID in my server is 1053 and no matter where I place it or hold it I get no meta data value when using /blockinfo or with NEI. Not really a problem by itself but then I noticed that Feed Station is also using the ID but with meta data so its 1053:11 and from looking into railcrafts config I can see he uses the same ID for a ton of different items and assigns them meta data. This applies to many other items and blocks I wish to ban, So would I add a 1 or a 0 to world achors ban, leaving it to look something like this - 1053:1:World Anchor:random reason or - 1053:0:World Anchor:random reason
Tested and 0 works fine for anyone else who wanted to know this.
Hello, I am having problems with adding mystcraft worlds to the tekkitcustomizer, is there any way to add those worlds so players would not bypass it in the certain world? Thanks
I would like to know is there anyway that i can make it so my players can left click with the item i want but not right click?
Mmmm its seems this plugin isnt being updated anymore since the current author hasnt been on for two months... which is the same for the former author..
Feel like the plugin devs for item restrictions have lost interest when the 1.5.x updates came out *sigh*
I need help running this on my FTB server, The plugin doesn't generate a config folder or file, Please help me. Yes i did reboot the server too, I am using the recommended build of MCPC+ and this used to work but for some reason it doesn't now
@sumbrawd
Do you mean like WorldGuard
@holasinor
This is a client deal, you can use an item client side for a bit of time to do it on the server, people have learned how to do it. Its very annoying.
@abraxas79713
Happens to me too, I was told it was TekkitCustomizer, I didn't wanna believe it.
@roggbart
He said on the bottom he wont be adding more features to this plugin, he will just continue to update it to the newest MC.
@Arton123
This plugin should work fine on FTB Ult, all it is a Minecraft Items banner, it really isn't made for Tekkit, it's first intention was, but it has turned to a global banning plugin. Just edit the IDs.
Needs a area selection for usage bans so users cant use there items in other users grief prevention claims.
Seems Duping Accurs with the new tekkit. Any way you could please fix this. Faggots keep crashing my server with items that are ban and i cant use this great plugin :/
@abraxas79713
what he said
Just a heads up. It seems that your plugin is causing an armor dupe with Galacticraft. Most users are assuming it's Clear Lagg, but I just went through the process of elimination with all my plugins and found that after every minute tekkit customizer makes a copy of the current armor into the GC armor slot.
I'm running this on a tekkit main server and you know that worlds are generated all the time on there. How can I set the world configuration so that it's for all the worlds?
@Out2k what you should do it ban it and use a permission system for the new world to make it an exception to the normal ban list.
For example use bPermissions and add tekkitcustomizer.50.*.* to unban torches in the new world.
Any plans for tekkit 1.5.1?