papermc-skill 1.0.1 → 1.2.0

package/docs/07-best-practices-and-perf.md

@@ -1,60 +1,59 @@
-# Best Practices & Optimasi Performa Plugin Paper
+# Best Practices & Performance Optimization for Paper Plugins
 
-Pengembangan plugin Minecraft di server berkapasitas besar menuntut efisiensi tinggi, bebas memory leak, dan tidak memblokir tick game. Dokumen ini merangkum aturan emas dan anti-pattern yang sering terjadi.
+Building Minecraft server plugins for large communities requires high efficiency, zero memory leaks, and non-blocking game tick loops. This guide summarizes essential rules, performance optimizations, and anti-patterns.
 
 ---
 
-## 1. Mencegah Memory Leak (Kebocoran Memori)
+## 1. Preventing Memory Leaks
 
-Minecraft memiliki arsitektur objek yang saling terhubung erat. Menyimpan referensi objek Bukkit di memori Java lebih lama dari masa hidupnya dapat mencegah Garbage Collector (GC) membersihkan ratusan megabyte data.
+Minecraft exhibits a tightly coupled object graph. Holding Bukkit object references in memory beyond their intended lifecycle prevents the JVM Garbage Collector (GC) from clearing hundreds of megabytes of world and connection data.
 
-### 🔴 Anti-Pattern: Menyimpan Objek Bukkit di Collection Statis
+### 🔴 Anti-Pattern: Holding Bukkit Objects in Static Collections
 ```java
-// SANGAT BERBAHAYA: Player objek menahan referensi ke World, Chunk, Connection, dll.
+// CRITICAL HAZARD: Player objects hold references to World, Chunks, and Network Connections
 public static final Set<Player> activePlayers = new HashSet<>();
 public static final Map<Player, PlayerData> dataMap = new HashMap<>();
 ```
-Jika pemain disconnect, objek `Player` tidak akan bisa di-garbage collect!
+When a player disconnects, the `Player` instance cannot be garbage-collected, creating a massive memory leak!
 
-### 🟢 Solusi: Simpan `UUID`
+### 🟢 Solution: Store `UUID` Primitives
 ```java
-// AMAN: UUID hanya 16-byte identifier yang tidak menahan referensi dunia/koneksi
+// SAFE: UUID is a lightweight 16-byte identifier with zero lingering references
 public static final Set<UUID> activePlayerUuids = new HashSet<>();
 public static final Map<UUID, PlayerData> dataMap = new ConcurrentHashMap<>();
 
-// Ambil instance player hanya saat dibutuhkan:
+// Retrieve player instance only when needed:
 Player player = Bukkit.getPlayer(uuid);
 if (player != null) {
-    // Gunakan
+    // Process player
 }
 ```
 
-> **Aturan Umum**: Jangan pernah menyimpan `Player`, `Entity`, `World`, `Chunk`, atau `Block` di dalam field permanen/statis. Gunakan `UUID`, `NamespacedKey`, atau koordinat primitif (`worldName`, `x`, `y`, `z`).
+> **Golden Rule**: Never retain long-lived references to `Player`, `Entity`, `World`, `Chunk`, or `Block` instances in static fields. Use `UUID`, `NamespacedKey`, or primitive coordinates (`worldName`, `x`, `y`, `z`).
 
 ---
 
-## 2. Operasi I/O & Database Selalu Asinkron
+## 2. Asynchronous I/O & Database Operations
 
-Setiap tick server berjalan dalam ~50 milidetik (20 TPS). Operasi disk I/O, pembacaan file besar, koneksi web/HTTP, atau query database yang membutuhkan waktu 100ms akan langsung menyebabkan server lag/freeze (tps drop).
+Server game ticks run in ~50 milliseconds (20 TPS). File I/O, heavy disk reads, HTTP web requests, or database queries taking even 100ms will immediately cause TPS drops and server lag spikes.
 
