Hacknet-Extension-Tutorial


commit
8a4ee58
parent
28fcd04
author
ChronoVert
date
2025-10-21 10:36:22 +0000 UTC
docs [Themes] 半成品
1 files changed,  +94, -106
M Content/Themes.md
+94, -106
  1@@ -1,116 +1,104 @@
  2-# Hacknet 主题文件使用指南
  3+# Themes(主题)
  4 
  5-## 概述
  6-
  7-Hacknet 主题文件是用于自定义游戏主题的 XML 配置文件
  8-
  9-## 文件结构
 10-
 11-### 基本结构
 12-
 13-```xml
 14-<?xml version="1.0" encoding="UTF-8"?>
 15-<CustomTheme>
 16-  <!-- 配置项 -->
 17-</CustomTheme>
 18-```
 19-
 20-## 主要配置项
 21-
 22-### 1. 主题布局 (`themeLayoutName`)
 23-
 24-定义窗口的基本布局样式,可选值(这里指的是原版Hacknet的主题的布局):
 25-
 26-- `blue` - 蓝色主题
 27-- `green` - 绿色主题
 28-- `white` - 白色主题
 29-- `mint` - 薄荷主题
 30-- `greencompact` - 紧凑绿色主题
 31-- `riptide` - 激流主题
 32-- `colamaeleon` - 变色龙主题
 33-- `riptide2` - 激流2主题
 34-
 35-### 2. 背景图片 (`backgroundImagePath`)
 36-在标签里输入你的背景图片的相对路径
 37-
 38-
 39-### 3. 核心颜色配置
 40-
 41-#### 主要颜色
 42-
 43-- `defaultHighlightColor` - 网络地图节点颜色
 44-- `defaultTopBarColor` - 顶部系统栏颜色
 45-- `moduleColorSolidDefault` - 模块窗口边框颜色
 46-- `moduleColorStrong` - 模块填充颜色
 47-- `moduleColorBacking` - 全屏背景色
 48-
 49-#### 执行程序模块
 50-
 51-- `exeModuleTopBar` - EXE顶部栏颜色
 52-- `exeModuleTitleText` - EXE标题文本颜色
 53-
 54-### 4. 界面元素颜色
 55-
 56-#### 功能按钮
 57-
 58-- `warningColor` - 警告/可视化界面按钮颜色
 59-- `subtleTextColor` - 次要文本颜色
 60-- `darkBackgroundColor` - 搜索框/邮件按钮背景色
 61-
 62-#### 背景和边框
 63-
 64-- `indentBackgroundColor` - 登录模块背景色
 65-- `outlineColor` - 节点连接线颜色
 66-
 67-#### 端口状态
 68-
 69-- `lockedColor` - 端口锁定/取消按钮颜色
 70-- `brightLockedColor` - 端口不可破解背景色
 71-- `unlockedColor` - 端口解锁后颜色
 72-- `brightUnlockedColor` - 成功状态颜色
 73-
 74-### 5. 文本和界面
 75-
 76-- `terminalTextColor` - 终端文本颜色
 77-- `topBarTextColor` - 顶部栏文本颜色
 78-- `netmapToolTipColor` - 网络地图提示文字颜色
 79-- `netmapToolTipBackground` - 网络地图提示背景色
 80-
 81-### 6. 特殊效果
 82-
 83-- `scanlinesColor` - 扫描线效果颜色
 84-- `thisComputerNode` - 玩家计算机节点颜色
 85-- `connectedNodeHighlight` - 当前连接节点高亮色
 86-
 87-
 88-
 89-
 90-## 使用示例
 91-标准的Theme文件见[Chronomia.xml](./../Assets/Themes/Chronomia.xml)
 92-
 93-
 94-
 95-### 示例主题文件
 96+在Hacknet中,Themes用于给玩家使用的主题
 97 
 98+一个Themes文件的结构如下:
 99 ```xml
100 <?xml version="1.0" encoding="UTF-8"?>
101 <CustomTheme>
102+  <!-- 窗口样式 -->
103   <themeLayoutName>blue</themeLayoutName>
104-  <backgroundImagePath>Themes/Backgrounds/your_image.png</backgroundImagePath>
105+
106+  <!-- This is a path to the background image file. It should be 1920x1080, and a .jpg or .png file.
107+  If this is left out, the theme will automatically generate a dynamic background for the theme-->
108+  <backgroundImagePath>Themes/Backgrounds/XXX.png</backgroundImagePath>
109   
110-  <defaultHighlightColor>255,41,63</defaultHighlightColor>
111-  <defaultTopBarColor>74,7,14,255</defaultTopBarColor>
112-  <moduleColorSolidDefault>0,204,132</moduleColorSolidDefault>
113+  <!-- Main Colors - these will define the main feel of the theme -->
114+  <!-- Color of nodes on the netmap, and many other derived colors. -->
115+  <!-- 管理员身份提示色 -->
116+  <defaultHighlightColor>230,235,50</defaultHighlightColor>
117+  <!-- 顶部系统栏 -->
118+  <defaultTopBarColor>40,88,160,125</defaultTopBarColor>
119+  <!-- This is used for the outlines of the module windows -->
120+  <!-- 模块描边 -->
121+  <moduleColorSolidDefault>110,240,230</moduleColorSolidDefault>
122+  <!-- 模块填充 -->
123+  <moduleColorStrong>0,0,0,120</moduleColorStrong>
124+  <!-- 全屏背景色 -->
125+  <moduleColorBacking>0,0,0,120</moduleColorBacking>
126+
127+  <!-- EXE顶部栏 -->
128+  <exeModuleTopBar>0,128,255,150</exeModuleTopBar>
129+  <!-- EXE标题文本 -->
130+  <exeModuleTitleText>200,200,200,255</exeModuleTitleText>
131+
132+  <!-- Extra Options -->
133+  <!-- 可视化界面按钮颜色 -->
134+  <warningColor>165,50,205</warningColor>
135+  <!-- 可视化界面登录按钮颜色 -->
136+  <subtleTextColor>150,30,180</subtleTextColor>
137+  <!-- 搜索框背景/邮件按钮等颜色 -->
138+  <darkBackgroundColor>8,8,8</darkBackgroundColor>
139+  <!-- use ram / 登录 模块背景色 -->
140+  <indentBackgroundColor>12,12,12</indentBackgroundColor>
141+  <!-- 节点之间连接线的颜色 -->
142+  <outlineColor>68,68,68</outlineColor>
143+  <!-- 断开/取消 按钮颜色、端口被锁住的颜色 -->
144+  <lockedColor>65,16,16,200</lockedColor>
145+  <!-- 显示端口不可破解的背景色 -->
146+  <brightLockedColor>160,0,0</brightLockedColor>
147+  <!-- sshcrack.exe小方格过度颜色、成功登录后成功两个字颜色等 -->
148+  <brightUnlockedColor>0,160,0</brightUnlockedColor>
149+  <!-- 端口解锁后的颜色 -->
150+  <unlockedColor>39,65,36</unlockedColor>
151+  <!-- MessageBoard使用 -->
152+  <lightGray>180,180,180</lightGray>
153+  <!-- 过载节点颜色[指RAM上的] 运行Shell时节点的颜色,以及您在[probe或nmap]看到的[检测到代理]和[检测到防火墙]的颜色 -->
154+  <shellColor>222,201,24</shellColor>
155+  <!-- shell过载按钮侧边颜色(经测试,按钮不够宽显示不出来侧边) -->
156+  <shellButtonColor>105,167,188</shellButtonColor>
157+  <!-- 模块bar文字色 -->
158+  <semiTransText>120,120,120,0</semiTransText>
159+  <!-- 终端文本颜色 -->
160+  <terminalTextColor>213,245,255</terminalTextColor>
161+  <!-- 顶部系统栏文本颜色 -->
162+  <topBarTextColor>255,255,255,150</topBarTextColor>
163+  <!-- 破解端口界面斜条纹颜色 -->
164+  <superLightWhite>2,2,2,30</superLightWhite>
165+  <!-- 当前连接的节点颜色 -->
166+  <connectedNodeHighlight>222,0,0,195</connectedNodeHighlight>
167+  <!-- 鼠标放到netmap节点上后显示右侧文字的颜色 -->
168+  <netmapToolTipColor>213,245,255,0</netmapToolTipColor>
169+  <!-- 鼠标放到netmap节点上后显示右侧文字的背景 -->
170+  <netmapToolTipBackground>0,0,0,70</netmapToolTipBackground>
171+  <!-- 顶部栏icon颜色 -->
172+  <topBarIconsColor>255,255,255</topBarIconsColor>
173+  <!-- 控制玩家计算机节点的颜色 -->
174+  <thisComputerNode>95,220,83</thisComputerNode>
175+  <!-- 搜索线的颜色 -->
176+  <scanlinesColor>255,255,255,15</scanlinesColor>
177   
178-  <!-- 更多颜色配置 -->
179+  <!-- AlienFX Colors used for Alienware (and other) hardware with variable LED lights that Hacknet can set dynamically -->
180+  <AFX_KeyboardMiddle>0,120,255</AFX_KeyboardMiddle>
181+  <AFX_KeyboardOuter>255,150,0</AFX_KeyboardOuter>
182+  <AFX_WordLogo>0,120,255</AFX_WordLogo>
183+  <AFX_Other>0,100,255</AFX_Other>
184 </CustomTheme>
185 ```
186-
187-
188-
189-## 标准示例文件
190-
191-- 查看 [Chronomia.xml](./../Assets/Themes/Chronomia.xml) 获取标准配置
192-- 参考游戏示例主题文件学习最佳实践
193-
194-
195+一个Theme有以下几个部分:
196+- themeLayoutName 窗口样式(布局)
197+- backgroundImagePath 主题背景路径
198+- defaultHighlightColor 连接节点时Display窗口顶部显示的"您是本系统的管理员"
199+- defaultTopBarColor 顶部的系统栏显示的颜色
200+- moduleColorSolidDefault 每个模块的描边颜色
201+- moduleColorStrong 每个模块填充的颜色
202+- moduleColorBacking 全屏背景色
203+- exeModuleTopBar exe程序顶部栏的颜色
204+- exeModuleTitleText exe标题文本颜色
205+- warningColor 可视化界面颜色(Trace时闪的颜色)
206+- subtleTextColor 登录按钮的颜色
207+- darkBackgroundColor 搜索框背景/邮件按钮等颜色
208+- indentBackgroundColor 顶部内存条显示占用(USED :RAM ??/??)的背景颜色
209+- outlineColor 节点之间的连接线颜色
210+- lockedColor 端口锁定状态的背景颜色(也是断开/取消的背景色)
211+-