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!
@GokouZWAR
How did you load the plugin without rebooting? I thought it wasn't possible with Tekkit.
You misunderstand. There is a duplication glitch where ANY item can be duplicated using the RM furnace.
I'm going to take the nether diamonds out of the list anyway, because they're too spammy. In the meantime, you can put something else in the list, like diamond sword, which is never placed in the world as a block anyway. That will prevent the list from resetting to default.
@wumpyc
Sunlight > UU Matter > Ores > Broken Economy
@Rom3ox
Oh right, I might do that soon.
@LiteWarfare
You can do that with your permissions plugin - just give all players permission for banned items based on which world they're in. If your permission plugin can't do that, time for an upgrade. :)
@yrthilian
Oh, I see. Well, here is your first issue where it does not work, sorry! Try reporting this issue with worlds not being found by Bukkit plugins to the Mystcraft developer.
http://www.minecraftforum.net/topic/918541-132-mystcraft-09201/
it is not part of bukkit but works along side it without any issues. it is built into the craftbukket.jar file so no config.yml file for it.
there is a .txt file for it to set the block id's other then that nothign else.
Thank you for this great plugin very much, but why is Char/Coal blocked from crafting by default?
Is there any way to ban a certain item from one world but not another? Or would I need a different plugin?
@GokouZWAR I am having the same issue. I cannot prevent this plugin from removing Nether Diamonds.
I have tried: -Commenting the line out. (No Effect. Scans and removes Nether Diamonds) -Commenting the entire worldban section out. (No Effect.) -Deleting the line. (Line is restored at next server restart.) -Deleting the Worldban section. (Section is restored at next restart.) -Deleting the line, then setting the config to be read only. (No effect.) -Replacing the Block ID with something else. (Config file restored to default at next restart.)
I think this plugin simply does not like Nether Diamonds.
Also, the RM Furnace glitch is when you can duplicate ANY item by viewing the RM Furnace GUI and shift clicking the item in the bottom right of your inventory.
Hello, Thanks for this great plugin for Tekkit Servers!!.
I would recommend to add a messages.yml file for the admin to be able to edit and translate the default messages so the users receive more info about the ban or give the message in other language.
Thanks.
sorry for my english. im spanish.
Why is Char/Coal blocked from crafting?
Totally missed this plugin when setting up our tekkit server we are using Grief Prevention and Population Density with fantastic results
Grief Prevention is a definite must have it eliminates the need for rollbacks loggers. I think server guy Matt has spent 10 seconds on griefing in the last month one player said that someone stole his stuff and Matt said “you should have it protected” and that is it. In the past that would have been half an hour or more frantically trying to figure out what was going on.
I don’t even have a door on my main building
Can’t wait to initialise Tekkit Customizer kicking myself for not spotting it sooner
I have made my first donation and will designate a percentage of each tekkit server donation to your plugins A big and sincere thanks from Australian tekkit server
@bigscary
TekkitRestrict plugin prevents players from using duplication glitches like the Red Matter Furnace one. Only duplication glitch that it doesn't block is the transmutation table glitch. It only blocks Klein Star usage.
I'm currently using both TekkitRestrict and TekkitCustomizer because I like they way tekkitcustomizer deals with banning items. TekkitRestrict can ban crafting workarounds too so it works well as a item banner too.
Suddenly people can build even blocked blocks, even though they don't have permissions for them yet, isn't the plugin supposed to delete blocks from player inventory if they don't have the own permission for it. they can also place ans use they blocked blocks. is it a bug, or did i forget to mark something?
One big hangup I had with loading this plugin was that one first boot with it everything starts being remove immediately. I'd prefer the recommended diabled items be commented out initially and then we could go in and remove the commented items ourselves after its loaded. I didn't care if red matter items were removed but it deleted all those items immediately after startup. Now I have to go back and refund items to users. Please consider making it so it doesn't instantly delete the items.
Also if nothing is setup in the world ban list it seems to automatically add the delete nether diamonds!! I want diamonds to stay!! Make it able to be blank please.
Also bigscary, the redmatter furnace's intended use gives 2 bars per ore, it is not a duplication glitch if it does that. Is that what the videos are showing or is it something else? IE you should not be able to duplicate diamonds in it.
Hey everyone, I've just learned that there is a duplication bug in the EE mod, where players can use the Red Matter Furnace to duplicate any item. I recommend you add the RM Furnace to your ownership and world ban lists until the EE developer fixes his bug.
@arnnie
No, get an anti grief plugin for that. I recommend the plugin called Grief Prevention.
@yrthilian
Well then, give me a link to mystcraft. I couldn't find it on bukkit dev here. I need the name of the plugin from its plugin.yml file, or from your boot logs. Will you check your boot logs and copy/paste me what it has there for the name of the plugin?
bad news the customiser still does not work for mystcraft worlds.
@arnnie
From what I can tell, no. Protect your machines and pipes some other way (encapsulate them with cobble for example).
Hi, Does it prevent interaction? To stop players from accessing someone else reactor.
@defkult
Put another block ID in there that isn't actually in the world. Like diamond sword. That will prevent it from resetting to default.
That's a good point, I hadn't thought of that. I will see what I can do about the log entries.
@GothicM
I didn't know this was a problem? Bukkit uses byte values for damage, which only go up to 128, so it might not be fixable. But I'll look into it.
@Koowluh
No sorry, Vanilla Minecraft, Tekkit, and Bukkit don't have the concept of block ownership. That means it's impossible for me to determine who a block belongs to once it's placed. Anyway it won't solve your problem - after the player creates a giant hole with his quarry, he would just move it and make another mess, and so on. It would slow the problem, but not solve it.
@yrthilian
Sorry, this plugin is developed for Tekkit. I guess you'll have to wait for Tekkit to update its Forge component.
@yrthilian
1.3 looks to be listed now. Maybe there was an approval delay. :)
@bigscary
latest files didnt update for downloading.
@defkult
this is down to how you edit the file. when adding a line press enter and then back space to clear out any tabs the add the item you wish to ban
same goes for removing an item from the ban list try and make sure there is no tab spacing.
If on linux i found useing nano to edit config files works best if on windows use notepade++
First have to say great work on the plugin. Will test with mystcraft and get back to you on that :D
regards Forge
you have forge installed on your server. If you are useing tekkit it is built in but out of date. the block limit in minecraft is 4093 i think and there is a fix to increase it above that. It is also built into forge.
This is the server that you manage that gives me that message when i try to join it. I personaly dont use tekkit and built up a tekkit like system and manage that with another.
Is it possible to restrict some items to 1 per person? I'm referring to the quarry here, which is one of the machines that players love, but admins hate.
I'd love to be able to allow this item, but only one (perhaps 2) per player. Perhaps with a message along the lines of "You already have a quarry at X,Y,Z, please remove this first" when placing another one.