-### 🟢 Solusi: Gunakan Async Threads & CompletableFuture
+### 🟢 Solution: Async Threads & CompletableFuture
 ```java
 import java.util.concurrent.CompletableFuture;
 import org.bukkit.Bukkit;
 
 public CompletableFuture<PlayerData> loadDataAsync(UUID uuid) {
     return CompletableFuture.supplyAsync(() -> {
-        // Berjalan di luar thread game (off-main-thread)
+        // Runs off the main game thread
         return database.fetchUser(uuid);
     }, myPluginThreadPool).thenApply(data -> {
         return data != null ? data : new PlayerData(uuid);
     });
 }
 
-// Menggunakan hasilnya:
+// Consuming the result safely:
 loadDataAsync(player.getUniqueId()).thenAccept(data -> {
-    // Jika perlu memodifikasi state game Bukkit (seperti memberi item),
-    // jadwalkan kembali ke scheduler region pemain:
+    // Schedule back to the player's entity scheduler when mutating game state:
     player.getScheduler().run(plugin, task -> {
         player.giveExp(data.getPendingExp());
     }, null);
@@ -63,56 +62,56 @@ loadDataAsync(player.getUniqueId()).thenAccept(data -> {
 
 ---
 
-## 3. Menghindari Synchronous Chunk Loading
+## 3. Eliminating Synchronous Chunk Loading
 
-Memanggil `world.getChunkAt(x, z)` atau `location.getBlock()` pada chunk yang belum di-load akan memaksa server memuat chunk tersebut dari disk secara synchronous (membekukan tick thread hingga chunk selesai dibaca).
+Invoking `world.getChunkAt(x, z)` or `location.getBlock()` on an unloaded chunk forces the server to read chunk data synchronously from disk, freezing the main tick thread.
 
 ### 🔴 Anti-Pattern
 ```java
-Chunk chunk = world.getChunkAt(x, z); // Membekukan server jika chunk belum di-load!
+Chunk chunk = world.getChunkAt(x, z); // Freezes the server if the chunk is not yet loaded!
 ```
 
-### 🟢 Solusi Paper: Asynchronous Chunk Loading
-Gunakan API Paper `getChunkAtAsync`:
+### 🟢 Paper Solution: Asynchronous Chunk Loading
+Use Paper's native `getChunkAtAsync`:
 
 ```java
 world.getChunkAtAsync(x, z, true).thenAccept(chunk -> {
-    // Chunk berhasil dimuat tanpa lag spike pada TPS
+    // Chunk loaded asynchronously without TPS drops
     processChunkBlocks(chunk);
 });
 ```
 
 ---
 
-## 4. Konfigurasi (`config.yml`) yang Tangguh
+## 4. Robust Configuration (`config.yml`) Handling
 
-Di Paper, file YAML secara default menggunakan encoding UTF-8. Pastikan membaca dan menyimpan file konfigurasi dengan aman:
+In Paper, YAML files default to UTF-8 encoding. Read and reload configuration files cleanly:
 
 ```java
-// Menyimpan default config dari jar jika belum ada
+// Save embedded default config from jar if missing
 saveDefaultConfig();
 
-// Reload config
+// Reload configuration
 reloadConfig();
 FileConfiguration config = getConfig();
 
