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!
Config gen works with all other plugins. Yes, I do use bukkitforge so I can have mods and that does screw with some plugins. May be that. This was the only plugin that lets items like 863:32 (ex, random numbers) get blocked, most just accept 863 as it and the :32 wouldn't be accepted. Ill have to search a lot more I guess :(
Hi, your plugin is awesome, I just miss one feature.. Can you add an option to block items per world or per region (such as using with worlguard api)? That will be very useful. Thanks!
@Kane_Hart
I've heard there's some modified version of Tekkit somewhere that "Fixes" EE and some other mods so that they properly ask plugins permission before changing blocks. Maybe if you Bing around enough you'll find it, but even if you do, I'm unsure it will work with MCPC.
@RustyDagger
On the mining stone thing, it sounds like your plugin platform isn't respecting my plugin's assertion that the right click action should be cancelled (the fact that you get the message confirms that I'm trying to cancel the event). Please report the issue to your platform developer. In the meantime, you may want to ownership ban that item, and check other items from that mod to see if they have the same issue.
I am with Kane_Hart On this one I am making a grey list Modded server and I am having a really hard time Blocking every thing from guest's I found that Antibuild Worked quite well until I realized it was stopping RP2 deployers working at all.
I am also having an issue blocking EE3 minium Stone. I have added it to the config and it seems to be Partly working. When you right click with it it prints the message to chat saying that its blocked. ( I but a usage ban on it ) However the Block your aiming at still gets transformed. Maybe it needs a little more checking of the block the player is aimed at Im not sure if maybe you can undo it or some thing clearly its bypassing the block break/place events.
MCPC-Plus seems to be a real nice future. This mod seems to work nearly flawless with it as well. I was wondering though if you knew of any mods that can actually block everything not just some things when it comes to world protection?
Right now the big issue is Mining Laser / Nuke / iTnT / Dynamite / Anything really that can break blocks can even under protected land unless it's like a drill and such.
I really love to see more MCPC-Plus or related type plugins helping to protect my server :)
@Suolakeksi24
That's a known issue with the EE mod. The phil stone doesn't ask plugins if it's OK to craft an item before crafting it, making it impossible for any plugin to prevent items from being crafted by that item. You could ban it, but that would make all of EE unavailable. You don't have to worry about players getting items they shouldn't have because those will be taken away from them, but players who use the phil stone may be disappointed about losing the materials they spent creating the item which was later taken away. If you don't ban it, the best you can do is try to inform your players not to use it for crafting so that there's not a chance they will spend resources on a banned item and then have it taken away.
It's not always possible to determine what an item was made from, especially when you consider the phil stone and many items having multiple possible recipes. So that's why I do my best to prevent crafting banned items, but it's not possible to prevent 100% due to the poorly made EE mod. Sorry, Tekkit is kind of a mess in some ways. It just wasn't designed well for multiplayer, so plugin developers and server admins just do the best they can to make it work out. This is one area where my hands are tied as a bukkit developer.
@Krevzz
Use your favorite permissions plugin to grant permission for the banned items in all worlds except for the hardcore world.
@Deliphin11
It's already done. See above.
@deleted_9225422
I guess you're not running a server with a good simulation of CraftBukkit?
@mrkirby153
Sorry I don't have a dropbox account, it won't seem to open for me. What error message are you getting?
@mrkirby153
be sure to get a public link from dropbox, that link will only work if YOU are signed in or if the person happens to have the exact picture in the same location ( https://www.dropbox.com/lightbox/home?select=2013-02-02_16.46.15.png )
I cannot craft any items related to tekkit. I am op and can't do anything!
(Screenshot:Here)
EDIT: Still Happens. Have no idea why
There was no config file for me- Help?
@Deliphin11
You do /reloadbanneditems
One thing that would be nice is a reload command, so I don't have to shut down the server and load it up to add/remove an item.
Hey great plugin, ive found one problem; Basically i run a 3.1.3 tekkit server, and want a 'hardcore' world with no EMC items allowed, how can i configure this? I use MultiVerse for the different worlds, and i don't want them banned in the main world, only the hardcore one!
Dunno if this has been reported before, but on my server (MCPC build 79 with tekkit lite) I can bypass the usage ban with a philosophers stone and convert materials like stone brick into chiselled stone brick etc. And yes, i've checked that the item id is the right one.
Btw just a suggestion, could you add a option so that people won't loose stuff they create, but instead the items breaks into the materials it was used to make of? As a huge amount of people on my server have disliked that it just deletes ones items and doesn't give anything back :/
@bigscary
Thank god i have my own dedicated machine for all this.
@waflija
There are plugins that give people permissions for something, simply when they buy it from a shop or something, however this is hard to limit the right way, but it would be some type of limit, and they would not be able to get the permission back when they pick the item back up.
@zlepper
Theoretically yes, but it's a lot of work for me to make a tiny functionality change, and when it's done, the plugin would require a database which most admins don't know how to deal with, and it would take up a lot of hard drive space, increasing server expense for hosted servers (which is most servers).
@bigscary
Just a suggestion: Would it not be possible using a logging plugin?
then make it into another plugin? i know logblock tracks exacly who placed the block and how many each person have placed, however this number does not reduce when it's removed again.
@waflija
No, that would require keeping track of who owns which blocks in the world. TekkitRestrict tries to do this, but there's a problem where if another player removes your world anchor, then you can't replace it (he gets the world anchor credit for placing another one as the remover, you don't get one as the original placer).
Anyway it will still eventually wreck your server, even if there's only one world anchor placed per player. Players come and go over time, so gradually world anchors build up until they're a problem.
Does this plugin has a option to limit the amount of items? e.g. only 1 World anchor per player?
@agaricus
I'm very glad to hear you were able to fix the problem. :) I'm sure your users appreciate your diligence in trying to make MCPC support as many Bukkit plugins as possible!
@bigscary
Fixed the AbstractMethodError error with MCPC+ in build 74+ :). Btw, the issue was with converting non-vanilla recipe types to the Bukkit API wrappers - there wasn't a wrapper for Forge ore recipes, IC2 advanced recipes, RP2 handsaw recipes, etc. So I now return a "CustomModRecipe" implementing org.bukkit.inventory.Recipe for these modded recipe types. This allows you to get the crafting output from the API through getResult(), but other functionality is not exposed through the API. You can access the raw recipe class through n.m.s. CraftingManager, however. If there's anything else you need in MCPC+ for TekkitCustomizer let us know =)