Logging

The logging system allows you to create and use custom loggers.

Instead of using System.out.println or mixing different logging approaches, all logging should go through a unified system:

Internally, the system uses Logback for structured and configurable logging.

When to use?

Use the Core logging system when:

Use plugin.getLogger() only for:

LoggerHandler loggerHandler = BukkitCoreLibrary.getLoggerHandler();

Logger logger = loggerHandler.registerLogger("example");

logger.info("This is an info message");
logger.warn("Something might be wrong");
logger.error("Something went wrong");

Logger logger = loggerHandler.getLogger("example");

Returns null if no logger is registered.

Collection<Logger> loggers = loggerHandler.getLoggers();

Collection<String> names = loggerHandler.getLoggerNames();

Logger logger = loggerHandler.registerLogger("name");

Logger logger = loggerHandler.registerLogger("name", "directory");

All logs are stored in: /loggers/%name%/logs

Inside the server directory.

Each logger has its own config file: /loggers/%name%/config.json

You can configure:

loggerHandler.registerLogger("example"); // throws if already exists

→ Always ensure the logger is only registered once (e.g. on plugin startup)

Logger logger = loggerHandler.getLogger("example");

→ May return null, always check before usage

→ Core loggers do NOT log to console by default

If you expect console output: