update "Dependencies" and "Libraries" pages

Author: Grabsky

dependencies.md

@@ -4,4 +4,38 @@ order: 97
 ---
 
 # Dependencies
-TO-DO
+LuaLink provides a way to access and use plugins' APIs in your scripts. This feature is very powerful and makes it easy to integrate scripts with other plugins. It must be noted this has not been thoroughly tested yet and some issues may arise. Please be cautious when using this feature.
+
+!!! warning EXPERIMENTAL
+Current implementation, despite being relatively simple and fully functional, is still marked as experimental.
+We may introuduce breaking changes to the way dependencies are declared and exposed to scripts.
+!!!
+
+<br />
+
+<!--
+## Declaring Dependencies
+To declare a dependency, you must create an `init.lua` file in your script's folder. In this example we will use **[PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.19978/)**.
+
+```lua /plugins/LuaLink/scripts/example_script/init.lua
+depends {
+    "PlaceholderAPI"
+}
+```
+
+**Why is that important?** Declaring dependency will ensure that script will not be loaded if **PlaceholderAPI** plugin is missing.
+-->
+
+## Using Dependencies
+Importing any class that belongs to an installed plugin should work out of the box. In this example we will use **[PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.19978/)**, a plugin you should be already familiar with.
+
+Assuming the plugin is **installed** and **enabled** on the server, we should be able to call its API like any other function.
+```lua /plugins/LuaLink/scripts/example_script/main.lua
+local PlaceholderAPI = import("me.clip.placeholderapi.PlaceholderAPI")
+
+script.logger:info(PlaceholderAPI:setPlaceholders(nil, "Server is running %server_variant% %server_version_full%"))
+```
+```log Console Output
+[00:00:00 INFO]: [LuaLink/example_script] Server is running Paper 1.21.4-224
+```
+That's it. As mentioned earlier, current implementation is really simple and should just work.

libraries.md

@@ -4,21 +4,21 @@ order: 96
 ---
 
 # Libraries
-LuaLink provides a way to load external **Java** libraries for use in your scripts, as well as to define and/or use external **Lua** libraries.
+LuaLink provides a way to load external **Java** libraries for use in your scripts, as well as to define and use external **Lua** libraries.
 
 <br />
 
+<!--
 ## Lua Libraries
 External Lua libraries can be added by creating or copying files to the `/plugins/LuaLink/libs/` folder.
 
 ==- Example Lua Library
 ```lua **/plugins/LuaLink/libs/example_library/main.lua**
-local Counter = {}
-Counter.__index = Counter
+Counter = {}
 
 -- Creates a new Counter instance.
 function Counter.new()
-    local self = setmetatable({}, Counter)
+    local self = setmetatable({}, {__index = Counter})
     self.count = 0
     return self
 end
@@ -37,8 +37,6 @@ end
 function Counter:get()
     return self.count
 end
-
-return Counter
 ```
 ==-
 
@@ -51,7 +49,7 @@ local Counter = require("example_library")
 
 script:onLoad(function()
     -- Creating a new instance of the Counter class.
-    local counter = Counter()
+    local counter = Counter:new()
     -- Incrementing the counter three times.
     counter:increment()
     counter:increment()
@@ -63,6 +61,8 @@ end)
 
 <br />
 
+-->
+
 ## Java Libraries
 External Java/Kotlin libraries can be added by configuring the `/plugins/LuaLink/libraries.json` file. Dependencies will be downloaded and exposed to the scripting runtime after server restart.
 
@@ -72,7 +72,7 @@ External Java/Kotlin libraries can be added by configuring the `/plugins/LuaLink
     // Repositories to be used for dependency resolution.
     "repositories": {
         // Repository definition using simple format.
-        "MavenCentral": "https://repo.maven.apache.org/maven2/",
+        "PaperMC": "https://repo.papermc.io/repository/maven-public/",
         // Repository definition with credentials authentication.
         "SomePrivateRepository": {
             "url": "https://repo.example.com/private",
@@ -83,17 +83,21 @@ External Java/Kotlin libraries can be added by configuring the `/plugins/LuaLink
     // Dependencies to be downloaded and exposed to the scripting runtime.
     // Entries must be specified using Maven coordinate format: groupId:artifactId:version
     "dependencies": [
-        "com.github.stefvanschie.inventoryframework:IF:0.10.11"
+        "io.papermc:paperlib:1.0.7"
     ]
 }
 ```
 
-In this example, we are adding stefvanschie's [IF](https://github.com/stefvanschie/IF) library of version `0.10.11` from [Maven Central](https://repo.maven.apache.org/maven2/) repository. You can also see how and authenticate with a private repository using credentials, which might be essential when working with closed-source projects or [GitHub Packages](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry).
+In this example, we are adding **[PaperLib](https://github.com/PaperMC/PaperLub)** library of version **1.0.7** from **[PaperMC](https://repo.papermc.io/repository/maven-public/)** repository. You can also see how and authenticate with a private repository using credentials, which might be essential when working with closed-source projects or **[GitHub Packages](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry)**.
 
 After restarting the server, we should be able to import and access any class that belongs to specified library(-ies).
 
-```lua /plugins/LuaLink/scripts/example_script/init.lua
--- TO-DO
-```
+```lua /plugins/LuaLink/scripts/example_script/main.lua
+local PaperLib = import("io.papermc.lib.PaperLib")
 
-<br />
+script.logger:info("Is the server running Paper? " .. (PaperLib:isPaper() and "YES" or "NO") .. "!")
+```
+```log Console Output
+[00:00:00 INFO]: [LuaLink/example_script] Is the server running Paper? YES!
+```
+While this example may not be the best use of **PaperLib** - especially because **LuaLink** requires you to run the plugin on **Paper** - it is still a good example of how to use external libraries in your scripts.