This repository was archived by the owner on Aug 9, 2025. It is now read-only.
🎮 NDCore v3.0.0
🎯 Release Overview
Version 3.0.0 introduces an enhanced logging system (merged from the Lumina project), improves plugin instance
retrieval, and provides better null safety with JetBrains annotations.
🚀 Key Changes
-
Enhanced Logging System (Merged from Lumina):
- Integrated the Lumina logging project directly into NDCore for streamlined dependency management.
- Introduced
NDLoggerwith multiple logging levels (INFO, WARN, ERROR, FATAL). - Implemented
LoggingStrategyinterface for customizable logging behavior. - Added
DefaultLoggingStrategywith color-coded console output and organized log files. - Deprecated standard
getLogger()method in favor of the newlogger()method.
-
Improved Plugin Instance Retrieval:
- Added
getNDPlugin(Class<T> clazz)method for more convenient NDPlugin instance retrieval. - Enhanced type safety with proper casting to NDPlugin.
- Added
-
Null Safety Enhancements:
- Added JetBrains annotations (@NotNull) throughout the codebase.
- Improved null checking with Objects.requireNonNull() in constructors.
- Enhanced parameter validation for better error handling.
📦 Installation
- Download NDCore-3.0.0.jar
- Place the JAR file in your server's
pluginsfolder - Restart your server
- The plugin will load automatically as a dependency
💻 For Developers
For comprehensive documentation on how to use NDCore, please refer to the Introduction in the
usage directory.
To use NDCore as a dependency, add the following to your plugin.yml:
depend: [NDCore]and import it via maven central:
Gradle
implementation 'dev.nelmin.minecraft:core-paper:3.0.0'Gradle (Kotlin)
implementation("dev.nelmin.minecraft:core-paper:3.0.0")Maven
<dependency>
<groupId>dev.nelmin.minecraft</groupId>
<artifactId>core-paper</artifactId>
<version>3.0.0</version>
</dependency>📌 System Requirements
- Java 21 or higher
- Compatible with PaperMC 1.21.4 or higher