NexoriaCore

NexoriaCore Documentation

Welcome to the official documentation for NexoriaCore, the foundational multi-threaded utility and API engine for modern Minecraft servers.

---

1. Installation

1. Download the latest NexoriaCore-1.0.0.jar from Modrinth.
2. Place the .jar file into your server's plugins/ directory.
3. Ensure your server is running on Java 25+ (or modern OpenJDK runtime) with Paper, Purpur, or Folia.
4. Start or restart your server to generate default configuration files.

---

2. Configuration (config.yml)

The configuration file is automatically generated in plugins/NexoriaCore/config.yml:

general:
  enabled: true
  debug-mode: false
  prefix: "<gradient:#00FFA3:#38BDF8>[NexoriaCore]</gradient> "

storage:
  cache-timeout-seconds: 300
  async-batch-size: 64

messages:
  no-permission: "<red>You lack the required permissions to run this command.</red>"
  reloaded: "<green>Configuration and data modules have been reloaded.</green>"

---

3. Commands & Permissions

Command	Description	Permission	Default
/core status	Displays active thread health and session metrics	nexoria.core.admin	OP
/core reload	Reloads all configuration files and data caches	nexoria.core.admin	OP
/core help	Shows command help reference	nexoria.core.use	Everyone

---

4. Developer API Integration

NexoriaCore provides a public developer API for dependency integration.

Gradle (Kotlin DSL)

repositories {
    maven("https://api.modrinth.com/maven")
}

dependencies {
    compileOnly("maven.modrinth:nexoria-core:1.0.0")
}

Accessing the API in Java

import dev.nexoria.core.NexoriaCorePlugin;
import dev.nexoria.core.CoreAPI;

public class MyPluginHook {

    public void initialize() {
        CoreAPI coreApi = NexoriaCorePlugin.getInstance().getApi();
        
        if (coreApi.isActive()) {
            // Check if server is running on multi-threaded Folia
            boolean folia = coreApi.isFolia();
            
            // Dispatch asynchronous non-blocking task
            coreApi.supplyAsync(() -> {
                // Background operations
            });
        }
    }
}

---

5. Frequently Asked Questions (FAQ)

Does NexoriaCore work on Folia?

Yes. NexoriaCore natively detects regional server architectures and utilizes region-safe schedulers without main-thread blocking.

Does NexoriaCore require any external libraries?

No. NexoriaCore is standalone and contains zero bloated external dependencies.