Package dev.architectury.loom.forge.minecraft

Class MinecraftLegacyPatchedProvider

java.lang.Object

dev.architectury.loom.forge.minecraft.MinecraftPatchedProvider

dev.architectury.loom.forge.minecraft.MinecraftLegacyPatchedProvider

public class MinecraftLegacyPatchedProvider
extends MinecraftPatchedProvider

Nested Class Summary

Nested classes/interfaces inherited from class dev.architectury.loom.forge.minecraft.MinecraftPatchedProvider

MinecraftPatchedProvider.ProductionOptions, MinecraftPatchedProvider.ThrowingProducer, MinecraftPatchedProvider.Type

Field Summary

Fields inherited from class dev.architectury.loom.forge.minecraft.MinecraftPatchedProvider

dirty, logger, minecraftProvider, project, type

Constructor Summary

Constructors

Constructor	Description
MinecraftLegacyPatchedProvider(org.gradle.api.Project project, MinecraftProvider minecraftProvider, MinecraftPatchedProvider.Type type)

Method Summary

Modifier and Type	Method	Description
protected boolean	checkCache()	锁内二次确认：判定现有产物能否复用，并返回本次是否需要整链重建.
protected Path[]	getGlobalCaches()	Returns 本配置下必须可复用的共享产物列表，供 MinecraftPatchedProvider.needsWork() 判定.
Path	getMinecraftIntermediateJar()
Path	getMinecraftPatchedIntermediateJar()
Path	getMinecraftPatchedJar()
protected void	patchJars(Path clean, Path output, Path patches)	对给定 jar 执行 Forge 的 binary patch.
protected void	produceIntermediateJarIfMissing()	确保 MinecraftPatchedProvider.getMinecraftPatchedIntermediateJar() 指向的产物已存在.
void	provide()
void	remapJar(ServiceFactory serviceFactory)

Methods inherited from class dev.architectury.loom.forge.minecraft.MinecraftPatchedProvider

accessTransform, accessTransformForge, copyMissingClasses, createAccessTransformerOptions, createBinpatcherTool, createMcpExecutor, createNeoForgeInstallerTools, createPrePatchJarMcpOptions, createPrePatchJarMcpOptions, get, getMinecraftPatchedIntermediateAtJar, getOrProduceMinecraftPatchedIntermediateJar, getPrePatchJarProducerTaskPath, isDirty, isPatchedJarUpToDate, isReusableJar, produceFinalJarsForTask, produceFinalJarsInto, producePatchedIntermediateForTask, productionOptions, provideProjectionBlocker, publishAtomically, remapJarProjectionBlocker, runAccessTransformer, runBinpatcher, runMcpExecutor, runProduction, withLock, withPatchedLock

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

MinecraftLegacyPatchedProvider

public MinecraftLegacyPatchedProvider(org.gradle.api.Project project,
 MinecraftProvider minecraftProvider,
 MinecraftPatchedProvider.Type type)

Method Details

provide

public void provide()
             throws Exception

Overrides:

provide in class MinecraftPatchedProvider

Throws:

Exception

checkCache

protected boolean checkCache()
                      throws IOException

锁内二次确认：判定现有产物能否复用，并返回本次是否需要整链重建.

与父类一致，本方法不再删除共享产物：删除会让锁外只做存在性判定的读方拿到缺失文件， 也会让其它工作树互相触发重建。legacy 链没有单一版本标记产物，任一件缺失即无法确认 其余产物与当前算法同代，因此按整链重建处理（各件仍以「临时文件 + 原子落位」重新生成）。

Overrides:

checkCache in class MinecraftPatchedProvider

Returns:

是否需要整链重建

Throws:

IOException

getGlobalCaches

protected Path[] getGlobalCaches()

Description copied from class: MinecraftPatchedProvider

Returns 本配置下必须可复用的共享产物列表，供 MinecraftPatchedProvider.needsWork() 判定..

列表只包含当前 jar 配置确实会生成的产物：server-only 不提供 client jar， client-extra.jar 既不生成也不进 classpath、不注册进 FORGE_EXTRA（见 MinecraftPatchedProvider.providesClientJar()）， 把它计入判定会让 MinecraftPatchedProvider.needsWork() 恒为真、每次构建都白取一次跨进程锁。

Overrides:

getGlobalCaches in class MinecraftPatchedProvider

Returns:

本配置下必须可复用的共享产物列表，供 MinecraftPatchedProvider.needsWork() 判定

produceIntermediateJarIfMissing

protected void produceIntermediateJarIfMissing()
                                        throws Exception

Description copied from class: MinecraftPatchedProvider

确保 MinecraftPatchedProvider.getMinecraftPatchedIntermediateJar() 指向的产物已存在.

默认实现调用 MinecraftPatchedProvider.provide()；legacy 链的产物在 MinecraftPatchedProvider.remapJar(ServiceFactory) 阶段生成（provide() 只做判定），由子类覆盖补齐。

任务路径下不能走 provide()：那条路径只做接线、不写产物。本方法只被**配置期读者**调用 （getOrProduceMinecraftPatchedIntermediateJar 的调用方：mappings 迁移的配置期回退路径）， 而那个读者与 MinecraftPatchedProvider.provideProjectionBlocker() 用的是同一个判据——走到这里时任务路径本不该生效。 真走到这里（产物在判定之后被其它工作树删掉或写坏）时，provide() 只做接线， 随后 getOrProduceMinecraftPatchedIntermediateJar 的可复用性复检会以明确异常报出， 而不是把不存在的路径交给迁移器去读。

Overrides:

produceIntermediateJarIfMissing in class MinecraftPatchedProvider

Throws:

Exception

remapJar

public void remapJar(ServiceFactory serviceFactory)
              throws Exception

Overrides:

remapJar in class MinecraftPatchedProvider

Throws:

Exception

patchJars

protected void patchJars(Path clean,
 Path output,
 Path patches)
                  throws Exception

Description copied from class: MinecraftPatchedProvider

对给定 jar 执行 Forge 的 binary patch.

工具的 classpath、主类与参数模板都由 ForgeExternalToolService.Options 声明： classpath 是惰性的（配置期只接线，取值推迟到真正执行时），发起调用也只依赖 ServiceFactory。 因此本方法既能在配置期路径里调用，也能在把它连同调用点搬进任务之后于执行期调用—— 那条路径上不再有任何需要 Project 的同步求值。

Overrides:

patchJars in class MinecraftPatchedProvider

Throws:

Exception

getMinecraftIntermediateJar

public Path getMinecraftIntermediateJar()

Overrides:

getMinecraftIntermediateJar in class MinecraftPatchedProvider

getMinecraftPatchedIntermediateJar

public Path getMinecraftPatchedIntermediateJar()

Overrides:

getMinecraftPatchedIntermediateJar in class MinecraftPatchedProvider

getMinecraftPatchedJar

public Path getMinecraftPatchedJar()

Overrides:

getMinecraftPatchedJar in class MinecraftPatchedProvider