c88eab84a8
This change allows slf4bukkit to run on Bukkit implementations without jansi by making ColorMapper an interface. Instances are created by using a ColorMappingFactory: If the Bukkit implementation bundles jAnsi, an AnsiColorMapper is returned that maps ChatColors to their ansi equivalents; if the Bukkit implementation does not bundle jAnsi, a NotSupportedColorMapper is returned that returns strings as is.
SLF4Bukkit
SLF4Bukkit is an SLF4J binding that uses Bukkit's plugin logging system.
Server Administrators
If you were linked here by documentation for a plugin that you're using on your Bukkit/Spigot server, go here to learn what configuration options you have available (and please ask the plugin developer to fix their links!).
Plugin Developers
If you wish to use SLF4J in your Bukkit plugin, or if your plugin has a dependency on a library that uses SLF4J:
- Reference the rjenkinsjr Maven2 Repository in your POM.
- Shade SLF4Bukkit into your plugin project:
<dependency>
<groupId>info.ronjenkins</groupId>
<artifactId>slf4bukkit</artifactId>
<version>0.1.5</version>
</dependency>
- (Optional) Add your desired default configuration values to your plugin's built-in config.yml file. For more details, see the Javadocs for the BukkitLoggerAdapter class.
- (Optional) Use the SLF4J API in your code.
- SLF4Bukkit supports only ColorMarkers, which format the entire message and associated throwable (if any). All other markers are discarded. ColorMarkers always override the default level-specific formatting defined in the plugin config.
- In addition to using ColorMarkers, you can use Bukkit's
ChatColorvalues to further format your message. - SLF4Bukkit issues
ChatColor.RESETafter every log message, so you don't have to worry about resetting after each message. - You can use the ColorString class to easily create colored log messages.