upload

Author: DreamBoxSpy

docs/dev/advance/_category_.json

@@ -0,0 +1,7 @@
+{
+  "label": "高级",
+  "position": 5,
+  "link": {
+    "type": "generated-index"
+  }
+}

docs/dev/look-persudo.md

@@ -0,0 +1,62 @@
+---
+sidebar_position: 100
+---
+
+# 查看游戏代码
+
+本教程将指导你游戏代码流程。
+
+:::info
+
+**Dead Cells** 使用 **Haxe** 编写并运行在 **HashLink 虚拟机**上，而不是 **.NET 虚拟机**。
+
+:::
+
+:::tip
+
+在开始之前，建议阅读 [wiki](https://github.com/HaxeFoundation/hashlink/wiki) 了解 **HashLink 虚拟机** 的基本信息。
+
+:::
+
+## 使用 crashlink
+
+详见 [crashlink 文档](https://n3rdl0rd.github.io/crashlink/)。
+
+## 使用 hlbc-gui
+
+详见 [README](https://github.com/Gui-Yom/hlbc)。
+
+## 使用 GamePseudocode
+
+:::warning
+
+- **GamePseudocode** 是由 **Dead Cells** 的 **HashLink Bytecode** 转换而来。仅仅用于查看游戏代码流程。
+- 为了反编译结果的可读性， **GamePseudocode** 与 **HashLink Bytecode** 并非一一对应关系。
+- **GamePseudocode** 的结果可能是错误的，请结合 [crashlink](#使用-crashlink) 或 [hlbc](#使用-hlbc-gui) 使用。
+
+:::
+
+### 修改配置文件
+
+:::tip
+
+配置文件的位置：`coremod/config/modcore.json`
+
+初次启动后该文件会自动生成。
+
+:::
+
+- 打开配置文件，找到 `GeneratePseudocodeAssembly` 将其值修改为 `true`。
+- 保存配置文件。
+
+### 启动游戏
+
+- 启动游戏，游戏会自动生成 **GamePseudocode** ，请耐心等待。
+- 等待进入主菜单后，关闭游戏。
+
+### 打开 GamePseudocode
+
+- 进入目录 `coremod/cache` 应该可以发现 `GamePseudocode.dll` 文件。
+  - 如果不存在，请确认操作是否正确。
+- 使用你喜欢的 **.NET 反编译器** 打开 `GamePseudocode.dll`。
+  - 推荐使用 [DnSpy](https://github.com/dnSpyEx/dnSpy)。

docs/dev/tutorial/_category_.json

@@ -0,0 +1,7 @@
+{
+  "label": "开始制作 Mod",
+  "position": 1,
+  "link": {
+    "type": "generated-index"
+  }
+}

docs/dev/first-mod.md renamed to docs/dev/tutorial/first-mod.md

@@ -6,6 +6,23 @@ sidebar_position: 2
 
 本教程将指导你创建一个简单的 Mod ，实现修改游戏内某个基础功能的功能。
 
+:::warning
+
+虽然编写 **Mod** 时使用 **C#** ，但请记住 **Dead Cells** 使用 **Haxe** 编写并运行在 **HashLink 虚拟机**上，而不是 **.NET 虚拟机**。
+
+本教程假设你拥有以下技能：
+
+- C# 编程基础
+- Dead Cells 基础 Mod 制作 ([教程](https://www.bilibili.com/opus/681293864647000128))
+
+:::
+
+:::tip
+
+在开始之前，建议阅读 [wiki](https://github.com/HaxeFoundation/hashlink/wiki) 了解 **HashLink 虚拟机** 的基本信息。
+
+:::
+
 :::info
 本教程的 Mod 代码储存在 [Github](https://github.com/dead-cells-core-modding/docs-zh/blob/main/modproject/FirstDeadCellsMod) 上。
 :::
@@ -111,10 +128,11 @@ dotnet build
 - 确保已安装 .NET 9 SDK
 - 检查项目引用的 NuGet 包是否可用
 - 尝试清理解决方案后重新构建：
-'''powershell
+
+```powershell
 dotnet clean
 dotnet build
-'''
+```
 
 ### Q2: Mod 不加载
 

docs/dev/first-weapon.md renamed to docs/dev/tutorial/first-weapon.md

@@ -2,7 +2,7 @@
 sidebar_position: 3
 ---
 
-# 创造第一个武器
+# 创造第一把武器
 
 本教程将指导你创建一个简单的 Mod ，实现修改游戏内某个基础功能的功能。
 
@@ -12,14 +12,6 @@ sidebar_position: 3
 本章节大部分代码来自 **Frostbite**。感谢 Frostbite 对本教程的帮助。
 :::
 
-:::warning
-本教程假设你拥有以下技能：
-
-- C# 编程基础
-- 死亡细胞基础 Mod 制作 ([教程](https://www.bilibili.com/opus/681293864647000128))
-
-:::
-
 ## 创建 Mod 项目
 
 按照[教程](./first-mod.md)创造名为 **FirstWeapon** 的 Mod 项目。

docs/dev/install-mdk.md renamed to docs/dev/tutorial/install-mdk.md

@@ -1,6 +1,8 @@
-using dc.en;
+using dc;
+using dc.en;
 using dc.tool;
 using dc.tool.weap;
+using HaxeProxy.Runtime;
 using ModCore.Storage;
 using System;
 using System.Collections.Generic;
@@ -38,7 +40,12 @@ public override void fixedUpdate()
         {
             base.fixedUpdate();
             bool noStats = false;
-            this.owner.addCells(10, new HaxeProxy.Runtime.Ref<bool>(ref noStats));
+            owner.addCells(10, new Ref<bool>(ref noStats));
+        }
+
+        public override bool onExecute()
+        {
+            return base.onExecute();
         }
     }
 }