papermc-skill 1.0.0 → 1.1.0

package/templates/paper-modern-template/build.gradle.kts

@@ -1,15 +1,15 @@
 plugins {
     `java-library`
-    // Plugin run-paper untuk menjalankan test server Paper/Folia instan
-    id("xyz.jpenilla.run-paper") version "3.0.2"
+    // The run-paper plugin for instant Paper/Folia local test server execution
+    id("xyz.jpenilla.run-paper") version "3.1.0"
     
-    // Aktifkan paperweight.userdev jika butuh Mojang NMS internals
+    // Enable paperweight.userdev if direct Mojang NMS internals access is needed
     // id("io.papermc.paperweight.userdev") version "2.0.0-beta.21"
 }
 
 group = "com.example"
 version = "1.0.0-SNAPSHOT"
-description = "Template Plugin Paper Minecraft Modern"
+description = "Modern Paper & Folia Minecraft Plugin Starter Template"
 
 repositories {
     mavenCentral()
@@ -24,14 +24,14 @@ java {
 }
 
 dependencies {
-    // Standar Utama: Paper API (Kyori Adventure, Folia Schedulers, Brigadier, PDC)
-    compileOnly("io.papermc.paper:paper-api:1.21.4-R0.1-SNAPSHOT")
+    // Primary Standard: Paper API (Kyori Adventure, Folia Schedulers, Brigadier, PDC)
+    compileOnly("io.papermc.paper:paper-api:1.21.11-R0.1-SNAPSHOT")
 
-    // Opsional: Untuk NMS / Mojang mappings internal (aktifkan plugin paperweight di atas jika memakai ini):
+    // Optional: For NMS / internal Mojang mappings (enable paperweight plugin above if using this):
     // paperweight.paperDevBundle("1.21.4.build.+")
 
-    // Anotasi nullability
-    compileOnly("org.jspecify:jspecify:1.0.0")
+    // Modern Nullability Annotations
+    compileOnly("org.jspecify:jspecify:1.0.1")
 }
 
 tasks {
@@ -50,5 +50,5 @@ tasks {
     }
 }
 
-// Menambahkan task './gradlew runFoliaServer' untuk pengujian multi-threaded Folia
+// Registers the './gradlew runFoliaServer' task for multi-threaded Folia local testing
 runPaper.folia.registerTask()

package/templates/paper-modern-template/gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.4.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.7.1-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

package/templates/paper-modern-template/gradlew

@@ -20,7 +20,7 @@
 
 ##############################################################################
 #
-#   Gradle start up script for POSIX generated by Gradle.
+#   gradlew start up script for POSIX generated by Gradle.
 #
 #   Important for running:
 #
@@ -29,7 +29,7 @@
 #       bash, then to run this script, type that shell name before the whole
 #       command line, like:
 #
-#           ksh Gradle
+#           ksh gradlew
 #
 #       Busybox and similar reduced shells will NOT work, because this script
 #       requires all of these POSIX shell features:
@@ -57,7 +57,7 @@
 #       Darwin, MinGW, and NonStop.
 #
 #   (3) This script is generated from the Groovy template
-#       https://github.com/gradle/gradle/blob/2d6327017519d23b96af35865dc997fcb544fb40/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       https://github.com/gradle/gradle/blob/3d91ce3b8caaf77ad09f381f43615b715b53f72c/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
 #       within the Gradle project.
 #
 #       You can find Gradle at https://github.com/gradle/gradle/.

package/templates/paper-modern-template/gradlew.bat

@@ -19,12 +19,12 @@
 @if "%DEBUG%"=="" @echo off
 @rem ##########################################################################
 @rem
-@rem  Gradle startup script for Windows
+@rem  gradlew startup script for Windows
 @rem
 @rem ##########################################################################
 
-@rem Set local scope for the variables with windows NT shell
-if "%OS%"=="Windows_NT" setlocal
+@rem Set local scope for the variables, and ensure extensions are enabled
+setlocal EnableExtensions
 
 set DIRNAME=%~dp0
 if "%DIRNAME%"=="" set DIRNAME=.
@@ -51,7 +51,7 @@ echo. 1>&2
 echo Please set the JAVA_HOME variable in your environment to match the 1>&2
 echo location of your Java installation. 1>&2
 
-goto fail
+"%COMSPEC%" /c exit 1
 
 :findJavaFromJavaHome
 set JAVA_HOME=%JAVA_HOME:"=%
@@ -65,29 +65,18 @@ echo. 1>&2
 echo Please set the JAVA_HOME variable in your environment to match the 1>&2
 echo location of your Java installation. 1>&2
 
-goto fail
+"%COMSPEC%" /c exit 1
 
 :execute
 @rem Setup the command line
 
 
 
-@rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+@rem Execute gradlew
+@rem endlocal doesn't take effect until after the line is parsed and variables are expanded
+@rem which allows us to clear the local environment before executing the java command
+endlocal & "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %* & call :exitWithErrorLevel
 
-:end
-@rem End local scope for the variables with windows NT shell
-if %ERRORLEVEL% equ 0 goto mainEnd
-
-:fail
-rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
-rem the _cmd.exe /c_ return code!
-set EXIT_CODE=%ERRORLEVEL%
-if %EXIT_CODE% equ 0 set EXIT_CODE=1
-if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
-exit /b %EXIT_CODE%
-
-:mainEnd
-if "%OS%"=="Windows_NT" endlocal
-
-:omega
+:exitWithErrorLevel
+@rem Use "%COMSPEC%" /c exit to allow operators to work properly in scripts
+"%COMSPEC%" /c exit %ERRORLEVEL%

package/templates/paper-modern-template/settings.gradle.kts

@@ -1,3 +1,10 @@
+pluginManagement {
+    repositories {
+        gradlePluginPortal()
+        mavenCentral()
+    }
+}
+
 plugins {
     id("org.gradle.toolchains.foojay-resolver-convention") version "1.0.0"
 }

package/templates/paper-modern-template/src/main/java/com/example/paperplugin/ExamplePaperPlugin.java

@@ -11,25 +11,25 @@ public final class ExamplePaperPlugin extends JavaPlugin {
 
     @Override
     public void onEnable() {
-        // Simpan default configuration jika belum ada
+        // Save default configuration if missing
         saveDefaultConfig();
 
-        // Inisialisasi kunci PersistentDataContainer
+        // Initialize PersistentDataContainer keys
         PluginDataKeys.init(this);
 
-        // Registrasi Event Listener
+        // Register Event Listeners
         getServer().getPluginManager().registerEvents(new PlayerEventListener(this), this);
 
-        // Logging dengan ComponentLogger bawaan Paper
+        // Log startup using Paper's native ComponentLogger
         getComponentLogger().info(
-            Component.text("ExamplePaperPlugin aktif! Running on Folia: " + SchedulerAdapter.isFolia(), NamedTextColor.GREEN)
+            Component.text("ExamplePaperPlugin enabled! Running on Folia: " + SchedulerAdapter.isFolia(), NamedTextColor.GREEN)
         );
     }
 
     @Override
     public void onDisable() {
         getComponentLogger().info(
-            Component.text("ExamplePaperPlugin dinonaktifkan.", NamedTextColor.YELLOW)
+            Component.text("ExamplePaperPlugin disabled.", NamedTextColor.YELLOW)
         );
     }
 }

package/templates/paper-modern-template/src/main/java/com/example/paperplugin/PaperPluginBootstrap.java

@@ -14,14 +14,14 @@ public final class PaperPluginBootstrap implements PluginBootstrap {
 
     @Override
     public void bootstrap(final BootstrapContext context) {
-        // Registrasi Paper Brigadier Commands via LifecycleEvents
+        // Register Paper Brigadier Commands via LifecycleEvents
         context.getLifecycleManager().registerEventHandler(
             LifecycleEvents.COMMANDS,
             event -> {
                 final var registrar = event.registrar();
                 registrar.register(
                     HelloCommand.create(),
-                    "Contoh perintah Paper modern berbasis Brigadier",
+                    "Example modern Paper command powered by Mojang Brigadier",
                     List.of("phello")
                 );
             }

package/templates/paper-modern-template/src/main/java/com/example/paperplugin/command/HelloCommand.java

@@ -11,8 +11,6 @@ import org.bukkit.Bukkit;
 import org.bukkit.command.CommandSender;
 import org.bukkit.entity.Player;
 
-import java.util.List;
-
 public final class HelloCommand {
 
     private HelloCommand() {
@@ -24,7 +22,7 @@ public final class HelloCommand {
             .executes(context -> {
                 final CommandSender sender = context.getSource().getSender();
                 sender.sendMessage(
-                    MiniMessage.miniMessage().deserialize("<green>Halo, <yellow><name></yellow>! Selamat menggunakan Paper Brigadier.</green>",
+                    MiniMessage.miniMessage().deserialize("<green>Hello, <yellow><name></yellow>! Welcome to modern Paper Brigadier.</green>",
                         Placeholder.unparsed("name", sender.getName())
                     )
                 );
@@ -42,7 +40,7 @@ public final class HelloCommand {
                     final String target = StringArgumentType.getString(context, "target");
 
                     sender.sendMessage(
-                        MiniMessage.miniMessage().deserialize("<green>Menyapa <gold><target></gold> atas nama <yellow><sender></yellow>!</green>",
+                        MiniMessage.miniMessage().deserialize("<green>Greetings sent to <gold><target></gold> on behalf of <yellow><sender></yellow>!</green>",
                             Placeholder.unparsed("target", target),
                             Placeholder.unparsed("sender", sender.getName())
                         )

package/templates/paper-modern-template/src/main/java/com/example/paperplugin/data/PluginDataKeys.java

@@ -4,8 +4,8 @@ import org.bukkit.NamespacedKey;
 import org.bukkit.plugin.Plugin;
 
 /**
- * Menyimpan konstanta NamespacedKey untuk PersistentDataContainer (PDC).
- * Selalu inisialisasi satu kali untuk menghindari alokasi objek berulang.
+ * Stores static NamespacedKey identifiers for PersistentDataContainer (PDC).
+ * Always initialized once on plugin startup to eliminate repeated heap allocations.
  */
 public final class PluginDataKeys {
 

package/templates/paper-modern-template/src/main/java/com/example/paperplugin/listener/PlayerEventListener.java

@@ -2,7 +2,6 @@ package com.example.paperplugin.listener;
 
 import com.example.paperplugin.ExamplePaperPlugin;
 import com.example.paperplugin.data.PluginDataKeys;
-import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.minimessage.MiniMessage;
 import net.kyori.adventure.text.minimessage.tag.resolver.Placeholder;
 import org.bukkit.entity.Player;
@@ -32,28 +31,28 @@ public final class PlayerEventListener implements Listener {
         pdc.set(PluginDataKeys.LAST_LOGIN_TIMESTAMP, PersistentDataType.LONG, System.currentTimeMillis());
 
         if (currentJoins == 1) {
-            // Pertama kali bergabung
+            // First time player join
             final String firstJoinFormat = plugin.getConfig().getString(
                 "messages.first_join",
-                "<rainbow>MEMBER BARU!</rainbow> Sambut <yellow><player></yellow>!"
+                "<rainbow>NEW MEMBER!</rainbow> Give a warm welcome to <yellow><player></yellow>!"
             );
             event.joinMessage(
                 MiniMessage.miniMessage().deserialize(firstJoinFormat, Placeholder.unparsed("player", player.getName()))
             );
         } else {
-            // Pemain kembali bergabung
+            // Returning player join
             final String welcomeFormat = plugin.getConfig().getString(
                 "messages.welcome",
-                "<green>Selamat datang kembali, <yellow><player></yellow>!</green>"
+                "<green>Welcome back, <yellow><player></yellow>!</green>"
             );
             event.joinMessage(
                 MiniMessage.miniMessage().deserialize(welcomeFormat, Placeholder.unparsed("player", player.getName()))
             );
         }
 
-        // Kirim action bar personal
+        // Send personalized action bar
         player.sendActionBar(
-            MiniMessage.miniMessage().deserialize("<gray>Kunjungan ke-<gold><count></gold></gray>",
+            MiniMessage.miniMessage().deserialize("<gray>Visit #<gold><count></gold></gray>",
                 Placeholder.unparsed("count", String.valueOf(currentJoins))
             )
         );

package/templates/paper-modern-template/src/main/java/com/example/paperplugin/util/SchedulerAdapter.java

@@ -8,7 +8,7 @@ import org.bukkit.plugin.Plugin;
 import java.util.concurrent.TimeUnit;
 
 /**
- * Adapter Scheduler yang secara transparan mendukung arsitektur Paper standar dan Folia (Regionized Threading).
+ * Universal Scheduler Adapter providing transparent concurrency across standard Paper and Folia (Threaded Regions).
  */
 public final class SchedulerAdapter {
 
@@ -31,7 +31,7 @@ public final class SchedulerAdapter {
     }
 
     /**
-     * Menjalankan runnable pada thread region lokasi tertentu.
+     * Executes a runnable on the region thread owning the specified location.
      */
     public static void runAtLocation(final Plugin plugin, final Location location, final Runnable runnable) {
         if (IS_FOLIA) {
@@ -42,7 +42,7 @@ public final class SchedulerAdapter {
     }
 
     /**
-     * Menjalankan runnable pada thread yang memiliki entity tertentu.
+     * Executes a runnable on the region thread currently owning the specified entity.
      */
     public static void runAtEntity(final Plugin plugin, final Entity entity, final Runnable runnable) {
         if (IS_FOLIA) {
@@ -53,7 +53,7 @@ public final class SchedulerAdapter {
     }
 
     /**
-     * Menjalankan runnable secara asynchronous (off-main-thread).
+     * Executes a runnable asynchronously (off-main-thread).
      */
     public static void runAsync(final Plugin plugin, final Runnable runnable) {
         if (IS_FOLIA) {
@@ -64,13 +64,13 @@ public final class SchedulerAdapter {
     }
 
     /**
-     * Menjalankan task delayed secara asynchronous.
+     * Executes a delayed task asynchronously.
      */
     public static void runAsyncDelayed(final Plugin plugin, final Runnable runnable, final long delay, final TimeUnit timeUnit) {
         if (IS_FOLIA) {
             Bukkit.getAsyncScheduler().runDelayed(plugin, task -> runnable.run(), delay, timeUnit);
         } else {
-            final long ticks = delay * 20; // Aproksimasi detik ke tick jika detik
+            final long ticks = Math.max(1L, timeUnit.toMillis(delay) / 50L);
             Bukkit.getScheduler().runTaskLaterAsynchronously(plugin, runnable, ticks);
         }
     }

package/templates/paper-modern-template/src/main/resources/config.yml

@@ -1,10 +1,10 @@
-# Konfigurasi Modern Paper Template Plugin
-# Format teks menggunakan format Kyori MiniMessage
+# Modern Paper Plugin Template Configuration
+# Formatted using Kyori MiniMessage syntax
 
 messages:
-  welcome: "<gradient:#00c6ff:#0072ff><bold>Selamat datang di server!</bold></gradient> Senang melihatmu bergabung, <yellow><player></yellow>."
-  first_join: "<rainbow><bold>MEMBER BARU!</bold></rainbow> Mari sambut <yellow><player></yellow> yang baru pertama kali bergabung!"
-  command_hello: "<green>Halo, <aqua><target></aqua>! Salam dari server Paper modern.</green>"
+  welcome: "<gradient:#00c6ff:#0072ff><bold>Welcome back to the server!</bold></gradient> Great to see you again, <yellow><player></yellow>."
+  first_join: "<rainbow><bold>NEW MEMBER!</bold></rainbow> Give a warm welcome to <yellow><player></yellow> for joining the server!"
+  command_hello: "<green>Hello, <aqua><target></aqua>! Greetings from modern PaperMC.</green>"
 
 settings:
   track_join_count: true