Hacknet-Extension-Tutorial

commit

cd3bc93

parent

b27a467

author

ChronoVert

date

2025-10-20 14:12:25 +0000 UTC

docs + [Themes] 添加了主题的文档

  1@@ -0,0 +1,213 @@
  2+# Hacknet 主题文件使用指南
  3+
  4+## 扩展信息
  5+
  6+- **扩展名称**: YOU HACKER 2
  7+- **语言**: 中文 (zh-cn)
  8+- **起始主题**: HacknetBlue
  9+
 10+## 概述
 11+
 12+Hacknet 主题文件是用于自定义游戏界面的 XML 配置文件。通过修改主题文件，你可以完全改变游戏的外观和感觉。
 13+
 14+## 文件结构
 15+
 16+### 基本结构
 17+
 18+```xml
 19+<?xml version="1.0" encoding="UTF-8"?>
 20+<CustomTheme>
 21+  <!-- 配置项 -->
 22+</CustomTheme>
 23+```
 24+
 25+## 主要配置项
 26+
 27+### 1. 主题布局 (`themeLayoutName`)
 28+
 29+定义窗口的基本布局样式，可选值（这里指的是原版Hacknet的主题的布局）：
 30+
 31+- `blue` - 蓝色主题
 32+- `green` - 绿色主题
 33+- `white` - 白色主题
 34+- `mint` - 薄荷主题
 35+- `greencompact` - 紧凑绿色主题
 36+- `riptide` - 激流主题
 37+- `colamaeleon` - 变色龙主题
 38+- `riptide2` - 激流2主题
 39+
 40+### 2. 背景图片 (`backgroundImagePath`)
 41+
 42+设置自定义背景图片路径：
 43+
 44+- 推荐分辨率：1920x1080
 45+- 支持格式：JPG、PNG
 46+- 路径相对于扩展目录
 47+
 48+### 3. 核心颜色配置
 49+
 50+#### 主要颜色
 51+
 52+- `defaultHighlightColor` - 网络地图节点颜色
 53+- `defaultTopBarColor` - 顶部系统栏颜色
 54+- `moduleColorSolidDefault` - 模块窗口边框颜色
 55+- `moduleColorStrong` - 模块填充颜色
 56+- `moduleColorBacking` - 全屏背景色
 57+
 58+#### 执行程序模块
 59+
 60+- `exeModuleTopBar` - EXE顶部栏颜色
 61+- `exeModuleTitleText` - EXE标题文本颜色
 62+
 63+### 4. 界面元素颜色
 64+
 65+#### 功能按钮
 66+
 67+- `warningColor` - 警告/可视化界面按钮颜色
 68+- `subtleTextColor` - 次要文本颜色
 69+- `darkBackgroundColor` - 搜索框/邮件按钮背景色
 70+
 71+#### 背景和边框
 72+
 73+- `indentBackgroundColor` - 登录模块背景色
 74+- `outlineColor` - 节点连接线颜色
 75+
 76+#### 端口状态
 77+
 78+- `lockedColor` - 端口锁定/取消按钮颜色
 79+- `brightLockedColor` - 端口不可破解背景色
 80+- `unlockedColor` - 端口解锁后颜色
 81+- `brightUnlockedColor` - 成功状态颜色
 82+
 83+### 5. 文本和界面
 84+
 85+- `terminalTextColor` - 终端文本颜色
 86+- `topBarTextColor` - 顶部栏文本颜色
 87+- `netmapToolTipColor` - 网络地图提示文字颜色
 88+- `netmapToolTipBackground` - 网络地图提示背景色
 89+
 90+### 6. 特殊效果
 91+
 92+- `scanlinesColor` - 扫描线效果颜色
 93+- `thisComputerNode` - 玩家计算机节点颜色
 94+- `connectedNodeHighlight` - 当前连接节点高亮色
 95+
 96+## 颜色格式
 97+
 98+Hacknet 主题使用 RGBA 颜色格式：
 99+
