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!
@bigscary:
How about Dark matter tools, Red matter tools? people say they cannot make those... Only dark / red matter id like to block is HAMMER coz it cna make huge holes in protected areas.
i dont know what kind of formatting issue there is coz ive tried everything and nothing works.
You sure this plugin is compatible with tekkit 3.1.2?
@bigscary
Bigscary, such items as rm tools and dm tools.. can use everywhere in the world, but if show up in spawn with them in inventory the are removed.. disappear lost, unless they are put into alchemy bag.. i know this is something that is with an existing plugin as chillax server has this implemented, but have tried asking staff there and have gotten no help..I've googled several ways about this, went onto sk's irc channel about maybe something in worldgaurd.. nothing in that.. was thinking maybe something within tekkit customizer or.. umm the other one (lol) tekkit restrict
Some what solved they use modifyworld as spawn is in different world then the pvp area etc.
@rcmaehl
What do you mean by "use"? Can you give a specific example of an item you want to be taken away, but isn't?
@semirotta
All those are blocked already by the default config. The only reason for a config reset is a formatting issue - maybe it's not tabs in your case.
@budpup67
Go into your config file, remove the line for turtles, and /reloadbanneditems.
@Mceonith
Tracking player movement as they walk around is unfortunately extremely risky for server performance, so I don't do that. Please give me a specific example of a scenario you want to fix (including the item you're concerned about) so that I can try to cook up a good solution to your problem which won't lag your server.
Looking to see if you can "remove items" from a players inventory when they enter a certain area such as spawn.. i know this is possible to do as there is a server that has this but not willing to offer up an answer to how it is.. this was one of the plugins listed, so thought i would ask.
@bigscary
I understand this, However I WANT the turtles. Please help me fix this
@bigscary
No, youre wrong. I do not use TAB in my configs EVER coz i know they can cause trouble.
Let me demonstrate:
This is the regular config:
http://pastebin.com/b37SZ2GP
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
This is what i want it to be:
http://pastebin.com/kitVhWHR
:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
I have done the editing in config thousands of times and it always reverts my changes into regular config. I have server shut down during the edition.
The point is, i want these items to be BLOCKED if theyre not in the list yet help me out:
Catalytic Lens
Destruction Catalyst
Evertide Amulet
Infernal Armor
Black Hole Band
Ring of Ignition
Void Ring
Mercurial Eye
Ring of Arcana
Watch of Flowing Time
Volcanite Amulet
Red Matter Furnace
Cannon
Nova Catalyst
Nova Cataclysm
Dimensional Anchor
Tank Cart
Turtle
Igniter
World Anchor
Anchor Cart
Tunnel Bore
Iron Bore Head
Steel Bore Head
Diamond Bore Head
Industrial Alarm
Howler Alarm
Frame Motor
Dark Matter Pedestal
I hope this helps you see the problem.
<<<<SRY FOR LONG MESSAGE IM SO SORRY BUT I WANT THIS TO GET WORK>>>>
@bigscary
Yes, I have areas in which players have the permissions to use banned items, however when they teleport out of the area with the item it doesn't take the item and they can use it.
@SmoothNanners
Assuming you're not on a very early version of the plugin, when they try to craft a banned item, they will get the reason for the ban in game. There's no need for them to go to any website.
@semirotta
You're making a formatting error when you edit the file. Be careful about using TAB - only indent with spaces. This is a common problem with all plugin config files, but the plugins which have more complex configs (like this one) suffer more.
@ServerMiner
Please see troubleshooting permissions section above. You have to confirm in game using a slash command that you actually have the permission you think you do.
@rcmaehl
Sorry, I'm not planning it. They're already checked on login, when they try to use any item, and occasionally on a schedule (every few minutes). Are you having a problem? Please explain.
@budpup67
The mining turtles completely ignore all anti grief and block loggers. If you take them off the list, then a griefer will use a mining turtle to wreck protected builds, and it will be impossible for you to determine who did it or roll back the changes.
If you still want them off the list, you can remove that line from your config file. Double check it to make sure you removed it from all places, it might be in there twice (check ownership bans). You'll eventually have a serious problem, but who knows how long it will be before a smart griefer comes along - maybe tomorrow, maybe a month from now.
@semirotta
It is not a problem with this plugin. It is a Bukkit and/or YAML platform bug that when there's any formatting mistake in your config, Bukkit gives the plugin which is reading the config file default values instead of actual values in the file. I understand your frustration, and I absolutely hate this problem myself, but I am not in a position to fix it.
@budpup67
did you try any or these tekkitcustomizer.35.*.use tekkitcustomizer.35.6.place tekkitcustomizer.35.*.craft tekkitcustomizer.35.6.own tekkitcustomizer.35.6.* tekkitcustomizer.35.*.* mabe they will help like mabe its block somewere and you need to add the * node in that rank for that item just a idea ive never used this on b4
@budpup67
This is what ive exactly told here already.
This plugin wont save the config & instead it resets to default config each damn time.
I cannot make stuff allowed in my server because this plugin wont save up its configs..
I dont see the need for Mining turtles to be on the banned items list. And now that i have removed it my players stll cant pick them up. i need to know how to fix this ASAP so my players will stop complaining about them losing their turtles.
@bigscary
I'd like to be able to configure how often the mod checks for items in the player's inventory.
Great Plugin! I am not sure if it is a bug or not, but I am using PermissionsEX and this Plugin. I have put the permission node: tekkitcustomizer.* and it still doesn't allow them to access the banned item. Can you please test it and report back if it is a bug or something else I have to do.
I am 99% sure I have done the Permissions file right, so I can't see any logical explanation for this other than a bug.
Thank you
I got a problem, when editing the config and then using /reloadbanneditems
the old config wont be saved & it resets to default config.
Same happens if the server is shut down, editing then saving the configuration. Start server -> check the config -> again the default one.
I cannot save my own customizations.
A lot of players said that they would like to see the default banned IDs from the list, instead of just the "reasons for default bans" page on the Tekkit Customizer page. Not all of the items aren't listed as a reason on the page that currently exists. You can say that they don't need to know, because when they craft or use the item, it will tell them why, but then they would complain about wasted resources. I had to paste the default IDs on a website for people to see. What's your approach to this problem with your servers? I'm not sure what's the best way to deal with this problem.
@decebaldecebal
I understand your point about the value of having a recipe ban as an option. There are three issues:
Many Tekkit-specific recipes can't be banned, due to issues with Tekkit. So you have the same problem with those items - you put them in the ban list, but there are still ways for players to get them.
They always apply for the entire server, so it's impossible to make an exception for a specific world, or for specific players (even ops) via permissions.
When a recipe is banned, there's no opportunity to inform the player who wants to craft the item about the reason for the item being banned. So server owners/moderators are CONSTANTLY pestered by players who don't understand why they can't craft item X.
So basically, I'd be giving you all a feature that sounds good on the surface, but which doesn't work as well as you'd expect, and creates problems of its own as well. :\
You once had a "recipe ban" that banned the entire recipe of an item so it could not be crafted anymore.Are you going to add this feature again,maybe instead of the "crafting ban"?
Cause the way I understand is that "recipe ban" will ban the recipe used for making that item,therefor the item won't be available to be crafted by any crafting table or phil stone,something that the current "crafting ban" doesn't
@rcmaehl
Can you further explain the reason for your ask regarding permissions? Are you talking about item confiscations? What's the functionality you're trying to make happen on your server that isn't working out for you?
Keep in mind that players will be devious, and find ways to get the items they have inside your allowed areas outside, and vice versa. Pistons, teleport pipes, tnt cannons, item dropping, placing in chests which are outside the area, standard pipes, and more.
@Emilweihe1
It's very common for folks to have problems with plugin config files which result in the config file being reset. :( It's more common for plugins with complicated config files like this one. The most common mistake is putting a TAB instead of spaces when you want to indent a line - and some text editors automatically add tabs when you press ENTER at the end of a line. Unfortunately, it's not fixable with pastebin because we can't see the difference between tabs and spaces there. Try searching the internet for a tool which will validate your YML file, and use that before you try to upload your config file changes to your server.
@Emilweihe1
oh, hmmm I don't know then :\
Here you go: http://pastebin.com/cR7gQbtN