-// Mengambil pesan dengan fallback default
-String rawMessage = config.getString("messages.welcome", "<green>Selamat datang!</green>");
+// Read messages with fallback defaults
+String rawMessage = config.getString("messages.welcome", "<green>Welcome to the server!</green>");
 Component message = MiniMessage.miniMessage().deserialize(rawMessage);
 ```
 
-Untuk struktur config yang sangat kompleks, pertimbangkan menggunakan library **Configurate** (`org.spongepowered:configurate-yaml`) yang mendukung pemeliharaan komentar file YAML, schema validation, dan serialisasi otomatis ke record Java.
+For large configuration trees, consider using **Configurate** (`org.spongepowered:configurate-yaml`) which preserves file comments, validates schemas, and maps automatically to Java records.
 
 ---
 
-## 5. Ringkasan Checklist Anti-Pattern
+## 5. Anti-Pattern Summary Checklist
 
-| Jangan Lakukan ❌ | Lakukan Ini ✔️ |
+| Never Do This ❌ | Recommended Modern Pattern ✔️ |
 | :--- | :--- |
-| `ChatColor.RED + "Teks"` | `MiniMessage.miniMessage().deserialize("<red>Teks</red>")` |
+| `ChatColor.RED + "Text"` | `MiniMessage.miniMessage().deserialize("<red>Text</red>")` |
 | `player.sendMessage("§a...")` | `player.sendMessage(Component)` |
-| `new NamespacedKey(...)` di per-event loop | Simpan instance `NamespacedKey` sebagai `static final` |
-| `world.getBlockAt(x, y, z)` acak di async thread | Akses block hanya di thread region yang bersangkutan |
-| Mengabaikan `paper-plugin.yml` untuk plugin baru | Manfaatkan `paper-plugin.yml` dan `PluginBootstrap` |
-| Menahan koneksi database terbuka di main thread | Gunakan connection pool (seperti HikariCP) & query async |
-| Mengabaikan `folia-supported` | Rancang scheduler menggunakan abstraksi region / universal |
+| `new NamespacedKey(...)` in event loops | Define `NamespacedKey` instances as `static final` |
+| Random `world.getBlockAt(x, y, z)` in async threads | Access blocks exclusively on the owning region thread |
+| Ignoring `paper-plugin.yml` in new projects | Adopt `paper-plugin.yml` and `PluginBootstrap` |
+| Blocking the tick thread with database queries | Use connection pools (HikariCP) & async futures |
+| Omitting `folia-supported` declarations | Architect schedulers using region/universal abstractions |

package/docs/08-gui-and-menus.md

@@ -1,25 +1,25 @@
-# Pembuatan GUI / Menu Inventory Modern di Paper
+# Modern GUI & Inventory Menus in Paper
 
-Membuat antarmuka interaktif (GUI Menu) menggunakan inventaris chest adalah salah satu fitur paling sering dibuat di plugin Minecraft. Pendekatan lama yang memeriksa judul GUI dengan string berwarna (`ChatColor.stripColor`) atau mencocokkan nomor slot sangat rapuh dan rawan bug duplikasi item.
+Creating interactive inventory interfaces (GUI Menus) using chest containers is one of the most widely implemented features in Minecraft plugins. Legacy approaches inspecting menu titles with color strings (`ChatColor.stripColor`) or hardcoding slot numbers (`event.getSlot() == 13`) are brittle and notorious for causing item duplication exploits.
 
-Paper modern menawarkan cara yang jauh lebih aman, bersih, dan type-safe menggunakan **Kyori Adventure** dan **PersistentDataContainer (PDC)**.
+Modern Paper offers a clean, type-safe, and exploit-proof pattern utilizing **Kyori Adventure** and **PersistentDataContainer (PDC)**.
 
 ---
 
-## 1. Masalah pada Pendekatan Lama vs Solusi Modern
+## 1. Legacy Anti-Patterns vs Modern Paper Solutions
 
-| Masalah Legacy (Lama) | Solusi Modern Paper |
+| Legacy Spigot Anti-Pattern | Modern Paper Architecture |
 | :--- | :--- |
-| Memeriksa judul menu dengan `event.getView().getTitle().equals("§8Menu")` | Memeriksa `InventoryHolder` kustom atau PDC metadata pada item. |
-| Mencocokkan fungsi tombol berdasarkan `event.getSlot() == 13` | Menandai tombol dengan `PDC` (`NamespacedKey: "gui_action" -> "buy_item"`). |
-| Merusak format warna teks jika ada reload atau translate | Menggunakan Adventure `Component` untuk title inventaris. |
-| Rawan bug eksploitasi duplikasi jika `event.setCancelled(true)` luput | Selalu batalkan event jika holder terverifikasi sebagai custom GUI. |
+| Matching title strings: `view.getTitle().equals("§8Menu")` | Verifying custom `InventoryHolder` or PDC item signatures. |
+| Hardcoding actions: `if (event.getSlot() == 13)` | Tagging button items with PDC actions (`gui_action -> buy_item`). |
+| Corrupting color formatting across reloads | Using Adventure `Component` titles natively. |
+| Item duplication exploits when cancel fails | Enforcing immediate cancellation on verified custom holders. |
 
 ---
 
-## 2. Pola Custom `InventoryHolder`
+## 2. The Custom `InventoryHolder` Pattern
 
-Cara paling handal dan standar industri untuk mengenali GUI buatan plugin Anda adalah membuat kelas yang mengimplementasikan `InventoryHolder`:
+The industry standard for identifying plugin-owned GUIs is implementing a custom `InventoryHolder`:
 
 ```java
 package com.example.plugin.gui;
