I little bit ago I found that I was using System.out.println(); a lot for debugging things and this got really annoying because I would have to search through a lot of printouts to find the debug line I was looking for and then I would continually get lost with where I was in the file or which file which debug statement was from so I decided to create my own debug prints and thought others might be able to use this to help them. This is a self contained class. The only thing that you might want to do is call the initialize method from your main class or you could just use a static block, I was just finding places where I would want to use this before I finished setting up my config and I wanted the config values for this to be at the bottom of the file. Anyways, this allows you to use formatted debug prints with different levels and it allows the use of color. Each level creates it's own config variable under the "BASE_CONFIG_PATH" when it is initialized so that if you accidentally leave plain debug prints in it when you submit your plugin you don't have to worry about your users seeing those. They each then have their own header/footer print, a color to print with, and if they should print out the class, method, and/or line that it was called from. What I did was to have 4 levels of statements: Info: This is just for when I want data from something and don't really care where it is and in what class, method, or line so those are all disabled. Debug: I use this when I trying to fix a problem. I typically end up having 5 or 6 of these if I can't figure it out so I print out the class, method, and line so that I can get to exactly where it is in a matter of seconds. Warning: This is something that went somewhat wrong but won't break the plugin and is something that my users might be good to know about as some things might not work correctly. I print the class and line with this just in case something gets screwed up on someone's server and these get thrown a lot so that I can find where the source of the problem is faster than just searching through a bunch of different files first. Error: This one is special, I bypass the config system and force this to always be shown. This is for if the code gets somewhere that will probably end up breaking the plugin or crashing the server and is something that I should probably be alerted from. The header I made so that the start and end are easy to find of the debug print but can easily be taken out if you find them annoying. I also made quick access methods for convince but they all go to the main print methods with the correct level. The print method takes in a message priority and a list of messages. It first checks if the priority should be displayed and then does nothing if it shouldn't. If it should, then retrieves the console sender so that it can use colors when printing out and retrieves the current threads StackTrace. It looks through that until it finds the last call from a class that isn't its own class and uses that one to get the class, method, and line number. It then prints the header and checks if it should print the class, method, and lines and if so then it prints them out. After that it prints out "Messages: " so that you (or others) know what you are actually trying to say. It then prints out every message that was sent in on a different line and once again prints out the header to end it. It also checks if there are any resets are puts its own color after that so you can use a reset but it will just revert back to its own color instead of going to your console's text color. To call this you would just use DebugPrint.println(pritoity, messages) or you would use one of the shortcut methods like (in this one) info, debug, warning, or error. Anyone that wants to use this go ahead and use it how you want.Anyone that has any ideas on me improving this tell me. Class (I use this for my TARDIS plugin if you can't tell): Code:java public class DebugPrint{ protected static final String BASE_CONFIG_PATH = "ConsoleMessages."; public static enum MessagePriority { INFO("Info", false, "[TARDIS Info]", ChatColor.GRAY, false, false, false), DEBUG("Debug", false, "***[TARDIS Debug]***", ChatColor.DARK_GREEN, true, true, true), WARNING("Warning", true, "****[TARDIS Warning]****", ChatColor.GOLD, true, false, true), ERROR("*****[TARDIS ERROR]*****", ChatColor.DARK_RED, true, true, true); protected boolean use = false; protected boolean defaultUse = false; protected String headerFormat; protected String configPath = null; protected ChatColor displayColor; protected boolean classPrint, methodPrint, linePrint; //Forces this one to be used private MessagePriority(String headerFormat, ChatColor color, boolean classPrint, boolean methodPrint, boolean linePrint) { this.use = true; this.headerFormat = headerFormat; this.displayColor = color; this.classPrint = classPrint; this.methodPrint = methodPrint; this.linePrint = linePrint; } //The config path dictates if this should be on or off private MessagePriority(String configPath, boolean defaultUse, String headerFormat, ChatColor color, boolean classPrint, boolean methodPrint, boolean linePrint) { this.defaultUse = defaultUse; this.configPath = configPath; this.headerFormat = headerFormat; this.displayColor = color; this.classPrint = classPrint; this.methodPrint = methodPrint; this.linePrint = linePrint; } public boolean shouldUse() { return this.use; } public String getHeaderFormat() { return this.headerFormat; } public ChatColor getDisplayColor() { return this.displayColor; } public boolean isClassPrint() { return this.classPrint; } public boolean isMethodPrint() { return this.methodPrint; } public boolean isLinePrint() { return this.linePrint; } //Get if this should be turned on from the config public void initalize(TARDISMain plugin) { if(this.configPath != null) { if(!plugin.getConfig().contains(BASE_CONFIG_PATH + this.configPath)) { plugin.getConfig().set(BASE_CONFIG_PATH + this.configPath, this.defaultUse); plugin.saveConfig(); } this.use = plugin.getConfig().getBoolean(BASE_CONFIG_PATH + this.configPath); } } } //Shortcut for info messages public static void info(String... messages) { DebugPrint.println(MessagePriority.INFO, messages); } //Shortcut for debug messages public static void debug(String... messages) { DebugPrint.println(MessagePriority.DEBUG, messages); } //Shortcut for warning messages public static void warning(String... messages) { DebugPrint.println(MessagePriority.WARNING, messages); } //Shortcut for error messages public static void error(String... messages) { DebugPrint.println(MessagePriority.ERROR, messages); } //prints out with the specified priority public static void println(MessagePriority priority, String... messages) { if(priority.shouldUse()) { ConsoleCommandSender console = Bukkit.getConsoleSender(); ChatColor color = priority.getDisplayColor(); StackTraceElement[] elements = Thread.currentThread().getStackTrace(); int callIndex = 1; while(elements[callIndex].getClassName().equals(DebugPrint.class.getName()) && callIndex < elements.length - 1) callIndex++; console.sendMessage(color + priority.getHeaderFormat()); if(priority.isClassPrint()) console.sendMessage(color + "Class: " + elements[callIndex].getClassName()); if(priority.isMethodPrint()) console.sendMessage(color + "Method: " + elements[callIndex].getMethodName()); if(priority.isLinePrint()) console.sendMessage(color + "Line: " + elements[callIndex].getLineNumber()); if(messages.length > 0) console.sendMessage(color + "Message:"); for(String s : messages) { console.sendMessage(color + " " + s.replaceAll("" + ChatColor.RESET, "" + ChatColor.RESET + color)); } console.sendMessage(color + priority.getHeaderFormat()); } } //Tells the priorities to check the config file if they should be used public static void initalize(TARDISMain plugin) { for(MessagePriority priority : MessagePriority.values()) { priority.initalize(plugin); } }} TARDISMain is my main class to get the config file from.
You might want to take a look at this: http://forums.bukkit.org/threads/tutorial-remote-debugging-with-bukkit.92081/ very usefull!
