FBIK.
·
2025-10-18
ExtensionInfo.md
新增 Hacknet ExtensionInfo.xml 使用文档
概述
ExtensionInfo.xml是Hacknet扩展的核心配置文件，定义了扩展的基本属性、启动设置、资源引用等关键信息。
基本结构
1<HacknetExtension>
2 <!-- 配置项 -->
3</HacknetExtension>
主要配置项详解
1. 语言设置
1<Language>zh-cn</Language>
- 设置扩展的语言
- 支持的语言：英语(en-us)、德语(de-de)、法语(fr-be)、俄语(ru-ru)、西班牙语(es-ar)、韩语(ko-kr)、日语(ja-jp)、简体中文(zh-cn)
2. 基本信息
1<Name>IntroExtension</Name>
2<AllowSaves>true</AllowSaves>
- Name: 扩展名称（最大128字符，注意：不能是中文）
- AllowSaves: 是否允许保存游戏进度
3. 启动设置
1<StartingVisibleNodes>advExamplePC</StartingVisibleNodes>
2<StartingMission>Missions/Intro/IntroMission1.xml</StartingMission>
3<StartingActions>Actions/StartingActions.xml</StartingActions>
- StartingVisibleNodes: 初始可见节点（逗号分隔）
- StartingMission: 玩家启动时加载的任务
- StartingActions: 新会话创建时加载的条件动作集
4. 描述信息
1<Description>——介绍扩展——
2这个示例扩展将教授构建Hacknet扩展的基础知识。
3描述可以是多行，所以，我们已经在学习了!</Description>
- 在Hacknet中显示的扩展描述
- 支持多行文本
5. Faction设置
1<Faction>Factions/ExampleFaction.xml</Faction>
2<Faction>Factions/IntroFaction.xml</Faction>
- 定义扩展中涉及的阵营
- 可以定义任意数量的阵营
6. 教程和启动设置
1<StartsWithTutorial>False</StartsWithTutorial>
2<HasIntroStartup>true</HasIntroStartup>
- StartsWithTutorial: 是否以教程开始
- HasIntroStartup: 是否使用标准重启启动序列
7. 主题和音乐
1<StartingTheme>Themes/ExampleTheme.xml</StartingTheme>
2<IntroStartupSong>The_Quickening</IntroStartupSong>
- StartingTheme: 初始主题文件路径
- IntroStartupSong: 启动音乐（原版游戏歌曲名或自定义.ogg文件路径）
8. 扩展序列器设置 （主线末尾的Sequencer.exe）
1<SequencerTargetID>advExamplePC</SequencerTargetID>
2<SequencerSpinUpTime>10.5</SequencerSpinUpTime>
3<SequencerFlagRequiredForStart>testFlag</SequencerFlagRequiredForStart>
4<ActionsToRunOnSequencerStart>Actions/ThemeSwapActions.xml</ActionsToRunOnSequencerStart>
- SequencerTargetID: 序列器目标计算机ID
- SequencerSpinUpTime: 序列器启动时间（秒）
- SequencerFlagRequiredForStart: 启动序列器所需的Faction（派系，如：CSEC）Flag（一种标签，可在mission中添加）
- ActionsToRunOnSequencerStart: 序列器启动时运行的Action（动作）文件
9. Steam Workshop设置
1<WorkshopDescription>扩展描述（最多8000字符）</WorkshopDescription>
2<WorkshopLanguage>English</WorkshopLanguage>
3<WorkshopVisibility>2</WorkshopVisibility>
4<WorkshopTags>Extension</WorkshopTags>
5<WorkshopPreviewImagePath>WorkshopLogo.png</WorkshopPreviewImagePath>
6<WorkshopPublishID>NONE</WorkshopPublishID>
- WorkshopDescription: Steam Workshop描述
- WorkshopLanguage: Workshop语言
- WorkshopVisibility: 可见性（0=公开，1=仅好友，2=私有）
- WorkshopTags: 标签（逗号分隔）
- WorkshopPreviewImagePath: 预览图片路径（必须为正方形，小于1MB）
- WorkshopPublishID: 发布ID（首次发布后自动填充）
使用建议
- 路径引用: 所有文件路径都相对于扩展根目录
- 音乐文件: 可以引用原版游戏音乐或自定义.ogg文件
- 主题文件: 支持基础主题名称或自定义主题文件
- Workshop发布: 首次发布前WorkshopPublishID应为"NONE"
示例配置
1<HacknetExtension>
2 <Language>zh-cn</Language>
3 <Name>myext</Name>
4 <AllowSaves>true</AllowSaves>
5 <StartingMission>Missions/MyMission.xml</StartingMission>
6 <Description>这是我的第一个Hacknet扩展</Description>
7 <Faction>Factions/MyFaction.xml</Faction>
8 <StartingTheme>Themes/MyTheme.xml</StartingTheme>
9</HacknetExtension>