papermc-skill 1.0.1 → 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
+    // 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,13 +24,13 @@ java {
 }
 
 dependencies {
-    // Standar Utama: Paper API (Kyori Adventure, Folia Schedulers, Brigadier, PDC)
+    // 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
+    // Modern Nullability Annotations
     compileOnly("org.jspecify:jspecify:1.0.1")
 }
 
@@ -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/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