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!
Hi, is there a way to have the bans apply to OPs as well without having to mess with a permission plugin?
@Flenix1
Sure, it will work perfectly to prevent crafting of items in Vanilla (CraftBukkit). :)
@ironsmith123
Players aren't prevented from interacting with items once placed, because it's possible that administrators will want to place some (otherwise banned) blocks for use by players, like in a spawn area. For the placement issue, please check your config file to be sure you have the correct ID banned - sometimes the ID for an item is different in your hand versus when it's placed as a block. To check, use the slash command /blockinfo.
@The13thGhost23
Not with this plugin, no. I'm not sure if it's possible with any plugin - I haven't looked into it.
@cuddyier
I don't think I will, but let me consider it further. :)
@LucidLethargy
Yep, you can use a permissions plugin to give players permission to use the banned items in only the worlds where you want those items to be used. Be warned - you have to take care to ensure a player can't take an item from one world where it isn't banned into a world where it is banned and wreak havoc - the best way to check is to experiment on your own to see what you can accomplish without permission. There are plugins which allow you to place such "embargos", where inventory is checked as the player switches worlds. TekkitCustomizer doesn't do that for you. :)
Can I use this to ban items on specific worlds? My primary world has general ores, but my other worlds have specific ore VEINS, making things like redmatter pickaxes mine entire veins in minutes (when it should take a LOT longer!) I noticed the initial list that allows you to specify worlds, but I want to basically add an exception for just one world. Is this possible?
Another really good reason: Certain items like the EE rings are extremely dangerous in the nether as they allow people to effortlessly farm glowstone for it's EMC value. Every cluster has a good 4-6 diamonds worth, and they move between them extremely quickly!
ay cant eddit the config if ay start server it just loeds the default plz help
@cuddyier
i know tekkitrestric does but its a bit of a mess that would be cool if this plugin did that and maybe give a perm to allow your trusted players to right click!!! That would be BA!!!!
Is there a way to allow an item to be used by left clicking but blocking right clicking? E.g. I want players to be able to use redmatter tools and left click but obviously not right click as it bypasses worldguard. If not, can you add this?
Is there a way to stop volcanoes from generating in your worlds?
Ok, so even though I banned computers, nuclear reactors, and wireless redstone, they can still be used. When I place them or have them in my inventory they are removed just fine and like its supposed to be, however I am still able to interact with the items.
@bigscary
OK that's fine. But I can still use this for vanilla items and it should block crafting fine right?
There is no decent, working plugins I know of that can restrict crafting and placing in the way this one does, so although its designed for Tekkit it does just what I need it to providing all works :P
@Thecheatgamer1
No, I won't add that. There are often many ways to make the same item, so it's not possible to guess which ingredients the player should get back.
Bukkit doesn't know what tool charging is, since it's a Tekkit thing (not a Vanilla thing). So unfortunately, that is not a restriction I could add. Even if I could, many of the uncharged tools are still very destructive, bypassing anti grief plugins entirely, so not banning even the uncharged versions of tools is a recipe for disaster.
@Flenix1
The crafting ban doesn't work as well as you think. Because Tekkit is badly coded, there are many ways to craft an item which Bukkit CANNOT STOP. That's why ownership ban is by default, so in the event a player does craft a banned item, it will be taken away after the fact.
I see where you're going with that, but this plugin is designed for Tekkit. And in the Tekkit world, it's a very good assumption that if a player can't place a block, he should also be prevented from crafting it so that players don't get into a position where they can craft something, then be unable to use it.
@Flenix1
Everything is in crafting banned but the issue is that i need the rm and dm tools to revert back to uncharged mode if someone charges one it would help alot
@Thecheatgamer1
Easy solution to the first thing, is copy everything in "ownership banned" to "crafting banned". Then they cannot craft it and wont lose the items when trying to (IMO, this should be default)
As for the other statement... All I can say is learn to use a full stop. It hurt to read :( But seems like a fair point, maybe the dev will add it.
-On to why I came;
Does anyone else use this on a non tekkit server? I use it on the tekkit server I helped to set up, but it looks like exactly what I need for my spout-based server too. Anyone know of any issues running it without tekkit before I get it all configured? It looks like it works purely off the ID so I can't imagine there being any issues :P
One last thing, in the description of placement bans:
"If a player doesn't have permission to place an item, he also won't be able to craft it."
Why is this? It doesn't make sense, if we didn't want them to craft or place it we could just put it on both lists, but what if we want them to craft it, but not place it?
That might sound weird, but I use spout plugins which add custom items. If I can block placement without blocking crafting, I can model things like 3D weapons which are technically a block, but cannot be placed as such
Can you add something that if someone gets their banned item took off of them they get the ingrediants back
Also i need this feature and other people may
i need rm tools to not be chargable say i banned all the charged rm and dm tools so people cant use the special abilities on my spawn but everytime they get one they can charge it and it takes them straight off of them if they use a charged dm or rm tool with no ingrediants back so they get mad and also i want the feature of if like i banned all the charged items of dm and rm tools if a users charges there tool it just gets reverted back to a non charged tool and says in the chat "you can not charge this tool" im sure this will help alot of servers and people!!!
Like this so bigscary will add this
@semirotta
All servers have an economy, but I think I understand from your comments that you don't care if players cheat and get lots of stuff they didn't earn. In that case, just remove the economy-related items from the config file and /reloadbanneditems. :)
@77tontos
It's possible to craft banned items using the philosopher's stone (or other Tekkit crafting blocks, if you have unbanned them). However, the banned items should disappear when the player tries to use them, or if left in the player's inventory, they will disappear after some time.
@Kaosvf
Sorry, I think it's a question for your permissions plugin development team. One tip I can give you is to use an in-game slash command to verify that you've successfully taken away the permission for a player in that world, AND check your config file to make sure the plugin is enabled for that world.
@MadEgg
It does run periodically. All loaded chunks are scanned every 20 minutes (a few chunks at a time gradually over the 20 minutes). So if the banned blocks are in an area which has players around (it's loaded), they will disappear after some time. If they are in an area where players almost never visit, they will remain, but they're not doing any damage if they're in an unloaded chunk. Because world anchors keep chunks loaded, they should always disappear no matter where they're located.
You have to take away your tekkitcustomizer.* permission. Whether or not you can do that and still be an "op" will depend on which permissions plugin you're using. About the collectors not disappearing, it just requires some patience (see above). It's not possible for (or responsible of) me to run the world scan all the time, because it would definitely lag servers. :\
OP's have all rights so just give them a permissions group with negative permissions to the item you want to block and they shouldn't be able to obtain it.
Other solution is just not giving OP to anyone ;)
How exactly does the contraband scanner work and when does it run? I'm trying to ban energy collectors and world anchors from my server. I copied world anchors and energy collectors to the WorldBanned list, but some experimenting shows me that they still remain. If it runs periodically, is there any way to force it to run directly?
Also, why does it not ban these items for admins/ops? I can still give myself the energy collectors, and place them. They will not be removed, evend though they are on the WorldBanned list. It's only when I de-op myself that I cannot place them anymore, even though they do remain in my inventory.
Even after a server restart, the energy collectors are still there. I want to completely disable these items, as if they aren't in the game at all, including for ops. Is that possible with this mod?
Hi,
how can I block an item from a specific world? (In my case the quarry)
If I put the perms "-tekkitcustomizer.153.0.*" for the world1 it doesn't work, what can I do?
Regards.
not sure exactly whats going on but people are obtaining banned items that are on all lists... latest version
@bigscary
I like the items already but i want to remove some items because my server has no "economy" like other servers have, i dont mind about people having duping machines etc. allowed, you know?
Only thing i want to keep off use is red / dark matter hammer & armors (i heard that the armors make you basically immortal) but otherwise red / dark matter tools i would love to have in use. Somehow people cannot use them.
All economy ruining stuff can be used.
@Mceonith
I'm sorry, but I don't understand what you're asking?
@semirotta
Basically, I tested every item in Tekkit while creating the default config list. There are no items in the list which are not problematic, and there are no problematic items which are not in the list. Removing items from the list = grief and frustrated players. Adding items to the list = frustrated players.
Do not trust your players to tell you what items are safe and which are not. They all think they know everything about Tekkit, and all of them are wrong. :)