AsieLib

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

asie（Vexatos）的通用基础库。提供聊天改造与昵称命令、物品染色 / 去色配方、 跨 mod 工具注册表、方块与 TileEntity 基类、网络包封装、音频流式播放等基础设施。 自身注册 0 方块 / 0 物品 / 0 实体，只新增 2 个自定义合成配方与 4 个（默认关闭的）命令。

身份

属性 实测值
modid asielib（全小写，Mods.java:20）
modName AsieLib（含非 ASCII 字符 é）
主包 pl.asie.lib
资源域 asielib
apiPackage api（pl.asie.lib.api 为对外 API 包）
Java 文件 91（含 4 个 package-info.java）
注册内容 0 方块 / 0 物品 / 0 实体（另有 2 个合成配方）
合成配方 2（asielib:colorizer、asielib:decolorizer）
命令 4（/me /nick /realname /spy），全部默认不注册
配置项 16，分散在 3 个文件，无集中 Config 类
事件 2 个（PlayerLoggedInEvent / ServerChatEvent）
语言文件 7（en / ru / fr / cs / de / pl + mcmod.info）
硬依赖 required-after:Forge@[10.13.2.1236,)
软依赖 `after:CoFHAPI
其它 usesMixins = false；coreModClass 为空；generateGradleTokenClass 为空（无 Tags 类）

[!IMPORTANT] 定位：纯库，零注册内容 README 首句即 AsieLib is the base library for all of asie's mods。 全仓没有 GameRegistry.registerBlock / registerItem / registerTileEntity 调用。 唯一「注册」的是 2 个 IRecipe（染色 / 去色）与 4 个命令。 blocks/、items/、tile/ 包下的类全是 abstract 基类或无实例工具类。

[!WARNING] 4 个命令默认一个都不存在 ChatHandler.registerCommands 只在 base/enableChatTweaks = true 时被调用， 而该项默认 false（ChatHandler.java:47）。 /spy 还额外要求 chatRadius > 0（默认 0）。 文档里不要把这 4 个命令写成「默认提供的功能」。

[!NOTE] version = "GRADLETOKEN_VERSION"（AsieLibMod.java:45）是构建期占位符， 替换配置 replaceGradleTokenInFile = AsieLibMod.java 指向本文件且存在，替换正常。 generateGradleTokenClass 为空 → 不生成 Tags 类。

[!NOTE] modid 常量表里有一处 modid ≠ 分类名： Mods.AE2 = "appliedenergistics2"。

入口与常量列表

API 包列表

方块与 TileEntity 基类列表

聊天与昵称列表

网络列表

集成列表

GUI 列表

行为微调列表

物品与染色列表

音频列表

工具类列表

源码缺陷

  • ClassTransformer - 死代码：实现 IClassTransformer 但全仓零引用，coreModClass 为空、无 IFMLLoadingPlugin；且 transform() 原样返回入参
  • ChatHandler - 格式化用 replaceAll("%m", message)， 消息中的 $ / \ 会抛异常，被 catch 吞掉后退化为裸消息
  • ChatHandlerEiraIRC - 17 行空占位类，0 功能
  • CommonProxy - getSide() 直接 return null，是无效实现
  • BlockBase - 第 455-459 行 getDebugInfo 是被注释掉的 @Optional.Method 代码，不在类中
  • TileMachine - 第 488-493 行 isGivingInformation / getInfoData 同样被注释掉
  • AnvilDyeTweak - 全名在根包 pl.asie.lib， 而同类在 pl.asie.lib.tweak.enchantment，包结构不一致
  • ToolRegistry - Iterable 迭代期间动态注册会 CME
  • Mods - 第 26 行 // GregTech = "gregtech" 是被注释的常量

依赖关系

硬依赖仅 Forge；4 个 CoFHAPI|* 为软依赖（after:）。 6 个工具提供者各自用 Mods.API.hasAPI(...) 做运行时判断，缺库时静默跳过， 因此这些 mod 均不构成硬依赖。

  • EnderIO - 已在收录范围，ToolProviderEnderIO 对接

BuildCraft、CoFH 系、OpenComputers 的工具接入点在本条目中提及， 但这些 mod 不在本 wiki 收录范围（relation.md 无对应行），故不建分类。 本 mod 被 asie 全家桶其它 mod 依赖，同样不在收录范围。