@@ -37,7 +37,7 @@ public class CustomMenuHolder implements InventoryHolder {
 
     public CustomMenuHolder(Component title, int rows, String menuId) {
         this.menuId = menuId;
-        // Bukkit.createInventory mendukung Adventure Component secara native di Paper
+        // Bukkit.createInventory natively accepts Adventure Components in Paper
         this.inventory = Bukkit.createInventory(this, rows * 9, title);
     }
 
@@ -54,9 +54,9 @@ public class CustomMenuHolder implements InventoryHolder {
 
 ---
 
-## 3. Membuat Tombol dengan Penanda PDC
+## 3. Creating Interactive Buttons with PDC Tags
 
-Daripada mengingat nomor slot, tandai setiap item tombol dengan aksi spesifik di `PersistentDataContainer`:
+Rather than remembering slot indices, tag each button item with an action identifier inside `PersistentDataContainer`:
 
 ```java
 package com.example.plugin.gui;
@@ -67,7 +67,6 @@ import org.bukkit.NamespacedKey;
 import org.bukkit.inventory.ItemStack;
 import org.bukkit.inventory.meta.ItemMeta;
 import org.bukkit.persistence.PersistentDataType;
-import org.bukkit.plugin.Plugin;
 
 import java.util.List;
 
@@ -77,8 +76,7 @@ public final class GuiItemBuilder {
 
     public static ItemStack createButton(Material material, String nameMiniMessage, List<String> loreMiniMessage, String actionId) {
         ItemStack item = new ItemStack(material);
-        ItemMeta meta = item.getItemMeta();
-        if (meta != null) {
+        item.editMeta(meta -> {
             meta.displayName(MiniMessage.miniMessage().deserialize(nameMiniMessage));
             
             meta.lore(loreMiniMessage.stream()
@@ -86,10 +84,9 @@ public final class GuiItemBuilder {
                 .toList()
             );
 
-            // Tandai tombol dengan ID aksi unik
+            // Tag button with unique action identifier
             meta.getPersistentDataContainer().set(ACTION_KEY, PersistentDataType.STRING, actionId);
-            item.setItemMeta(meta);
-        }
+        });
         return item;
     }
 }
@@ -97,18 +94,18 @@ public final class GuiItemBuilder {
 
 ---
 
-## 4. Merakit Menu
+## 4. Assembling the Menu
 
 ```java
 public void openShopMenu(Player player) {
     CustomMenuHolder holder = new CustomMenuHolder(
-        MiniMessage.miniMessage().deserialize("<gradient:#f12711:#f5af19><bold>Toko Server</bold></gradient>"),
-        3, // 3 baris = 27 slot
+        MiniMessage.miniMessage().deserialize("<gradient:#f12711:#f5af19><bold>Server Market</bold></gradient>"),
+        3, // 3 rows = 27 slots
         "server_shop"
     );
     Inventory inv = holder.getInventory();
 
-    // Border pengisi (filler)
+    // Background glass filler
     ItemStack filler = GuiItemBuilder.createButton(
         Material.GRAY_STAINED_GLASS_PANE,
         "<gray> </gray>",
@@ -119,18 +116,18 @@ public void openShopMenu(Player player) {
         inv.setItem(i, filler);
     }
 
-    // Tombol aksi
+    // Action button
     inv.setItem(11, GuiItemBuilder.createButton(
         Material.DIAMOND_SWORD,
-        "<aqua><bold>Beli Senjata Legendaris</bold></aqua>",
-        List.of("<gray>Harga: <gold>500 Koin</gold></gray>", "<yellow>Klik untuk membeli!</yellow>"),
+        "<aqua><bold>Purchase Legendary Blade</bold></aqua>",
+        List.of("<gray>Price: <gold>500 Coins</gold></gray>", "<yellow>Click to purchase!</yellow>"),
         "buy_sword"
     ));
 
     inv.setItem(15, GuiItemBuilder.createButton(
         Material.BARRIER,
-        "<red><bold>Tutup Menu</bold></red>",
-        List.of("<gray>Klik untuk keluar</gray>"),
+        "<red><bold>Close Menu</bold></red>",
+        List.of("<gray>Click to exit</gray>"),
         "close_menu"
     ));
 
@@ -140,7 +137,7 @@ public void openShopMenu(Player player) {
 
 ---
 
-## 5. Event Listener Menu yang Aman dari Eksploitasi
+## 5. Exploit-Proof Menu Event Listener
 
 ```java
 package com.example.plugin.gui;
@@ -158,15 +155,15 @@ public final class MenuClickListener implements Listener {
 
     @EventHandler(priority = EventPriority.HIGHEST)
     public void onInventoryClick(InventoryClickEvent event) {
-        // 1. Verifikasi apakah inventory yang diklik adalah custom holder kita
+        // 1. Verify holder instance
         if (!(event.getInventory().getHolder() instanceof CustomMenuHolder holder)) {
             return;
         }
 
-        // 2. SELALU batalkan klik untuk mencegah pemain mengambil/memindahkan item GUI!
+        // 2. ALWAYS cancel to prevent players from moving GUI items!
         event.setCancelled(true);
 
-        // 3. Abaikan jika klik di luar jendela atau slot kosong
+        // 3. Ignore empty slots or clicks outside the window
         ItemStack clickedItem = event.getCurrentItem();
         if (clickedItem == null || !clickedItem.hasItemMeta()) {
             return;
@@ -176,7 +173,7 @@ public final class MenuClickListener implements Listener {
             return;
         }
 
-        // 4. Baca aksi dari PDC item
+        // 4. Read action from item PDC
         String action = clickedItem.getItemMeta().getPersistentDataContainer()
             .get(GuiItemBuilder.ACTION_KEY, PersistentDataType.STRING);
 
@@ -184,14 +181,14 @@ public final class MenuClickListener implements Listener {
             return;
         }
 
-        // 5. Eksekusi aksi berdasarkan action ID
+        // 5. Execute action routing
         switch (action) {
             case "buy_sword" -> {
-                player.sendMessage(MiniMessage.miniMessage().deserialize("<green>Sukses membeli senjata!</green>"));
+                player.sendMessage(MiniMessage.miniMessage().deserialize("<green>Successfully purchased weapon!</green>"));
                 player.closeInventory();
             }
             case "close_menu" -> player.closeInventory();
-            default -> player.sendMessage(MiniMessage.miniMessage().deserialize("<red>Aksi tidak dikenal.</red>"));
+            default -> player.sendMessage(MiniMessage.miniMessage().deserialize("<red>Unknown menu action.</red>"));
         }
     }
 }

package/docs/09-custom-items-and-combat.md

@@ -1,14 +1,14 @@
-# Custom Items, Ability & Combat di Paper
+# Custom Items, Abilities & Combat in Paper
 
-Membuat item kustom dengan kemampuan sihir atau skill khusus (seperti tongkat sihir petir, pedang lifesteal, atau bow peledak) adalah fitur paling favorit di server RPG dan Mini-games.
+Crafting custom items with magical abilities and combat mechanics (such as lightning wands, lifesteal swords, or explosive bows) is a hallmark of modern RPG and minigame servers.
 
-Paper menyediakan API native untuk raycasting, particle, cooldown visual vanilla, dan Adventure sound effects tanpa perlu library eksternal.
+Paper provides native APIs for entity raycasting, particle trails, vanilla visual cooldown animations, and Adventure sound effects without external library dependencies.
 
 ---
 
-## 1. Anatomi Custom Item dengan PDC
+## 1. Anatomy of a Custom Item with PDC
 
-Selalu identifikasi item kustom menggunakan `PersistentDataContainer` (PDC), bukan nama atau lore yang bisa dipalsukan pemain via Anvil:
+Always identify custom items using `PersistentDataContainer` (PDC) rather than displayName or lore strings which players can forge via an Anvil:
 
 ```java
 package com.example.plugin.item;
@@ -17,7 +17,6 @@ import net.kyori.adventure.text.minimessage.MiniMessage;
 import org.bukkit.Material;
 import org.bukkit.NamespacedKey;
 import org.bukkit.inventory.ItemStack;
-import org.bukkit.inventory.meta.ItemMeta;
 import org.bukkit.persistence.PersistentDataType;
 
 import java.util.List;
@@ -29,18 +28,15 @@ public final class CustomItemFactory {
 
     public static ItemStack createLightningWand() {
         ItemStack item = new ItemStack(Material.BLAZE_ROD);
-        ItemMeta meta = item.getItemMeta();
-        if (meta != null) {
-            meta.displayName(MiniMessage.miniMessage().deserialize("<gradient:#ffe259:#ffa751><bold>Tongkat Petir Kuno</bold></gradient>"));
+        item.editMeta(meta -> {
+            meta.displayName(MiniMessage.miniMessage().deserialize("<gradient:#ffe259:#ffa751><bold>Ancient Lightning Wand</bold></gradient>"));
             meta.lore(List.of(
-                MiniMessage.miniMessage().deserialize("<gray>Klik kanan untuk menembakkan <yellow>Petir Murni</yellow>.</gray>"),
-                MiniMessage.miniMessage().deserialize("<dark_gray>Cooldown: <gold>3 Detik</gold></dark_gray>")
+                MiniMessage.miniMessage().deserialize("<gray>Right-click to discharge <yellow>Pure Lightning</yellow>.</gray>"),
+                MiniMessage.miniMessage().deserialize("<dark_gray>Cooldown: <gold>3 Seconds</gold></dark_gray>")
             ));
 
-            // Tandai ID item
             meta.getPersistentDataContainer().set(ITEM_ID_KEY, PersistentDataType.STRING, "lightning_wand");
-            item.setItemMeta(meta);
-        }
+        });
         return item;
     }
 }
@@ -48,37 +44,35 @@ public final class CustomItemFactory {
 
 ---
 
-## 2. Sistem Cooldown: Visual Vanilla vs Timestamp
+## 2. Cooldown Management: Visual Vanilla Animations
 
-Minecraft memiliki API bawaan untuk menampilkan cooldown visual (animasi abu-abu berputar pada hotbar slot):
+Minecraft features a native client API to render visual cooldown overlays (the sweeping gray overlay on hotbar slots):
 
 ```java
-// Memberikan cooldown visual vanilla selama 60 tick (3 detik) pada Blaze Rod
+// Apply a 60-tick (3-second) vanilla cooldown to Blaze Rods
 player.setCooldown(Material.BLAZE_ROD, 60);
 
-// Memeriksa apakah pemain sedang dalam cooldown
+// Query if cooldown is active
 if (player.hasCooldown(Material.BLAZE_ROD)) {
-    player.sendActionBar(MiniMessage.miniMessage().deserialize("<red>Kemampuan masih cooldown!</red>"));
+    player.sendActionBar(MiniMessage.miniMessage().deserialize("<red>Ability is on cooldown!</red>"));
     return;
 }
 ```
 
 ---
 
-## 3. Raycasting Entitas & Partikel (Skill Sihir)
+## 3. Entity Raycasting & Particle Beams
 
-Raycasting digunakan untuk mendeteksi apa yang sedang dibidik pemain secara presisi menggunakan `World#rayTraceEntities` atau kalkulasi vektor:
+Raycasting detects target entities along the player's line of sight using `World#rayTraceEntities`:
 
 ```java
 package com.example.plugin.item;
 
 import net.kyori.adventure.sound.Sound;
 import net.kyori.adventure.text.minimessage.MiniMessage;
-import org.bukkit.FluidCollisionMode;
 import org.bukkit.Location;
 import org.bukkit.Material;
 import org.bukkit.Particle;
-import org.bukkit.SoundCategory;
 import org.bukkit.World;
 import org.bukkit.entity.Damageable;
 import org.bukkit.entity.Entity;
@@ -113,16 +107,15 @@ public final class CustomItemListener implements Listener {
         event.setCancelled(true);
         Player player = event.getPlayer();
 
-        // 1. Cek Cooldown
+        // 1. Check Cooldown
         if (player.hasCooldown(Material.BLAZE_ROD)) {
-            player.sendActionBar(MiniMessage.miniMessage().deserialize("<red>Tunggu sejenak sebelum menembak lagi!</red>"));
+            player.sendActionBar(MiniMessage.miniMessage().deserialize("<red>Ability cooling down!</red>"));
             return;
         }
 
-        // Set cooldown 3 detik (60 ticks)
         player.setCooldown(Material.BLAZE_ROD, 60);
 
-        // 2. Eksekusi Efek Serangan
+        // 2. Execute Spell Effect
         castLightningBeam(player);
     }
 
@@ -131,7 +124,7 @@ public final class CustomItemListener implements Listener {
         Location eyeLoc = player.getEyeLocation();
         Vector direction = eyeLoc.getDirection().normalize();
 
-        // Putar suara tembakan sihir
+        // Play cast sound
         player.playSound(Sound.sound(
             org.bukkit.Sound.ENTITY_ILLUSIONER_CAST_SPELL.key(),
             Sound.Source.PLAYER,
@@ -139,13 +132,13 @@ public final class CustomItemListener implements Listener {
             1.5f
         ));
 
-        // Partikel beam sepanjang garis pandang (hingga 30 blok)
+        // Spawn particle line (up to 30 blocks)
         for (double d = 1; d <= 30; d += 0.5) {
             Location point = eyeLoc.clone().add(direction.clone().multiply(d));
             world.spawnParticle(Particle.ELECTRIC_SPARK, point, 2, 0.05, 0.05, 0.05, 0.01);
         }
 
-        // Raytrace entitas yang terkena garis tembakan
+        // Raytrace entities colliding with beam
         RayTraceResult result = world.rayTraceEntities(
             eyeLoc,
             direction,
@@ -158,13 +151,12 @@ public final class CustomItemListener implements Listener {
             Entity target = result.getHitEntity();
             Location hitLoc = target.getLocation();
 
-            // Panggil sambaran petir visual & berikan damage
             world.strikeLightningEffect(hitLoc);
             if (target instanceof Damageable damageable) {
-                damageable.damage(8.0, player); // 8 damage = 4 hati
+                damageable.damage(8.0, player); // 8 damage = 4 hearts
             }
 
-            player.sendActionBar(MiniMessage.miniMessage().deserialize("<yellow>Tembakan Mengenai Target!</yellow>"));
+            player.sendActionBar(MiniMessage.miniMessage().deserialize("<yellow>Target struck!</yellow>"));
         }
     }
 }