feat: Introduce Scala 3 and Enhance V8 Engine Integration

Actively begin the adoption of Scala 3, with plans for small, non-breaking migrations in the future. Improve V8 Engine implementation by integrating Javet for better performance and stability.

Author: QwQ-dev

README.md

@@ -12,30 +12,37 @@
 
 ## Overview
 
-A Modular Plugin Toolkit built on [Fairy Framework](https://github.com/FairyProject/fairy), featuring modular design and leveraging modern Java 21 features.
-It provides essential tools and utilities for modern Minecraft plugin development with cross-platform support for Spigot, Paper, and Folia.
+A Modular Plugin Toolkit built on [Fairy Framework](https://github.com/FairyProject/fairy), featuring modular design and
+leveraging modern Java 21 features.
+It provides essential tools and utilities for modern Minecraft plugin development with cross-platform support for
+Spigot, Paper, and Folia.
 
 ## Core Modules
 
-- [**foundation**](foundation/README.md) - Core foundation module providing essential testing infrastructure, utilities, and base abstractions for all library modules.
+- [**foundation**](foundation/README.md) - Core foundation module providing essential testing infrastructure, utilities,
+  and base abstractions for all library modules.
 - [**annotation**](annotation/README.md) - Powerful annotation processing framework with flexible scanning options and
   lifecycle management.
-- [**aop**](aop/README.md) - Enterprise-grade Aspect-Oriented Programming framework with ClassLoader isolation, providing performance monitoring, thread safety, logging, and exception handling aspects.
+- [**aop**](aop/README.md) - Enterprise-grade Aspect-Oriented Programming framework with ClassLoader isolation,
+  providing performance monitoring, thread safety, logging, and exception handling aspects.
 - [**commons**](commons/README.md) - Essential utilities including VarHandle injection, task scheduling, virtual thread
   scheduling, JSON operations, and random object generation.
 - [**configuration**](configuration/README.md) - Flexible configuration framework built on SimplixStorage with
   serialization support.
 - [**mongodb**](mongodb/README.md) - Streamlined MongoDB integration with Morphia for efficient data persistence.
 - [**cache**](cache/README.md) - Multi-tier caching system integrating Caffeine and Redis, providing comprehensive lock
   management and a generic framework for thread-safe resource access.
-- [**player**](player/README.md) - Enterprise-grade distributed data management framework building high-performance entity-relationship data layers. Capable of **seamlessly handling thousands of inter-entity** relationship networks and state synchronization.
+- [**player**](player/README.md) - Enterprise-grade distributed data management framework building high-performance
+  entity-relationship data layers. Capable of **seamlessly handling thousands of inter-entity** relationship networks
+  and state synchronization.
 - [**script**](script/README.md) - Powerful, flexible, extensible, and high-performance script execution engine wrapper
   that supports `Rhino`, `Nashorn` and `V8` `JavaScript` engines.
 
 - [**experimental**](experimental/README.md) - Some experimental modules that can significantly improve performance, but
   may be too complex to use or temporarily unstable.
     - [**third-party-schedulers**](experimental/third-party-schedulers/README.md) - Achieves distributed task processing
-      via gRPC external task schedulers (currently implemented in Rust), enabling large plugin decoupling and performance improvements (for backends
+      via gRPC external task schedulers (currently implemented in Rust), enabling large plugin decoupling and
+      performance improvements (for backends
       that cannot directly access the Bukkit API). Ideal for machine learning, anti-cheat large data computation,
       mathematics, and similar
       applications.
@@ -101,15 +108,25 @@ is a Folia fork with many useful optimizations, configurable vanilla features, a
 
 ![luminol-mc-logo.png](./luminol-mc-logo.png)
 
-[PromptX](https://github.com/Deepractice/PromptX) is an AI application-native professional capability enhancement system developed by [Deepractice](https://github.com/Deepractice), playing a key role in this project.
+[PromptX](https://github.com/Deepractice/PromptX) is an AI application-native professional capability enhancement system
+developed by [Deepractice](https://github.com/Deepractice), playing a key role in this project.
 
 ![promptx-logo.png](./promptx-logo.png)
 
 ## Contributing
 
-We warmly welcome more developers to join our open source project and contribute their strength. Whether it's sharing ideas, creating Issues, or submitting Pull Requests, every contribution is significant!
+We warmly welcome more developers to join our open source project and contribute their strength. Whether it's sharing
+ideas, creating Issues, or submitting Pull Requests, every contribution is significant!
 
-We are very liberal with our use of AI. You can use any AI you want to write and contribute code, as long as it all works and meets the requirements in [CLAUDE.md](CLAUDE.md) (this is a Chinese document).
+We are very liberal with our use of AI. You can use any AI you want to write and contribute code, as long as it all
+works and meets the requirements in [CLAUDE.md](CLAUDE.md) (this is a Chinese document).
+
+## Future plans
+
+We are treating this library as a major dependency for keeping our entire server running (LegacyLands Minecraft server),
+and we are actively introducing Scala 3 into it. There will be small portions of non-breaking migration to Scala 3 in
+the future, leveraging its superior type system, concurrency model, and functional programming capabilities for better
+performance and maintainability.
 
 ## Star History
 

README_ZHCN.md

@@ -95,6 +95,17 @@ dependencies {
 
 ![promptx-logo.png](./promptx-logo.png)
 
+## 贡献
+
+我们热烈欢迎更多开发者加入我们的开源项目，贡献自己的力量。无论是分享想法、创建 Issue，还是提交 Pull Request，每一份贡献都是有意义的！
+
+我们对使用 AI 非常宽容。您可以使用任何 AI 来编写和贡献代码，只要它能正常工作并满足 [CLAUDE.md](CLAUDE.md) 中的要求即可。
+
+## 未来计划
+
+我们将这个库作为维持整个服务器运行（LegacyLands Minecraft 服务器）的主要依赖，并正在积极引入 Scala 3。未来将进行小部分的非破坏性迁移到
+Scala 3，利用其优越的类型系统、并发模型和函数式编程能力来获得更好的性能和可维护性。
+
 ## Star 历史
 
 [![Star History Chart](https://api.star-history.com/svg?repos=LegacyLands/legacy-lands-library&type=Date)](https://star-history.com/#LegacyLands/legacy-lands-library&Date)

build.gradle.kts

@@ -13,8 +13,11 @@ plugins {
     // Java plugin
     id("java-library") apply true
 
+    // Scala
+    id("scala") apply true
+
     // Fairy framework plugin
-    id("io.fairyproject") version "0.7.13b3-SNAPSHOT" apply false
+    id("io.fairyproject") version "0.8b1-SNAPSHOT" apply false
 
     // Dependency management plugin
     id("io.spring.dependency-management") version "1.1.7"
@@ -23,7 +26,7 @@ plugins {
     id("org.jetbrains.kotlin.jvm") version "2.1.21" apply false
 
     // Shadow plugin, provides the ability to shade fairy and other dependencies to compiled jar
-    id("com.github.johnrengelman.shadow") version "8.1.1" apply true
+    id("com.gradleup.shadow") version "9.0.0-rc1" apply true
 
     // Lombok
     id("io.freefair.lombok") version "8.13.1" apply false
@@ -34,7 +37,7 @@ plugins {
 
 allprojects {
     // Apply Shadow plugin
-    apply(plugin = "com.github.johnrengelman.shadow")
+    apply(plugin = "com.gradleup.shadow")
 
     // Configure repositories
     repositories {
@@ -54,19 +57,36 @@ java {
     }
 }
 
+dependencies {
+    compileOnly("org.scala-lang:scala3-library_3:3.7.1")
+}
+
 subprojects {
     // Apply necessary plugins
     apply(plugin = "java-library")
+    apply(plugin = "scala")
     apply(plugin = "io.fairyproject")
     apply(plugin = "io.spring.dependency-management")
     apply(plugin = "org.jetbrains.kotlin.jvm")
-    apply(plugin = "com.github.johnrengelman.shadow")
+    apply(plugin = "com.gradleup.shadow")
     apply(plugin = "io.freefair.lombok")
 
     // Configure dependencies
     dependencies {
-        compileOnlyApi("io.fairyproject:bukkit-platform")
+        val depend by if (project.name != "foundation") {
+            configurations.compileOnly
+        } else {
+            configurations.api
+        }
+
         api("io.fairyproject:bukkit-bootstrap")
+        compileOnlyApi("io.fairyproject:bukkit-platform")
+        compileOnly("org.spigotmc:spigot-api:${properties("spigot.version")}-R0.1-SNAPSHOT")
+
+        depend("org.scala-lang:scala3-library_3:3.7.1")
+        depend("org.apache.commons:commons-lang3:3.17.0")
+        depend("com.google.guava:guava:33.4.0-jre")
+
         compileOnlyApi("io.fairyproject:mc-animation")
         compileOnlyApi("io.fairyproject:bukkit-command")
         compileOnlyApi("io.fairyproject:bukkit-gui")
@@ -81,52 +101,119 @@ subprojects {
         compileOnlyApi("io.fairyproject:bukkit-timer")
         compileOnlyApi("io.fairyproject:bukkit-nbt")
         compileOnlyApi("io.fairyproject:mc-tablist")
-        compileOnly("org.spigotmc:spigot-api:${properties("spigot.version")}-R0.1-SNAPSHOT")
-        implementation("org.apache.commons:commons-lang3:3.17.0")
     }
 
     // Configure ShadowJar task
     tasks.withType(ShadowJar::class) {
         dependencies {
             exclude(dependency("com.google.code.gson:.*:.*"))
+
+            // Exclude Kotlin
+            exclude(dependency("org.jetbrains.kotlin:.*:.*"))
+            exclude(dependency("org.jetbrains:annotations:.*"))
+
+            // Exclude SLF4J
+            exclude(dependency("org.slf4j:.*:.*"))
+
+            // Exclude dependencies that would be relocated to io.fairyproject.libs
+            exclude(dependency("net.kyori:.*:.*"))
+            exclude(dependency("com.cryptomorin.xseries:.*:.*"))
+            exclude(dependency("org.yaml:snakeyaml:.*"))
+            exclude(dependency("com.github.retrooper:packetevents:.*"))
+            exclude(dependency("io.github.retrooper:packetevents:.*"))
         }
 
+        // Exclude all io.fairyproject.libs packages since they exist in fairy lib plugin
+        exclude("io/fairyproject/libs/**")
+
         // Relocate fairy to avoid plugin conflict
-        relocate("io.fairyproject.bootstrap", "${properties("package")}.fairy.bootstrap")
+        val libsPackage = "${properties("package")}.libs"
+
         relocate("net.kyori", "io.fairyproject.libs.kyori")
         relocate("com.cryptomorin.xseries", "io.fairyproject.libs.xseries")
         relocate("org.yaml.snakeyaml", "io.fairyproject.libs.snakeyaml")
         relocate("com.google.gson", "io.fairyproject.libs.gson")
         relocate("com.github.retrooper.packetevents", "io.fairyproject.libs.packetevents")
         relocate("io.github.retrooper.packetevents", "io.fairyproject.libs.packetevents")
-        relocate("io.fairyproject.bukkit.menu", "${properties("package")}.fairy.menu")
 
         // Relocate
-        relocate("de.leonhard.storage", "${properties("package")}.libs.simplixstorage")
-        relocate("org.reflections", "${properties("package")}.libs.reflections")
-        relocate("net.wesjd.anvilgui", "${properties("package")}.libs.anvilgui")
+        relocate("scala", "$libsPackage.scala")
+
+        relocate("io.fairyproject.bootstrap", "$libsPackage.io.fairyproject.bootstrap")
+        relocate("io.fairyproject.bukkit.menu", "$libsPackage.io.fairyproject.bukkit.menu")
+
+        relocate("de.leonhard.storage", "$libsPackage.de.leonhard.storage")
+        relocate("net.wesjd.anvilgui", "$libsPackage.net.wesjd.anvilgui")
 
         archiveClassifier.set("plugin")
         mergeServiceFiles()
+
         exclude("META-INF/maven/**")
+        exclude("**/*.tasty")
+
+        duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+    }
+
+    // Configure source sets for Scala/Java joint compilation
+    sourceSets {
+        main {
+            java {
+                setSrcDirs(emptyList<String>())
+            }
+            scala {
+                setSrcDirs(listOf("src/main/java", "src/main/scala"))
+            }
+        }
+    }
+
+    // Configure task dependencies and order
+    tasks.named<JavaCompile>("compileJava") {
+        enabled = false
+    }
+
+    // Configure Scala compilation to output to classes directory
+    tasks.named<ScalaCompile>("compileScala") {
+        // Ensure clean output directory
+        doFirst {
+            destinationDirectory.get().asFile.deleteRecursively()
+            destinationDirectory.get().asFile.mkdirs()
+        }
     }
 
     // Configure sourcesJar task
     tasks.register<Jar>("sourcesJar") {
         exclude("fairy.json")
-        dependsOn(tasks.named("shadowJar"))
-        duplicatesStrategy = DuplicatesStrategy.EXCLUDE
-        from(zipTree(tasks.named<ShadowJar>("shadowJar").get().archiveFile.get().asFile))
+        // Check if shadowJar task exists before depending on it
+        if (tasks.names.contains("shadowJar")) {
+            dependsOn(tasks.named("shadowJar"))
+            from(zipTree(tasks.named<ShadowJar>("shadowJar").get().archiveFile.get().asFile))
+        }
         from(sourceSets.main.get().allSource)
         archiveClassifier.set("sources")
+        duplicatesStrategy = DuplicatesStrategy.EXCLUDE
     }
 
-    // Disable Javadoc warnings
+    // Configure Javadoc for Scala/Java mixed projects
     tasks.withType<Javadoc> {
+        // Ensure compilation is done before javadoc
+        dependsOn(tasks.named("compileScala"))
+
+        // Set source to include Java files from Scala source directories
+        source = fileTree("src/main/java") + fileTree("src/main/scala")
+        include("**/*.java")
+
+        // Use classpath from compileScala to resolve Lombok-generated classes
+        classpath = sourceSets.main.get().compileClasspath + files(sourceSets.main.get().output)
+
         options {
             this as StandardJavadocDocletOptions
             addStringOption("Xdoclint:-missing", "-quiet")
+            addStringOption("Xdoclint:-html", "-quiet")
+            addStringOption("Xdoclint:-reference", "-quiet")
         }
+
+        // Disable failOnError for modules with Lombok
+        isFailOnError = false
     }
 
     // Configure javadocJar task
@@ -139,33 +226,64 @@ subprojects {
     tasks.register("allJar") {
         dependsOn("shadowJar", "sourcesJar", "javadocJar")
     }
+
+    // After project evaluation, configure shadowJar dependencies
+    afterEvaluate {
+        tasks.withType<ShadowJar> {
+            // Find all project dependencies and make shadowJar depend on their shadowJar tasks
+            project.configurations.findByName("compileClasspath")?.allDependencies?.forEach { dep ->
+                if (dep is ProjectDependency) {
+                    val depProject = rootProject.allprojects.find { it.name == dep.name }
+                    if (depProject != null && depProject != project) {
+                        dependsOn(depProject.tasks.named("shadowJar"))
+                    }
+                }
+            }
+        }
+    }
 }
 
 publishing {
     if (isGitHubActions) {
         publications {
             rootProject.subprojects.forEach { subproject ->
-                create<MavenPublication>("shadow-${subproject.name.replaceFirstChar { if (it.isLowerCase()) it.titlecase(Locale.getDefault()) else it.toString() }}") {
+                create<MavenPublication>(
+                    "shadow-${
+                        subproject.name.replaceFirstChar {
+                            if (it.isLowerCase()) it.titlecase(
+                                Locale.getDefault()
+                            ) else it.toString()
+                        }
+                    }"
+                ) {
                     val shadowJarTask = subproject.tasks.named<ShadowJar>("shadowJar")
                     artifact(shadowJarTask.get().archiveFile.get())
 
                     groupId = group.toString()
                     artifactId = subproject.name
-                    version = "${properties("version")}-${LocalDateTime.now().format(DateTimeFormatter.ofPattern("dd-MM-yy-hhmmss"))}"
+                    version = "${properties("version")}-${
+                        LocalDateTime.now().format(DateTimeFormatter.ofPattern("dd-MM-yy-hhmmss"))
+                    }"
                     description = ""
                     pom {
                         description.set("")
                     }
                 }
             }
         }
+
         // GitHub Packages
         repositories {
             maven {
                 url = uri("https://maven.pkg.github.com/LegacyLands/legacy-lands-library/")
                 credentials {
-                    username = project.findProperty("githubUsername")?.toString() ?: System.getenv("GITHUB_USERNAME")?.toString() ?: error("GitHub username is missing")
-                    password = project.findProperty("githubToken")?.toString() ?: System.getenv("GITHUB_TOKEN")?.toString() ?: error("GitHub token is missing")
+                    username =
+                        project.findProperty("githubUsername")?.toString() ?: System.getenv("GITHUB_USERNAME") ?: error(
+                            "GitHub username is missing"
+                        )
+                    password =
+                        project.findProperty("githubToken")?.toString() ?: System.getenv("GITHUB_TOKEN")
+                                ?: error("GitHub token is missing")
                 }
             }
         }