importLib

Imports a Java class.

Overview:

Functions:
importLib(pathToJar)

API Reference

importLib()

Returns the specified class if it exists.

var libLoader = importLib("library-name.jar");

Parameters:

• className(String) Name of the class to import.

• library-name.jar (String): The filename of the JAR library located inside the plugin’s libs folder.

  • The path is relative to the plugin’s directory, typically something like: plugins/openjs/Libs/library-name.jar

---

How It Works:

• The library JAR is loaded at runtime, making all its public classes and resources available to your script.

• After loading, you can use the returned loader object to get Java classes from the library, instantiate objects, and call methods.

• This approach enables powerful extensibility by letting you integrate third-party Java libraries into your scripts.

---

Example:

var RiveScriptLoader = importLib("rivescript-core-0.9.2.jar");
var RiveScriptClass = RiveScriptLoader.loadClass("com.rivescript.RiveScript");

// Create an instance of the RiveScript bot
var riveScript = RiveScriptClass.getConstructor().newInstance();

// Now you can call methods on riveScript

In this example, the RiveScript chatbot Java library is loaded from the Libs folder, and its main class is instantiated for use in your script.

Important Notes

• Make sure the .jar file is correctly placed inside the Libs folder of your plugin, and the filename matches exactly.

• The library must be compatible with the Java runtime your server uses.

• Loading large libraries may impact startup or script execution time.

• Use importLib only for trusted JARs to avoid security risks.