MyEssentials-Core

[!INFO] Git Commit: bc98d9d | Updated: 2026-10-01

通用工具库（library mod）。为 MyEssentials 系列及其它 mod 提供配置、本地化、 聊天组件、坐标、告示牌、工具、经济、传送、SQL 数据源、Curse 版本检查等 一整套基础设施。不注册任何方块 / 物品 / 实体 / 附魔 / 维度。

身份

[!WARNING] @Mod 的 version 字段是未替换的构建期占位符 MyEssentialsCore.java:20 写死 version = "GRADLETOKEN_VERSION"。 但 gradle.properties 的 replaceGradleTokenInFile 指向 BetterBarrels.java——本仓库中不存在该文件 （显然是其它项目的复制残留）。 后果：该占位符不会被替换，正式 jar 的 @Mod version 字面量就是 GRADLETOKEN_VERSION。generateGradleTokenClass 亦为空， 因此没有 Tags 类可作为替代来源。

[!WARNING] 7 个 ClassTransformer 全部未注册 源码包 myessentials.classtransformers/ 下 7 个类都 implements IClassTransformer， 但仓库中没有任何 IFMLLoadingPlugin 实现，coreModClass 为空， FMLCorePlugin 注解亦不存在。LaunchWrapper 因此从不调用它们—— 这 7 个类全部是死代码，其字节码补丁不会生效。 最直接的影响是告示牌功能：SignClassTransformer 需给 TileEntitySign 注入 myEssentials 字段，而 Sign 与 SignManager 都直接读该字段，补丁缺失将导致反射取字段失败。

[!NOTE] 本仓库没有 mcmod.info find 未发现该文件，modid 只能从 @Mod 注解与 gradle.properties 的 modId 读取（两者一致）。

核心与配置列表

• MyEssentialsCore - @Mod("MyEssentials-Core") 主类
• Config - 3 个配置项的声明
• Constants - 2 个路径常量
• PlayerTracker - 维护模式踢人
• ConfigTemplate - 配置绑定与重载框架
• ConfigProperty - 单个配置项的值容器

本地化列表

• Local - 单个 .lang 文件的加载与查询
• LocalManager - 全局 Local 注册表

聊天列表

• IChatFormat - 可转为聊天消息的标记接口
• JsonMessageBuilder - JSON 聊天组件链式构造（26 方法）
• ChatComponentContainer - 容器基类
• ChatComponentFormatted - 带格式分隔符
• ChatComponentList - 文本列表组件
• ChatComponentMultiPage - 分页组件（4 方法）
• ChatManager - 消息发送管理

ClassTransformer 列表（均未注册）

• SignClassTransformer - 给 TileEntitySign 注入 myEssentials 字段
• BlockFarmlandTransformer - BlockFarmland 踩踏处理
• BlockFireTransformer - BlockFire 放置处理
• BlockTaintFibersTransformer - 污秽纤维方块
• EntityFireballTransformer - EntityFireball 落地处理
• EntityThrowableTransformer - EntityThrowable 落地处理
• AE2PlaceTransformer - AE2 AppEngPacket 部件放置

事件列表

• ModifyBlockEvent - 3 方法，阻止/改写方块放置
• ProjectileImpactEvent - 2 个重载的 fireEvent
• AE2PartPlaceEvent - AE2 部件放置
• BlockTrampleEvent - 方块被踩踏
• ModifyBiomeEvent - 群系修改

异常列表

• EconomyException - extends RuntimeException
• FormatException - extends RuntimeException
• FormattedException - extends RuntimeException
• MyEssentialsTestException - extends Exception（受检）

JSON 列表

• SerializerTemplate - 序列化器模板基类
• JsonConfig - JSON 配置读写（8 方法）

数据源列表

• DatasourceSQL - SQL 数据源基类（7 方法）
• Schema - 建表与 DBUpdate 内部类
• Bridge - 桥接接口
• BridgeSQL - 通用 SQL 桥接
• BridgeSQLite - SQLite 实现
• BridgeMySQL - MySQL 实现

依赖下载列表

• DepLoader - 依赖加载入口
• Dependency - 依赖描述（6 方法）
• VersionedFile - 版本化文件（5 方法）
• Downloader - 实际下载

经济列表

• IEconManager - 经济管理器接口
• Economy - 本 mod 自己的经济抽象（4 方法）
• VaultEconomy - Vault 实现（9 方法）
• BukkitCompat - Bukkit 兼容
• ForgeessentialsEconomy - ForgeEssentials 实现（9 方法）

坐标与实体列表

• BlockPos - 方块坐标 + IChatFormat
• ChunkPos - 区块坐标 + NBT
• EntityPos - 实体坐标 + IChatFormat
• Volume - 轴对齐包围盒（15 方法 + 内部 Serializer）
• Tree - 树结构根
• TreeNode - 树节点

告示牌列表

• Sign - 告示牌容器（10 方法）
• SignType - 告示牌类型（4 方法）
• SignManager - 告示牌生命周期

工具列表

• Tool - 工具基类（6 方法）
• ToolManager - 工具注册与交互（6 方法）

传送列表

• Teleport - 传送目的地描述（11 方法）
• EssentialsTeleporter - 传送执行（3 方法）

工具类列表

• PlayerUtils - 玩家物品与 OP 判定（18 方法）
• WorldUtils - 区块枚举、实体掉落、最大高度
• EntityUtils - 实体权限 / 名称 / 类型
• ItemUtils - 物品名与物品栈互转
• StringUtils - 安全的 int/float/boolean 解析
• ClassUtils - 类加载与接口查询
• ChatUtils - 聊天发送与旧版文本转换
• MathUtils - 等差数列求和
• BlockUtils - 方块名查询
• ColorUtils - 颜色工具（0 个 public 方法）
• DelayedThread - 延迟执行线程

Curse 与版本检查列表

• Curse - CurseForge API 入口
• CurseModInfo - mod 信息 DTO（16 方法）
• VersionInfo - 版本信息 DTO（7 方法）
• CurseVersionChecker - 后台版本检查线程

内嵌 Vault 副本列表

[!IMPORTANT] net/milkbowl/vault/economy/ 下 2 个类是从 Vault 项目 原样内嵌的第三方代码，用于在没有 Vault 环境时提供编译期类型。

• Economy - myessentials.economy.api.Economy，4 个方法，本 mod 自家的值对象
• Vault Economy 接口 - net.milkbowl.vault.economy.Economy，43 个方法，内嵌第三方代码
• Vault EconomyResponse - 含嵌套 enum ResponseType

依赖关系

硬依赖仅 Forge。本 mod 被 MyEssentials 系列（如 MyTown、MyEssentials 本体） 依赖；这些 mod 不在本 wiki 收录范围（relation.md 无对应行），故不建分类。 VaultEconomy 与 ForgeessentialsEconomy 分别对接 Vault 与 ForgeEssentials，二者同样不在收录范围； 其中 Vault 的接口类型由本 mod 自行内嵌（见上），因此不构成外部硬依赖。