100+- **RGB**: `红,绿,蓝` (每个值 0-255)
101+- **RGBA**: `红,绿,蓝,透明度` (透明度 0-255，0=完全透明，255=完全不透明)
102+
103+## Chronomia 主题分析
104+
105+### 主题特色
106+
107+基于 Chronomia.xml 主题文件，它具有以下特点：
108+
109+- **主色调**: 蓝色系 (30,111,233)
110+- **背景图片**: Themes/Backgrounds/Chronomia_jacket.png
111+- **终端文本**: 浅蓝色 (213,245,255)
112+- **模块边框**: 深蓝色 (53,59,238)
113+- **管理员提示**: 紫色 (4,0,255)
114+
115+### 关键颜色配置
116+
117+```xml
118+<!-- 管理员身份提示色 -->
119+<defaultHighlightColor>4,0,255</defaultHighlightColor>
120+<!-- 顶部系统栏 -->
121+<defaultTopBarColor>30,111,233</defaultTopBarColor>
122+<!-- 模块描边 -->
123+<moduleColorSolidDefault>53,59,238</moduleColorSolidDefault>
124+<!-- 终端文本颜色 -->
125+<terminalTextColor>213,245,255</terminalTextColor>
126+```
127+
128+## 使用示例
129+
130+### 创建新主题
131+
132+1. 在 `Themes/` 目录下创建新的 XML 文件
133+2. 复制基本结构
134+3. 根据需要修改颜色值
135+
136+### 示例主题文件
137+
138+```xml
139+<?xml version="1.0" encoding="UTF-8"?>
140+<CustomTheme>
141+  <themeLayoutName>blue</themeLayoutName>
142+  <backgroundImagePath>Themes/Backgrounds/your_image.png</backgroundImagePath>
143+  
144+  <defaultHighlightColor>255,41,63</defaultHighlightColor>
145+  <defaultTopBarColor>74,7,14,255</defaultTopBarColor>
146+  <moduleColorSolidDefault>0,204,132</moduleColorSolidDefault>
147+  
148+  <!-- 更多颜色配置 -->
149+</CustomTheme>
150+```
151+
152+## 安装方法
153+
154+1. **将主题文件放入扩展目录**:
155+
156+   - 将主题 XML 文件放入 `Themes/` 目录
157+   - 背景图片放入 `Themes/Backgrounds/` 目录
158+2. **在游戏中启用主题**:
159+
160+   - 修改 `ExtensionInfo.xml` 中的 `<StartingTheme>` 标签
161+   - 或通过游戏内主题选择器切换
162+3. **重启游戏**应用新主题
163+
164+   ```
165+
166+   ```
167+
168+## 最佳实践
169+
170+### 1. 颜色搭配原则
171+
172+- **保持一致性**: 确保颜色搭配协调
173+- **对比度**: 确保文本在背景上清晰可见
174+- **层次感**: 使用不同透明度创建视觉层次
175+
176+### 2. 文件管理
177+
178+- **备份原文件**: 修改前备份原始主题文件
179+- **渐进修改**: 每次只修改少量颜色进行测试
180+- **版本控制**: 为不同版本的主题创建备份
181+
182+### 3. 测试建议
183+
184+- **多环境测试**: 在不同光照条件下测试可读性
185+- **功能测试**: 确保所有界面元素都正常工作
186+- **性能测试**: 检查主题是否影响游戏性能
187+
188+## 故障排除
189+
190+### 常见问题
191+
192+1. **主题不生效**: 检查文件路径和格式是否正确
193+2. **颜色显示异常**: 验证 RGBA 值是否在有效范围内
194+3. **背景图片不显示**: 确认图片路径和格式正确
195+
196+### 调试技巧
197+
198+- 使用示例主题作为基础模板
199+- 逐个修改颜色值进行测试
200+- 查看游戏日志文件获取错误信息
201+
202+## 扩展资源
203+
204+### 内置主题参考
205+
206+- 查看 `Themes/ExampleTheme.xml` 获取标准配置
207+- 参考游戏原版主题文件学习最佳实践
208+
209+### 工具推荐
210+
211+- 使用颜色选择器工具获取精确的 RGB 值
212+- 使用图像编辑软件创建合适的背景图片
213+
214+通过合理配置这些颜色值，你可以创建出符合个人喜好的独特 Hacknet 游戏界面。祝您创作愉快！