👷 Chore: Standardize code formatting and improve comments readability

Author: Core2002

README.md

@@ -33,7 +33,7 @@ FiFuSky 是整个 FiFu 生态系统的核心基石，完美体现了"保留原
 #### 🏗️ 核心架构设计
 - **岛屿坐标系统**：采用 1024×1024 方块的标准化岛屿网格，支持近 30,000 个岛屿的无限扩展
 - **智能岛屿分配**：通过螺旋算法自动分配岛屿位置，确保岛屿分布合理且易于管理
-- **模块化权限系统**：基于所有者-成员的二级权限架构，支持精细化的岛屿访问控制
+- **模块化权限系统**：基于所有者 - 成员的二级权限架构，支持精细化的岛屿访问控制
 - **SQLite 数据持久化**：采用轻量级数据库存储岛屿数据、玩家信息和权限配置
 
 #### 🎮 原版体验保护机制
@@ -119,7 +119,7 @@ FiFu 的核心设计哲学是**保留原版功能和特性的空岛体验**。
 ### 🌟 工具集思维
 - **原版优先**：所有组件设计以保留原版游戏特性为前提，在不破坏游戏平衡的前提下提供功能增强
 - **统一架构**：所有组件遵循 FiFu 统一设计标准，确保一致的用户体验
-- **无缝集成**：组件间深度协作，提供1+1>2的用户体验，同时保持原版游戏的核心魅力
+- **无缝集成**：组件间深度协作，提供 1+1>2 的用户体验，同时保持原版游戏的核心魅力
 - **模块化部署**：支持按需组合，灵活适应不同服务器需求，让每个服务器都能找到最适合的配置方案
 
 ### 🎮 玩家体验至上
@@ -200,8 +200,8 @@ cp */build/libs/*.jar /path/to/server/plugins/
 - **原版兼容**：所有功能增强都基于原版游戏机制，确保与 Minecraft 核心体验完美融合
 - **深度定制**：丰富的配置选项和扩展接口，让每个服务器都能打造独特体验
 - **国际化**：完整的多语言支持框架，服务全球玩家社区
-- **主题系统**：灵活的UI主题和样式自定义，在不影响原版体验的前提下美化界面
-- **API开放**：为开发者提供完整的API接口和文档，鼓励社区创新
+- **主题系统**：灵活的 UI 主题和样式自定义，在不影响原版体验的前提下美化界面
+- **API 开放**：为开发者提供完整的 API 接口和文档，鼓励社区创新
 
 ## 🤝 加入 FiFu
 

fifu-blood-display/src/main/java/fun/fifu/bloodvolumedisplay/ActionbarUtil.java

@@ -34,35 +34,35 @@ public final class ActionbarUtil {
      *
      * @param player  需要接收消息的玩家对象。
      * @param message 需要发送的消息内容。
-     *                此方法支持向兼容Minecraft 1.8和1.9及以上的玩家发送消息。
-     *                对于不同版本的Minecraft，消息发送的方式有所不同，因此需要通过版本检查来选择合适的方法。
-     *                对于1.9及以上版本，使用Spigot API的sendMessage方法发送消息到操作栏。
-     *                对于1.8及以下版本，需要通过反射调用原版Minecraft的NMS发送消息。
+     *                此方法支持向兼容 Minecraft 1.8 和 1.9 及以上的玩家发送消息。
+     *                对于不同版本的 Minecraft，消息发送的方式有所不同，因此需要通过版本检查来选择合适的方法。
+     *                对于 1.9 及以上版本，使用 Spigot API 的 sendMessage 方法发送消息到操作栏。
+     *                对于 1.8 及以下版本，需要通过反射调用原版 Minecraft 的 NMS 发送消息。
      */
     public static void sendMessage(Player player, String message) {
-        // 检查玩家对象和消息内容是否为null，如果是则直接返回。
+        // 检查玩家对象和消息内容是否为 null，如果是则直接返回。
         if (player == null || message == null) {
             return;
         }
-        // 如果版本不是1.9_R1或1.8_R1，则使用Spigot API发送消息到操作栏。
+        // 如果版本不是 1.9_R1 或 1.8_R1，则使用 Spigot API 发送消息到操作栏。
         if (!NMS_VERSION.startsWith("v1_9_R") && !NMS_VERSION.startsWith("v1_8_R")) {
             player.spigot().sendMessage(ChatMessageType.ACTION_BAR, new TextComponent(message));
             return;
         }
         try {
-            // 将Bukkit的Player对象转换为CraftPlayer对象，以便访问NMS方法。
+            // 将 Bukkit 的 Player 对象转换为 CraftPlayer 对象，以便访问 NMS 方法。
             Object craftPlayer = craftPlayerClass.cast(player);
-            // 根据Minecraft版本创建一个ChatComponent对象，该对象包含消息内容。
+            // 根据 Minecraft 版本创建一个 ChatComponent 对象，该对象包含消息内容。
             Object object = NMS_VERSION.equalsIgnoreCase("v1_8_R1") ? chatBaseComponent.cast(chat.getDeclaredMethod("a", String.class).invoke(chat, "{'text': '" + message + "'}")) : chat.getConstructor(String.class).newInstance(message);
-            // 创建一个Packet对象，用于发送消息到玩家。
+            // 创建一个 Packet 对象，用于发送消息到玩家。
             Object packetPlayOutChat = ppoc.newInstance(object, (byte) 2);
-            // 获取CraftPlayer对象的handle字段，该字段是一个原版Minecraft的Player对象。
+            // 获取 CraftPlayer 对象的 handle 字段，该字段是一个原版 Minecraft 的 Player 对象。
             Method handle = craftPlayerClass.getDeclaredMethod("getHandle");
             Object iCraftPlayer = handle.invoke(craftPlayer);
-            // 获取PlayerConnection对象，该对象用于发送Packet到玩家。
+            // 获取 PlayerConnection 对象，该对象用于发送 Packet 到玩家。
             Field playerConnectionField = iCraftPlayer.getClass().getDeclaredField("playerConnection");
             Object playerConnection = playerConnectionField.get(iCraftPlayer);
-            // 调用sendPacket方法，将消息发送到玩家。
+            // 调用 sendPacket 方法，将消息发送到玩家。
             Method sendPacket = playerConnection.getClass().getDeclaredMethod("sendPacket", packet);
             sendPacket.invoke(playerConnection, packetPlayOutChat);
         } catch (Exception ex) {

fifu-blood-display/src/main/java/fun/fifu/bloodvolumedisplay/Main.java

@@ -2,6 +2,6 @@
 
 public class Main {
     public static void main(String[] args) {
-        System.out.println("有没有一种可能，这只是一只普通的Minecraft插件捏owo");
+        System.out.println("有没有一种可能，这只是一只普通的 Minecraft 插件捏 owo");
     }
 }

fifu-book-editor/src/main/kotlin/fun/fifu/bookedit/BookCommand.kt

@@ -30,7 +30,7 @@ import java.time.format.DateTimeFormatter
 
 class BookCommand : TabExecutor {
     private val bookFiles = mutableListOf<String>()
-    private val myDateTimeFormatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日HH时")
+    private val myDateTimeFormatter = DateTimeFormatter.ofPattern("yyyy 年 MM 月 dd 日 HH 时")
 
     private val helpMassage = mapOf(
         "help" to "/book help [command] 来查看帮助",
@@ -41,7 +41,7 @@ class BookCommand : TabExecutor {
     )
 
     /**
-     * Tab完成函数，用于根据玩家输入提供命令建议。
+     * Tab 完成函数，用于根据玩家输入提供命令建议。
      *
      * @param p0 命令发送者，可以是玩家或服务器本身。
      * @param p1 命令对象。
@@ -137,11 +137,11 @@ class BookCommand : TabExecutor {
      *
      * @param p0 当前操作的玩家对象。
      * @param p3 一个字符串数组，包含操作指令的后续参数。第一个参数无用，第二个参数是书名，
-     *           如果有第三个参数，则表示目标玩家的名称，用于OP玩家给其他玩家看书。
-     * @return 总是返回true，表示操作已经被处理。
+     *           如果有第三个参数，则表示目标玩家的名称，用于 OP 玩家给其他玩家看书。
+     * @return 总是返回 true，表示操作已经被处理。
      *
-     * 此函数首先检查参数数量，如果不满足条件则直接返回false或true。
-     * 然后根据参数判断是否需要打开书籍，如果是OP玩家，还可以指定其他玩家打开书籍。
+     * 此函数首先检查参数数量，如果不满足条件则直接返回 false 或 true。
+     * 然后根据参数判断是否需要打开书籍，如果是 OP 玩家，还可以指定其他玩家打开书籍。
      */
     private fun viewBook(p0: Player, p3: Array<out String>): Boolean {
         if (p3.size == 1)
@@ -158,7 +158,7 @@ class BookCommand : TabExecutor {
                 player?.openBook(importBook("plugins/$pluginName/${p3[1].filt()}.txt", Material.WRITTEN_BOOK))
                 player?.sendMessage("正在浏览书 ${p3[1].filt()}")
             } else {
-                p0.sendMessage("只有OP才有这个权限")
+                p0.sendMessage("只有 OP 才有这个权限")
             }
         }
         return true
@@ -169,13 +169,13 @@ class BookCommand : TabExecutor {
      *
      * @param p0 玩家对象，书籍将被导入到这个玩家的库存中。
      * @param p3 包含导入命令参数的字符串数组，其中第二个元素是书籍的文件名。
-     * @return 如果成功导入书籍，则返回true；如果文件名不正确或书籍已存在，则返回false。
+     * @return 如果成功导入书籍，则返回 true；如果文件名不正确或书籍已存在，则返回 false。
      *
-     * 此函数首先检查数组p3的长度是否为1，如果是，则表示没有提供正确的文件名，因此直接返回false。
-     * 接着，它检查书籍文件名是否存在于bookFiles中，如果不存在，表示该书籍不需要导入，直接返回true。
+     * 此函数首先检查数组 p3 的长度是否为 1，如果是，则表示没有提供正确的文件名，因此直接返回 false。
+     * 接着，它检查书籍文件名是否存在于 bookFiles 中，如果不存在，表示该书籍不需要导入，直接返回 true。
      * 如果文件名存在，那么它会尝试导入书籍。书籍文件路径是基于插件名称和提供的文件名构建的。
      * 成功导入书籍后，它会将书籍添加到玩家的库存中，并通过发送消息通知玩家导入成功。
-     * 最后，函数返回true，表示书籍成功导入。
+     * 最后，函数返回 true，表示书籍成功导入。
      */
     private fun importBookFromFile(p0: Player, p3: Array<out String>): Boolean {
         if (p3.size == 1)
@@ -191,11 +191,11 @@ class BookCommand : TabExecutor {
      * 将玩家主手持有的书本导出到文件。
      *
      * 此函数检查玩家主手是否持有书本（或书与笔），如果是，则将该书本的内容导出到一个文本文件中。
-     * 导出的文件名基于玩家名称、当前时间以及书本的标题生成，存储在plugins目录下。
+     * 导出的文件名基于玩家名称、当前时间以及书本的标题生成，存储在 plugins 目录下。
      *
      * @param p0 当前玩家对象，必须持有书本才能导出。
-     * @param p3 一个字符串数组，其中p3[1]被用作导出文件名的一部分。
-     * @return 总是返回true，表示导出操作已启动（尽管实际成功与否取决于后续逻辑）。
+     * @param p3 一个字符串数组，其中 p3[1] 被用作导出文件名的一部分。
+     * @return 总是返回 true，表示导出操作已启动（尽管实际成功与否取决于后续逻辑）。
      */
     private fun exportBookToFile(p0: Player, p3: Array<out String>): Boolean {
         val bookMeta = p0.inventory.itemInMainHand.itemMeta ?: {
@@ -218,7 +218,7 @@ class BookCommand : TabExecutor {
      * 将玩家主手中的书复制到玩家的背包中。
      *
      * @param p0 需要复制书的玩家。
-     * @return 总是返回true，表示函数执行成功。
+     * @return 总是返回 true，表示函数执行成功。
      *
      * 函数首先检查玩家主手中的物品是否是书（BookMeta）类型，
      * 如果不是，则向玩家发送错误消息要求他们持有书。
@@ -242,8 +242,8 @@ class BookCommand : TabExecutor {
      * 当玩家输入特定的帮助命令时，此函数被调用，用于提供有关命令的详细信息或显示所有可用命令的列表。
      *
      * @param player 请求帮助的玩家对象。
-     * @param p3 帮助命令的参数数组，其中p3[1]用于指定特定的命令获取详细帮助。
-     * @return 总是返回true，表示帮助信息已成功发送给玩家。
+     * @param p3 帮助命令的参数数组，其中 p3[1] 用于指定特定的命令获取详细帮助。
+     * @return 总是返回 true，表示帮助信息已成功发送给玩家。
      */
     private fun onHelp(player: Player, p3: Array<out String>): Boolean {
         if (p3.size == 1) {
@@ -260,7 +260,7 @@ class BookCommand : TabExecutor {
     /**
      * 过滤字符串中的特定字符。
      *
-     * 该函数旨在从字符串中移除一些特殊字符，包括点号(.)、冒号(:)、斜杠(/)和反斜杠(\)。
+     * 该函数旨在从字符串中移除一些特殊字符，包括点号 (.)、冒号 (:)、斜杠 (/) 和反斜杠 (\)。
      * 这对于处理需要去除这些字符的字符串场景非常有用，比如文件路径处理或简单的字符串清洁。
      *
      * @return 返回一个新的字符串，其中不包含点号、冒号、斜杠和反斜杠。

fifu-book-editor/src/main/kotlin/fun/fifu/bookedit/BookEdit.kt

@@ -26,7 +26,7 @@ class BookEdit : JavaPlugin(), Listener {
     /**
      * 当插件加载时执行的函数。
      * 此函数主要负责初始化文件系统并创建插件目录。
-     * onLoad函数没有参数和返回值。
+     * onLoad 函数没有参数和返回值。
      */
     override fun onLoad() {
         fs = this

fifu-book-editor/src/main/kotlin/fun/fifu/bookedit/BookOperator.kt

@@ -24,9 +24,9 @@ import java.io.File
 object BookOperator {
 
     /**
-     * 复制一本书的元数据，并返回一个新的ItemStack。
+     * 复制一本书的元数据，并返回一个新的 ItemStack。
      *
-     * @return 一个具有相同页面的可写书的ItemStack。
+     * @return 一个具有相同页面的可写书的 ItemStack。
      */
     fun BookMeta.copyBook(): ItemStack {
         val bookMeta = Bukkit.getItemFactory().getItemMeta(Material.WRITABLE_BOOK) as BookMeta
@@ -48,16 +48,16 @@ object BookOperator {
      *
      * @param path 文件的路径。
      * @param type 导入后书的材质，默认为可写书。
-     * @return 一个具有导入页面的书的ItemStack。
+     * @return 一个具有导入页面的书的 ItemStack。
      */
     fun importBook(path: String, type: Material = Material.WRITABLE_BOOK) = makeBook(File(path).readText(), type)
 
     /**
      * 根据提供的文本和材质类型创建一本书籍物品。
      *
-     * @param text 书籍的页面内容，以JSON格式的字符串表示。
+     * @param text 书籍的页面内容，以 JSON 格式的字符串表示。
      * @param type 书籍的材质类型，默认为可书写的书籍。
-     * @return 创建的书籍物品Stack。
+     * @return 创建的书籍物品 Stack。
      */
     fun makeBook(text: String, type: Material = Material.WRITABLE_BOOK): ItemStack {
         val list = JSONParser().parse(text) as List<String>

fifu-book-editor/src/main/kotlin/fun/fifu/bookedit/Main.kt

@@ -4,7 +4,7 @@ class Main {
     companion object {
         @JvmStatic
         fun main(args: Array<String>) {
-            println("有没有一种可能，这只是一只普通的Minecraft插件捏qwq")
+            println("有没有一种可能，这只是一只普通的 Minecraft 插件捏 qwq")
         }
     }
 }

fifu-mining-list/src/main/kotlin/fun/fifu/mininglist/Main.kt

@@ -4,7 +4,7 @@ class Main {
     companion object {
         @JvmStatic
         fun main(args: Array<String>) {
-            println("有没有一种可能，这只是一只普通的Minecraft插件捏qwq")
+            println("有没有一种可能，这只是一只普通的 Minecraft 插件捏 qwq")
         }
     }
 }