Hacknet-Extension-Tutorial


commit
aa1f399
parent
eea6fe5
author
Bit
date
2023-01-19 03:22:07 +0000 UTC
Merge pull request #2 from BovineBeta/main

update
4 files changed,  +53, -7
M Content/Extension.md
+1, -1
1@@ -2,7 +2,7 @@
2 
3 扩展内容通过类型可以大致分为11个部分,这些目录分别是:  
4 - [Actions](./Actions.md) 实现游戏中的各种操作,各种对话,各种特效等  
5-- Factions 多个Action的集合,可实现比如CSEC任务数据库中最后一个任务的锁定  
6+- [Factions](./Faction.md) 多个Action的集合,可实现比如CSEC任务数据库中最后一个任务的锁定  
7 - Docs 一些文本内容,如el论坛的帖子  
8 - [HackerScripts](./HackerScripts.md) 黑客脚本,用来实现例如原版中naix的反击等  
9 - Missions 任务,在Hacknet中,每一个邮件都是一个任务  
M Content/Faction.md
+32, -1
 1@@ -1 +1,32 @@
 2-# Faction
 3+# Faction (阵营)
 4+
 5+Faction相当于一部分Action的包装, 与Action的区别在于**触发条件**.
 6+
 7+Faction只能通过`ExtensionInfo.xml`加载, 一个扩展可以加载多个Faction.
 8+
 9+Faction通过`Rank`(等级), 又称`Point`(积分)触发, 不同Faction的`Rank`是互相独立的.
10+
11+以下为Faction的大致结构:
12+~~~xml
13+<CustomFaction name="Faction Name" id="Faction_ID" playerVal="0">
14+    <Action ValueRequired="1">
15+        ...
16+    </Action>
17+
18+    <Action ValueRequired="2">
19+        ...
20+    </Action>
21+</CustomFaction>
22+~~~
23+
24+Faction根标签`<CustomFaction>`的属性:
25+
26+- `name`: Faction的名字
27+- `id`: Faction的id, 在设置Faction时起到作用.
28+- `playerVal`: 玩家在该Faction的初始`Rank`.
29+
30+# Faction的标签及其属性:
31+
32+Action标签`<Action>`: 
33+- `ValueRequired`: 激活该Action所需的`Rank`值. 
34+- 子标签: 可以为任何Action子标签(不可以是Action触发条件标签).
M GetStart.md
+16, -5
 1@@ -1,11 +1,22 @@
 2 # Get Start
 3 
 4-首先, 要制作一个Hacknet扩展, 正常情况下你需要准备以下内容:
 5+首先, 要制作一个Hacknet扩展, 你需要准备的内容大致如下:
 6 
 7-- Hacknet
 8-- 一台可以运行Hacknet的电脑
 9-- 一个可以正常使用的文本编辑器
10+- Hacknet 最新版本
11+- 一台可以正常运行Hacknet的电脑
12+- 一个可以正常使用的文本编辑器 (推荐使用[VSCode](https://code.visualstudio.com/)及其衍生编辑器)
13+- `xml`相关知识
14 
15-在制作扩展的过程中, 我们需要不断的使用文本编辑器去编写相关文件, 运行Hacknet来对扩展进行调试.
16+# 工作环境准备
17+
18+Hacknet 扩展的大量内容通过`xml`(可扩展标记语言) 文件记录. 这是个**非常简单**的语言, 这里不做过多介绍. 
19+
20+推荐使用[`Visual Studo Code`](https://code.visualstudio.com/)对扩展进行编辑, 因为[Hacknet-VSCode](https://github.com/AutumnRivers/hacknet-vscode)扩展可以实现hacknet扩展相关标签的自动补全. 
21+
22+你需要安装最新版Hacknet来对扩展进行调试. 
23+Hacknet有**专门的调试模式**与**语法检测功能**, 它可以**极大的**提高扩展的调试效率. 
24+Hacknet的特性非常多, 扩展的制作很难离开它. 
25+
26+找到Hacknet的根目录, 在子目录`Extensions`下创建用于存放hacknet扩展的新目录. 这个目录将成为扩展的根目录, 也是接下来你的工作目录. 
27 
28 如果你已经准备好了, 请前往 [Extension](./Content/Extension.md).
M README.md
+4, -0
 1@@ -4,6 +4,10 @@
 2 
 3 我们的目标是对官方的 Hacknet扩展教程 进行完善, 对网上残缺不齐的优秀教程进行整理. 
 4 
 5+这个扩展将持续维护, 如果发现任何不足, 欢迎创建`Issues`或者`Pull Request`.
 6+
 7+# Get Start
 8+
 9 [开始](./GetStart.md)
10 
11 # 参考内容