GeneralLib - 插件开发核心库

💡简介

GeneralLib 是一个为 Bukkit/Spigot 插件开发者设计的 Java 库，旨在提供一系列通用工具和实用类，以简化常见开发任务，如数据库操作、字符串处理、数学计算和反射等。它可以帮助开发者快速构建功能，并保持代码的整洁与高效。

🎮核心功能与类库概览

数组与排序

• org.generallib.array.utils.Sort: 提供对 Map 的排序功能（基于实现了 Comparable 接口的 Value 值）。

二进制数据处理

• org.generallib.binary.utils.LittleEndianReader: 一个便捷的 ByteBuffer 包装器，用于读取或修改字节数组数据。

数据库

• org.generallib.database.Database: 数据库的抽象表示，采用键值对结构。
• org.generallib.database.Observable: 一个接口，用于标记对象状态为“已更改”，可用于评估哪些对象需要更新。
• org.generallib.database.DatabaseFile: 使用文件（配合 Gson 序列化器）的数据库实现。
• org.generallib.database.DatabaseMysql: 使用 MySQL（配合 Gson 序列化器）的数据库实现。
• org.generallib.database.MiniConnectionPoolManager: 用于 MySQL 的连接池管理。
• org.generallib.database.DatabaseTransferTask: 数据转移管理器。接受 TransferPair，该对象可通过源数据库和目标数据库实例化。

哈希生成

• org.generallib.hash.utils.HashGeneratorUtils: 如其名所示，提供多种哈希算法。所有方法均为静态方法。

位置处理

• org.generallib.location.utils.LocationNormalizer: 返回所提供位置的中心点坐标。

主类

• org.generallib.main: 插件加载的虚拟类。

数学表达式

• org.generallib.math.expression: 解析并计算来自字符串的数学表达式。

插件基础框架

• org.generallib.pluginbase: 包含一些可帮助快速、轻松创建新插件的类。

概率计算

• org.generallib.possibility.utils: 用于计算概率。

数据包工具（已过时）

• org.generallib.packets.utils: 请勿使用。自 1.8 版本后未更新。由于 ProtocolLib 已能实现相关功能，可能不再添加新内容。

反射工具

• org.generallib.reflection.utils.ReflectionHelper: 辅助进行反射操作的工具类（作者：lishid）。

序列化工具

• org.generallib.serializetools.FileSerialize: 一个抽象类，提供支持 UTF-8 编码的 FileConfiguration。

字符串工具

• org.generallib.strings.utils.EnglishChecker: 提供字符串验证功能。例如，isValidName 方法用于检查给定字符串是否为有效的 Windows 文件名。
• org.generallib.strings.utils.LoreOrganizer: 如果一句话太长，可将物品描述（Lore）分割成多行显示。

🔧开源与许可

GeneralLib 遵循 GNU 通用公共许可证 v3.0 (GPLv3) 发布。您可以在遵守该许可证条款的前提下自由使用、修改和分发此软件。有关详细信息，请参阅源代码文件头部的许可证声明或访问 GNU 官方网站。