Customizable item/block banner, with default values for commonly-banned Tekkit items. Extremely easy to configure, requires no permissions management unless you want to make exceptions for some of your players. Can even retroactively remove banned items from the world and player inventories, and log information about confiscated items for further investigation (to see how players are getting the banned items).
Because every story that starts with "We decided to start up a Tekkit server..." shouldn't end with "...so we had to reset the world."
You can experience this plugin for yourself (as a player) by joining this public server. :) I maintain this one personally, which helps me catch bugs and spot opportunities for new features and improvements. Have fun!
IMPORTANT: Please get the right version for your server. Each version at right is labeled with a CraftBukit version. Find out what CraftBukkit version your server is running, and get the right version of TekkitCustomizer for you. IF YOU DO NOT, NOTHING WILL WORK. :)
To install, just copy the .jar file into your plugins folder and restart your server (or /reload for non-Tekkit servers).
The default ban list is very good FOR CLASSIC TEKKIT and based on testing (not just reading wikis and forums). You can safely start your CLASSIC TEKKIT public server with the default ban list. Before you decide to REMOVE items from the default ban list, be sure to read the reasons for default bans to understand the risk you're taking. If you're running another flavor, like FTB, MCPC, Tekkit Lite, and so on, you should do your own research to determine which items need banning and adjust your config file.
Troubleshooting and Common Questions
Save yourself some time! Check this page for the answer to your question.
Config File Format
A config entry 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 damage value. Some blocks have the same ID, but a different damage value. For example, 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, and will appear in the logs to help you remember what the various IDs and data values mean.
The last part is the reason for the ban. This reason will be shown to players when it's helpful, for example when a player tries to craft a banned item. If you don't fill in the reasons for your bans, you will find yourself constantly explaining 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. I recommend NotepadPlusPlus for editing config files - it's free, a very short download, and will help you catch your mistakes.
Where Do I Get IDs and Damage Values?
Use /blockinfo (requires op or tekkitcustomizer.blockinfo permission). This will tell you both the information about the item you're holding, and also the one you're pointing at in the world. IMPORTANT NOTE: Many items have a different value in your inventory versus in the world. One common example is the wooden door, although you're unlikely to ban it. So keep that in mind for troubleshooting any new bans you add.
Making Exceptions to Bans
Ops ignore bans. So does any player with permission tekkitcustomizer.* .
If you want to give some players access to otherwise banned items, you can accomplish that with permissions. Here are various examples, which I hope you understand without further explanation. I will not help you troubleshoot setting permissions - I understand that most permissions plugins are overly complicated, confusing, and difficult to use. I am not an expert on all of those, so I can't help you troubleshoot assigning permissions to your players.
You may notice that you can't prevent a specific player's placed block from being removed from the world, because we don't know who owns which blocks in the world.
Permissions plugins are confusing, and it's common for administrators to have difficulty with them. The most common mistake is using the permission plugin's config file format incorrectly, which results in players having the wrong permissions (even though it "looks right" in the file). The best way to troubleshoot this is to use in in-game slash command to see what permissions a player actually has, rather than what you think he has based on your config file. For example, the PermissionsBukkit command is /permissions player dump [player name]. Check your permissions plugin documentation for the right "permissions dump" command for your permissions system.
Types of Bans
This ban prevents a player from actively using an item, which means left-click or right-click while the item is in-hand. This will work well for items like the Mining Laser, but won't stop players from using items which benefit from passive use, like various armors and the Talisman of Repair. For those, you will need a crafting ban and/or ownership ban (see below) to prevent players from getting those items at all.
It's not possible for a Bukkit plugin to prevent a player from using an item when it has an alternate activation keystroke, like R or G or C, which are common especially for Equivalent Exchange items (seriously, any other plugin which claims to stop players from using these has not tested their own claims). For that reason, many of the EE items are (sadly) on the default ownership bans list even though not all of their functions are really ban-worthy. Sorry!
Prevents a player from crafting an item. When the player tries to craft the item, he gets a message telling him that he can't. This is the most player-friendly approach to preventing players from getting banned items. However PLEASE NOTE! Because Tekkit mods don't always play by Bukkit rules, it might be possible for players to get banned items through some automatic or non-crafting (alchemy?) approach. When you ban crafting for an item, you should test for possible 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.
This will prevent a player from picking-up an item from the ground or from a container (like a chest), or crafting it. Additionally, the contraband scanner will occasionally scan 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.
If you find a common workaround to ownership or crafting bans, please tell me so that I can add more default bans to cut off those workarounds.
Prevents a player from building a block in the world. If a player doesn't have permission to place an item, he also won't be able to craft it. If a player already has an item which is later placement banned, he might be able to trade it to another player or break it down into energy (Equivalent Exchange mod), allowing him to get some value out of it, which is better than simply taking the item away from him without compensation.
I strongly recommend placing most or all of the items you put on your placement ban list also on 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, which will lead 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.
Anything in this ban list will be regularly removed from the world by the contraband scanner! This is a great option if you recently realized you need to ban an item, but worry that it's already out there in the world (energy collector and world anchor, anyone?). This allows you to clean up newly-banned items without having to actually explore your entire world in search of them. No matter where they hide, they will be removed. Of course, there's no making exceptions to this rule, since the scanner can't determine who owns the contraband 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. If you find a common workaround to placement or crafting bans, please tell me so that I can add more default bans to cut off those workarounds.
Looking for a Maintainer!!
Minecraft development has lost its appeal for me - the work I'm doing today (minor bug fixes, tiny feature adds) is not as rewarding as it used to be (awesome new features that have a huge positive impact). This doesn't mean that this plugin will go away or stop working. I will continue to fix bugs and make necessary updates for new Minecraft versions, but I am no longer taking feature requests.
I need someone who already develops at least one other plugin to take over here to at least maintain the plugin, and optionally, to continue adding features. If you or someone you know is interested, please send me a private message here on dev.bukkit.org.
More Great Plugins!
My plugins solve Vanilla problems in ways which minimize impact on servers, administrators, and players, so everybody can enjoy Minecraft without having to learn to play the game in a new way or spend more time administrating than playing. My goals are effectiveness, simplicity, and efficiency. If you like this plugin, check out more of my work:
- Grief Prevention
- Prevents ALL types of grief (Tekkit compatible).
- Easy for players and admins, mostly automatic.
- Players claim land to prevent theft and house wrecking.
- Automatically warn, mute, and kick or ban spammers.
- Blocks dumping lava and setting fire on another player in non-PvP servers.
- Disable fire damage, spread, or both.
- Wipe away ugly builds with a right-click - no database required!
- Automatically prevents spawn camping in PvP servers.
- Prevent damage to the surface by limiting lava and water placement, and TnT damage.
- Automatically clean up hanging tree tops.
- Includes a creative mode for creative worlds.
- Optional siege mode for build-based PvP.
- Population Density
- Automatically assigns new players to wilderness where they'll find other new players and plenty of space, wood, and ore.
- Optional teleportation system which can't be abused by players to escape combat or save them from being lost.
- Login queue to guarantee fairness when the server is full.
- Optional reserved spots for administrators.
- Automatically removes idle players when the server is nearly full.
- Limits how quickly players can mine valuables, based on their play time / values mined ratio.
- Keeps your valuables in the ground, so non-cheating players can find them (unlike ore loggers).
- Practically free to run, unlike the tremendously expensive Orebfuscator.
- Most legit players won't notice, but xrayers will ragequit and move on.
I spend a lot of my free time designing, developing, testing, and discussing this plugin to make Minecraft last longer for all players. If you like this plugin, please consider sending me $5 by clicking the blue "donate" link at the top of this page. :) Thanks!
These guys are kind enough to host the test server for this plugin. They have a great web console and quick ticket response.
Table of contents
- 1 Official Server
- 2 Setup
- 3 Troubleshooting and Common Questions
- 4 Config File Format
- 5 Where Do I Get IDs and Damage Values?
- 6 Making Exceptions to Bans
- 7 Types of Bans
- 8 Looking for a Maintainer!!
- 9 More Great Plugins!
- 10 Donations
- Date created
- Aug 27, 2012
- Last update
- Feb 15, 2013
- Development stage
- All Rights Reserved
- Curse link
- Tekkit Customizer
- Recent files