ModPlugin 精确聚焦

本节预期阅读时间：~5 分钟。

本节预期操作时间：~5 分钟。

在一切之前...

再次强调，编者默认您已经在此处或类似的地方学习了基本 Java 语法并安装了一种叫IDEA的工具，且包括编译、封装等基础操作。编者将默认您对于各类 Java 基础概念均拥有一定程度上的理解，并不再提及诸如类名调整等简单修改。如果您并不了解上述内容，请去学习它。

重新审视 ModPlugin

ModPlugin 是目前接触地较为频繁的类，也是一个关键类。ModPlugin 应当继承了 BaseModPlugin，它的主要作用是为生涯模式的新建、存档、读档相关步骤插入新的自定义步骤，以及用于设置各类舰船、导弹、武器开火的默认 AI。通常来说，ModPlugin 不会频繁修改。

    // 几个必须解析且常用的方法

	// 在游戏保存时调用
	public void beforeGameSave() {
		
	}

	// 在游戏读档完毕时调用
	public void onGameLoad(boolean newGame) {
		
	}

	// 在远行星号这个程序刚启动时调用
	public void onApplicationLoad() throws Exception {
		
	}

	// 在新建一局生涯时调用
	public void onNewGame() {
		
	}

	// 在此自定义舰船默认 AI，返回 null 时则为原版舰船 AI。注意传入的是 FleetMemberAPI
	public PluginPick<ShipAIPlugin> pickShipAI(FleetMemberAPI member, ShipAPI ship) {
		return null;
	}

	// 在此自定义武器开火默认 AI，返回 null 时则为原版武器开火 AI
	public PluginPick<AutofireAIPlugin> pickWeaponAutofireAI(WeaponAPI weapon) {
		return null;
	}

	// 在此自定义导弹默认 AI，返回 null 时则为原版导弹 AI
	public PluginPick<MissileAIPlugin> pickMissileAI(MissileAPI missile,
			ShipAPI launchingShip) {
		return null;
	}

	// 其余方法请自行 ctrl+左键 检查

现在详细回顾齿轮工业的 ModPlugin 到底做了什么事情：

package data.scripts;

import com.fs.starfarer.api.BaseModPlugin;
import com.fs.starfarer.api.Global;
import com.fs.starfarer.api.impl.campaign.shared.SharedData;

public class GearIn_ModPlugin extends BaseModPlugin {

	@Override
	public void onGameLoad(boolean newGame) {

	}

	@Override
	public void beforeGameSave() {

	}

	@Override
	public void onApplicationLoad() {

	}
	
	@Override
	public void onNewGame() {

		if (NEX()) {

		} else {
			// 在此准备生成星系

			new GearIn_NormalGenerate().generate(Global.getSector());
		}

		SharedData.getData().getPersonBountyEventData().addParticipatingFaction("gear_industry");
	}

	public static boolean NEX() {
		return Global.getSettings().getModManager().isModEnabled("nexerelin");
	}
}

很显然，它在 onNewGame 处添加了检测，当没有开启势力争霸时生成星系。然后用 SharedData 将势力注册到支持赏金机制的列表中。这是一个非常原始且简单的例子，但随着后续的开发，ModPlugin 将变得越来越复杂。

完全支持势力争霸

不过既然都以势力争霸作为例子了，那么就直接在此做它的完全支持。在前文 前缀名_NormalGenerate 的同目录下新建 前缀名_NEXGenerate，然后导入：

package data.scripts;

import com.fs.starfarer.api.campaign.SectorAPI;
import exerelin.campaign.SectorManager;

public class GearIn_NEXGenerate extends PLSP_NormalGenerate {
	
	@Override
	public void generate(SectorAPI sector) {
		if (SectorManager.getManager().isCorvusMode()) { // 检测 nex 是否为原版地图模式
			super.generate(sector);
		}
	}
}

并修改 ModPlugin：

			if (NEX()) {
				new GearIn_NEXGenerate().generate(Global.getSector());
			} else {
				new GearIn_NormalGenerate().generate(Global.getSector());
			}

即可完成完整的势力争霸支持。