[TUT] How to Restrict Items/Block usage to levels!

Hello, I'd thought I would make my first tutorial on how to restrict item usage and block placing to a players level. Please read before posting. Enjoy!

What is The Point of Restricting Things to Levels?

This could be used for Role-Playing among other things. Leveling up to get better weapons/Tools has always been a part of RPG's.

So How DO You Do it?

It is quite simple really. Let's look at it piece by piece and explain what is happening. We will put it all together at the end.


First Off, Lets get started with a basic plugin base.

Code:JAVA

 
package me.kodfod.levelTools;
 
import org.bukkit.plugin.java.JavaPlugin;
 
public class Main extends JavaPlugin {
 
Logger log = Logger.getLogger("Minecraft");
 
@Override
public void onDisable() {
//Prints message to Console saying Disabled
log.info(this.getName() + " Disabled.");
}
 
@Override
public void onEnable() {
//Prints message to Console saying Enabled
log.info(this.getName() + " Enabled.");
}
 
 

Now That we have the base, we need to get the listener implemented:

Code:JAVA

 
import org.bukkit.event.Listener;
import org.bukkit.plugin.java.JavaPlugin;
 
//Implements Listener Allows us to use one class to get the Event.
public class Main extends JavaPlugin implements Listener {
 
@Override
public void onDisable() {
//Prints message to Console saying Disabled
log.info(this.getName() + " Disabled.");
}
 
@Override
public void onEnable() {
//Prints message to Console saying Enabled
log.info(this.getName() + " Enabled.");
//This Next Line Registers The Event In This Class
this.getServer().getPluginManager().registerEvents(this, this);
}
 
 

Now That We have The Event register we need to make it:

Code:JAVA

 
//Below your onEnable()
@EventHandler
//Import the EventHandler && BlockBreakEvent
public void onToolUse(BlockBreakEvent e) {
// e is the short cut of saying BlockBreakEvent
}
 
 

Now time to check what they broke the block with:

Code:JAVA

 
// e = the event // Checking if the item in hand is equal to Diamond pickaxe.
if (e.getPlayer().getItemInHand().getTypeId() == Material.DIAMOND_PICKAXE
.getId()) {
}
 

Time to get the level set to allowed to use it

Code:JAVA

 
if (e.getPlayer().getItemInHand().getTypeId() == Material.DIAMOND_PICKAXE
.getId()) {
 
// we do - 1 because we are doing Greater Than the level. So if you put in 5 we are checking for any level above 4.
if (e.getPlayer().getLevel() > (getConfig().getInt(
"Diamond.Pickaxe.Use") - 1)) {
return;
}
 
 

That is if the level is greater than the conifg option. If it's not:

Code:JAVA

 
else {
e.setCancelled(true);
e.getPlayer().sendMessage(
ChatColor.AQUA + "You Need To Be Level "
+ ChatColor.GOLD
+ getConfig().getInt("Diamond.Pickaxe.Use")
+ ChatColor.AQUA
+ " To use the Diamond PickAxe.");
// this cancels the break, ans sends the player a message.
}
}
 
 

Now For the Config.yml, you need to create it in the same directory as your plugin.yml.
It Should look Something like this:

Code:

Diamond:
  Pickaxe:
    Use: 5

Now, we need to do a few more final touches:

Code:JAVA

 
import org.bukkit.ChatColor;
import org.bukkit.Material;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.block.BlockBreakEvent;
import org.bukkit.plugin.java.JavaPlugin;
//imported all the chat colors and other things,
 
public class Main extends JavaPlugin implements Listener {
 
@Override
public void onDisable() {
//Prints message to Console saying Disabled
log.info(this.getName() + " Disabled.");
this.saveConfig();
 
}
 
@Override
public void onEnable() {
//copies the config and saves it if it's not there
this.getConfig().options().copyDefaults(true);
this.saveConfig();
this.getServer().getPluginManager().registerEvents(this, this);
//Prints message to Console saying Enabled
log.info(this.getName() + " Enabled.");
}
 

Now Everything put together:

Code:JAVA

 
import org.bukkit.ChatColor;
import org.bukkit.Material;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.block.BlockBreakEvent;
import org.bukkit.plugin.java.JavaPlugin;
 
public class Main extends JavaPlugin implements Listener {
 
@Override
public void onDisable() {
//Prints message to Console saying Disabled
log.info(this.getName() + " Disabled.");
this.saveConfig();
 
}
 
 
@Override
public void onEnable() {
//copies the config and saves it if it's not there
this.getConfig().options().copyDefaults(true);
this.saveConfig();
this.getServer().getPluginManager().registerEvents(this, this);
//Prints message to Console saying Enabled
log/info(this.getName() + " Enabled.");
}
 
 
@EventHandler
public void onToolUse(BlockBreakEvent e) {
if (e.getPlayer().getItemInHand().getTypeId() == Material.DIAMOND_PICKAXE
.getId()) {
if (e.getPlayer().getLevel() > (getConfig().getInt(
"Diamond.Pickaxe.Use") - 1)) {
return;
} else {
e.setCancelled(true);
e.getPlayer().sendMessage(
ChatColor.AQUA + "You Need To Be Level "
+ ChatColor.GOLD
+ getConfig().getInt("Diamond.Pickaxe.Use")
+ ChatColor.AQUA
+ " To use the Diamond PickAxe.");
}
}
}
 

Blocks:

Now For Blocks. The Concept is the same, except for you are going to look for block placed and destroyed.

Code:JAVA

 
public void onBlockPlace(BlockPlaceEvent e) {
if (e.getBlock().getTypeId() == Block.STONE.id) {
if (e.getPlayer().getLevel() > (getConfig().getInt(
"Block.place." + e.getBlock().getTypeId) - 1)) {
return;
} else {
e.setCancelled(true);
e.getPlayer().sendMessage(
ChatColor.AQUA + "You Need To Be Level "
+ ChatColor.GOLD
+ getConfig().getInt("Block.Place." + e.getBlock().getTypeId)
+ ChatColor.AQUA
+ " To Place this block.");
}
}
 

Everything else is the same.


That's it! If You Have any Questions Feel Free to ask!

 

its beeter if you use the loggers instead of System.out

 

meh i usally do, but oh well i'll change it

 

Since you're using a config, wont this affect the whole server, not just one player?

 

You can add a bypass by adding a permission node and a check inside the events:
if player does not have restrict.bypass permission: block
else return

But by default it blocks it for everyone.