KappaEssentials Extension Loader

A lightweight and secure extension system for KappaEssentials

Supports Paper 1.21+ · Java 21

What is it?

KappaEssentials Extension Loader allows you to safely load modular .jar extensions for the KappaEssentials plugin.

It's a separate plugin that reads .jar files from a specific folder and loads them only if they are explicitly allowed by their internal ID.

How it works

• On startup, the loader looks inside: plugins/KappaEssentials/extensions/

• Each .jar must contain an extension.yml file with:

• id: my-extension main: my.package.MyExtensionClass

• The loader only enables .jar files with IDs that are hardcoded in its whitelist.

• It loads the main class, initializes it, and calls onEnable() and onDisable() on shutdown.

Features

• Modular, keep KappaEssentials clean and minimal

• Simple API, just implement KappaExtension

• Supports Paper 1.21+, built for modern servers

• Open design, more extensions coming soon!

For Extension Developers

Extensions must:

• Be valid .jar files

• Contain an extension.yml at root:

id: example-extension
main: net.example.MyExampleExtension

More dev tools, examples, and extension templates will follow.

Currently Working Exteensions

• KappaEssentials - Virtual Spawners (in developement)
• KappaEssentials - Quest Manager (in developement)
• KappaEssentials - CombatLog (coming soon)
• KappaEssentials - 3x3Pickaxe (coming soon)

Requirements

Java 21

Bukkit/Spiggot/Paper 1.21+

KappaEssentials (must be installed)

Coming Soon

Dynamic extension whitelist via config

Extension reload command

Extension API registration system

Support & Feedback

Join the KappaSMP Discord or open an issue on GitHub to suggest features, report bugs, or showcase your custom extensions.