[Question] Why can't my game detect MagicLib? / 为什么我的游戏无法检测到 MagicLib

[Hendrix-Shen]

Question Type

Usages

Description

Since MagicLib 0.8, the old multi-version packaging has been abandoned. Now each version is packaged in a separate jar.

For Fabric-like platforms

Loading core and Minecraft components by default. Other components will be loaded only when the corresponding dependencies are installed. For example:

• magiclib-malilib-extra: You need to install malilib for this component to work properly.

For Forge-like platforms

You need to satisfy all dependencies for the module to load properly. However, dependency restrictions can be reduced by installing only the required components

==================================================

自 MagicLib 0.8 开始，抛弃了以往的多版本打包。现在每个版本用独立的 Jar 包。

对于 Fabric类 平台

默认加载 core 和 Minecraft 组件。其它组件需要安装对应依赖时才会被加载。例如：

• magiclib-malilib-extra: You need to install malilib for this component to work properly!

对于 Forge类 平台

你需要满足所有依赖条件，模组才能正常加载。但可以通过只安装所需的组件来减少依赖限制。

//////////////////////////////////////////////////

We are using preprocess to compile the mod. A jar package for the separate Minecraft version is provided. We also provide a wrapper jar for running directly in different versions of the Minecraft environment. Problems with dependency checks also occur as a result.

Example:

• If you install magiclib-1.19.2-0.5.37.jar, but also install TweakMyClient-3.2.268+fc2ad10-stable.jar, you will have problem. Because TweakMyClient's wrapper cannot find MagicLib's wrapper. Game won't start.
• If you install magiclib-1.19.2-0.5.37.jar, but also install TweakMyClient-1.19.1-3.1.255+af25ac8-stable.jar, you will have problems. Because TweakMyClient could not find a matching MagicLib. Game won't start.
• If you install magiclib-1.19.2-0.5.37.jar, but also install TweakMyClient-3.1.255+af25ac8-stable.jar (Designed for Minecraft 1.19.1), you will have problems. Because TweakMyClient could not find a matching MagicLib. The game will start, but TweakMyClient will not work

The mods affected by this are as follows:

• Carpet-TCTC-Addition 2.0+
• Bilibili-Danmaku
• MasaGadget 3.0+
• oh-my-minecraft-client 0.5+
• TweakMyClient 3.0+
• xaero-map-addition 0.2.3+

The most conservative solution is to install MagicLib's wrapper, i.e. without the Minecraft version suffix. And projects that depend on this can be chosen voluntarily. Please note that both MagicLib and the dependent mods should ensure that the supported version is the same as the Minecraft version you are running, otherwise any issues that do not match the running environment will not be supported.

==================================================

我们使用 预处理 来编译模组。提供了针对单独Minecraft版本的jar包。 同时我们也提供了一个包装jar，用于直接在不同版本的Minecraft环境下运行。也因此出现了在依赖检查上的问题。

举例：

• 如果您安装了 magiclib-1.19.2-0.5.37.jar，但是同时安装了 TweakMyClient-3.2.268+fc2ad10-stable.jar 就会出现问题。因为 TweakMyClient 的包装器无法找到 MagicLib 的包装器。游戏无法启动。
• 如果您安装了 magiclib-1.19.2-0.5.37.jar，但是同时安装了 TweakMyClient-1.19.1-3.1.255+af25ac8-stable.jar 就会出现问题。因为 TweakMyClient 无法找到与之匹配的 MagicLib。游戏无法启动。
• 如果您安装了 magiclib-1.19.2-0.5.37.jar，但是同时安装了 TweakMyClient-3.1.255+af25ac8-stable.jar （为 Minecraft 1.19.1 设计） 就会出现问题。因为 TweakMyClient 无法找到与之匹配的 MagicLib。游戏可以启动，但是 TweakMyClient 不会工作。

受此影响的模组如下：

• Carpet-TCTC-Addition 2.0+
• Bilibili-Danmaku
• MasaGadget 3.0+
• oh-my-minecraft-client 0.5+
• TweakMyClient 3.0+
• xaero-map-addition 0.2.3+

最保守的解决方案是安装 MagicLib 的包装器，即不带有 Minecraft版本 后缀的。而依赖于此的项目则可以自愿选择。请注意，无论是 MagicLib 还是附属模组都应该确保支持版本与你所运行的 Minecraft 版本一致，否则任何不符合运行环境的议题都不会被支持。