From 5c64739b354a2929ce9dc4f81f43aab80b34e853 Mon Sep 17 00:00:00 2001
From: Saplonily <Saplonily@outlook.com>
Date: Sun, 3 Dec 2023 13:19:11 +0800
Subject: [PATCH] Deployed 04527d8 with MkDocs version: 1.5.3

---
 404.html                                 |   73 +-
 arc/basic_env/index.html                 |   73 +-
 arc/sdk-styled-proj/index.html           |   73 +-
 begin/basic_env/index.html               |   73 +-
 begin/celeste_everest_monomod/index.html |   73 +-
 begin/hook,reading_1/index.html          |   73 +-
 begin/preference/index.html              |   73 +-
 begin/reading_2/index.html               |   73 +-
 begin/simple_entity/index.html           |   73 +-
 begin/simple_texturing/index.html        |   73 +-
 begin/simple_trigger/index.html          |   73 +-
 extra_luacs/index.html                   | 1529 ++++++++++++++++++++++
 extra_luacs/lua-in-vscode.png            |  Bin 0 -> 52743 bytes
 index.html                               |   73 +-
 other/xml-speedrun/index.html            |   75 +-
 search/search_index.json                 |    2 +-
 sitemap.xml.gz                           |  Bin 127 -> 127 bytes
 trans/adv_hooks/index.html               |   73 +-
 trans/common1/index.html                 |   73 +-
 trans/ec_common/index.html               |   73 +-
 trans/il/index.html                      |   73 +-
 21 files changed, 2688 insertions(+), 86 deletions(-)
 create mode 100755 extra_luacs/index.html
 create mode 100755 extra_luacs/lua-in-vscode.png

diff --git a/404.html b/404.html
index 6f32a69..e015aa1 100755
--- a/404.html
+++ b/404.html
@@ -20,7 +20,7 @@
     
     
       
-        <title>蔚蓝Code Mod教程</title>
+        <title>Celeste Code Mod 教程</title>
       
     
     
@@ -78,7 +78,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="/." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="/." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="/assets/images/favicon.png" alt="logo">
 
@@ -91,7 +91,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -181,12 +181,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="/." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="/." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="/assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -694,6 +694,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="/extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/arc/basic_env/index.html b/arc/basic_env/index.html
index ad0a944..886e853 100755
--- a/arc/basic_env/index.html
+++ b/arc/basic_env/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>基础环境配置 - 蔚蓝Code Mod教程</title>
+        <title>基础环境配置 - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -773,6 +773,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/arc/sdk-styled-proj/index.html b/arc/sdk-styled-proj/index.html
index c0b2fba..91272f2 100755
--- a/arc/sdk-styled-proj/index.html
+++ b/arc/sdk-styled-proj/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>偏好-sdk-styled-proj - 蔚蓝Code Mod教程</title>
+        <title>偏好-sdk-styled-proj - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -752,6 +752,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/begin/basic_env/index.html b/begin/basic_env/index.html
index 951a4ec..3a2a18d 100755
--- a/begin/basic_env/index.html
+++ b/begin/basic_env/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>基础环境配置 - 蔚蓝Code Mod教程</title>
+        <title>基础环境配置 - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -808,6 +808,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/begin/celeste_everest_monomod/index.html b/begin/celeste_everest_monomod/index.html
index b456da7..fc26933 100755
--- a/begin/celeste_everest_monomod/index.html
+++ b/begin/celeste_everest_monomod/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>Celeste, Everest, MonoMod - 蔚蓝Code Mod教程</title>
+        <title>Celeste, Everest, MonoMod - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -766,6 +766,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/begin/hook,reading_1/index.html b/begin/hook,reading_1/index.html
index bd55325..395119d 100755
--- a/begin/hook,reading_1/index.html
+++ b/begin/hook,reading_1/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>钩子, 阅读代码 I - 蔚蓝Code Mod教程</title>
+        <title>钩子, 阅读代码 I - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -793,6 +793,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/begin/preference/index.html b/begin/preference/index.html
index 5324f1b..dcae08f 100755
--- a/begin/preference/index.html
+++ b/begin/preference/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>偏好 - 蔚蓝Code Mod教程</title>
+        <title>偏好 - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -773,6 +773,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/begin/reading_2/index.html b/begin/reading_2/index.html
index ca239fa..791a55e 100755
--- a/begin/reading_2/index.html
+++ b/begin/reading_2/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>阅读代码 II - 蔚蓝Code Mod教程</title>
+        <title>阅读代码 II - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -792,6 +792,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/begin/simple_entity/index.html b/begin/simple_entity/index.html
index 5aabe62..85af14d 100755
--- a/begin/simple_entity/index.html
+++ b/begin/simple_entity/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>简单自定义实体 - 蔚蓝Code Mod教程</title>
+        <title>简单自定义实体 - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -867,6 +867,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/begin/simple_texturing/index.html b/begin/simple_texturing/index.html
index 99d18b4..1b02107 100755
--- a/begin/simple_texturing/index.html
+++ b/begin/simple_texturing/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>简单贴图 - 蔚蓝Code Mod教程</title>
+        <title>简单贴图 - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -786,6 +786,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/begin/simple_trigger/index.html b/begin/simple_trigger/index.html
index a14508a..3fc8997 100755
--- a/begin/simple_trigger/index.html
+++ b/begin/simple_trigger/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>简单自定义Trigger - 蔚蓝Code Mod教程</title>
+        <title>简单自定义Trigger - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -773,6 +773,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/extra_luacs/index.html b/extra_luacs/index.html
new file mode 100755
index 0000000..4b2af7c
--- /dev/null
+++ b/extra_luacs/index.html
@@ -0,0 +1,1529 @@
+
+<!doctype html>
+<html lang="zh" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="Celeste Code Mod Tourial">
+      
+      
+        <meta name="author" content="Saplonily">
+      
+      
+      
+        <link rel="prev" href="../other/xml-speedrun/">
+      
+      
+      
+      <link rel="icon" href="../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.4.6">
+    
+    
+      
+        <title>首页 - Celeste Code Mod 教程</title>
+      
+    
+    
+      <link rel="stylesheet" href="../assets/stylesheets/main.35e1ed30.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+      <link rel="stylesheet" href="../css/content.css">
+    
+    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    <body dir="ltr">
+  
+    
+    
+      <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script>
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+        
+        <a href="#-luacutscene" class="md-skip">
+          跳转至
+        </a>
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="页眉">
+    <a href=".." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
+      
+  <img src="../assets/images/favicon.png" alt="logo">
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            Celeste Code Mod 教程
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              首页
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="搜索" placeholder="搜索" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="查找">
+        
+        <button type="reset" class="md-search__icon md-icon" title="清空当前内容" aria-label="清空当前内容" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            正在初始化搜索引擎
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/Saplonily/CelesteModTourial" title="前往仓库" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    GitHub
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+
+<nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href=".." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
+      
+  <img src="../assets/images/favicon.png" alt="logo">
+
+    </a>
+    Celeste Code Mod 教程
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/Saplonily/CelesteModTourial" title="前往仓库" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    GitHub
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+    <li class="md-nav__item">
+      <a href=".." class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
+        
+          
+          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    入门
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2">
+            <span class="md-nav__icon md-icon"></span>
+            入门
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../begin/celeste_everest_monomod/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Celeste, Everest, MonoMod
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../begin/basic_env/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    基础环境配置
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../begin/preference/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    偏好
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../begin/hook%2Creading_1/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    钩子, 阅读代码 I
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../begin/simple_entity/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    简单自定义实体
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../begin/simple_trigger/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    简单自定义Trigger
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../begin/reading_2/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    阅读代码 II
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../begin/simple_texturing/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    简单贴图
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        
+          
+          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    过渡
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+            过渡
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../trans/ec_common/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    更多EC
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../trans/common1/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Alarm, Tween, Coroutine
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../trans/il/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    IL
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../trans/adv_hooks/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    IL 钩子与随意钩取
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
+        
+          
+          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    历史归档
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+            历史归档
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../arc/basic_env/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    基础环境配置
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../arc/sdk-styled-proj/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    偏好-sdk-styled-proj
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
+        
+          
+          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    其他
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5">
+            <span class="md-nav__icon md-icon"></span>
+            其他
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../other/xml-speedrun/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    XML简单介绍
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+    
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+    
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+        
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="目录">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      目录
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#_1" class="md-nav__link">
+    前言
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#_2" class="md-nav__link">
+    配置环境
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#hello-world" class="md-nav__link">
+    Hello World
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#hello-world_1" class="md-nav__link">
+    对话 Hello World
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#_3" class="md-nav__link">
+    基础概念
+  </a>
+  
+    <nav class="md-nav" aria-label="基础概念">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#_4" class="md-nav__link">
+    函数
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#if" class="md-nav__link">
+    变量, 返回值, if
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#_5" class="md-nav__link">
+    更多函数
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#_6" class="md-nav__link">
+    逻辑运算符
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#_7" class="md-nav__link">
+    其他特殊函数
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#_8" class="md-nav__link">
+    其他函数
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#c" class="md-nav__link">
+    C# 交互
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="目录">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      目录
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#_1" class="md-nav__link">
+    前言
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#_2" class="md-nav__link">
+    配置环境
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#hello-world" class="md-nav__link">
+    Hello World
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#hello-world_1" class="md-nav__link">
+    对话 Hello World
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#_3" class="md-nav__link">
+    基础概念
+  </a>
+  
+    <nav class="md-nav" aria-label="基础概念">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#_4" class="md-nav__link">
+    函数
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#if" class="md-nav__link">
+    变量, 返回值, if
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#_5" class="md-nav__link">
+    更多函数
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#_6" class="md-nav__link">
+    逻辑运算符
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#_7" class="md-nav__link">
+    其他特殊函数
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#_8" class="md-nav__link">
+    其他函数
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#c" class="md-nav__link">
+    C# 交互
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+  
+  
+
+
+<h1 id="-luacutscene">额外 - LuaCutscene</h1>
+<h2 id="_1">前言</h2>
+<p>欢迎来到这个额外章节, 虽然它被我扔到了 code mod 教程之中, 但是它实际上不需要太多的 C# 能力.<br />
+在这里会主要包含一些 LuaCutscene 本身以及使用其调用 C# 代码实现的有趣的效果,
+如果你想要你的剧情拥有更多的炫酷效果, 而不是局限于只有对话框和 Madeline 无聊的走动,
+比如炫酷的镜头缓动, 周边实体的花样表演, 甚至是拥有改变 gp 能力的剧情! 那么或许这里刚好就适合你.
+那么现在就开始吧.  </p>
+<h2 id="_2">配置环境</h2>
+<p>这一步事实上是可选的, 不过为了更愉快的 lua 代码的书写,
+我个人还是觉得挺有必要的.<br />
+在这里我会推荐使用 <a href="https://code.visualstudio.com/Download">VSCode</a> 配上 <a href="https://marketplace.visualstudio.com/items?itemName=sumneko.lua">Lua(sumneko.lua)</a>
+插件.<br />
+<img alt="lua-in-vscode" src="lua-in-vscode.png" /></p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>我个人不太会配置这种 lua 环境, 所以如果你遇到了大量的未定义警告你可以选择在设置中搜索 <code>Lua.diagnostics.enable</code> 并将其关闭.</p>
+</div>
+<h2 id="hello-world">Hello World</h2>
+<p>那么, 老传统. 现在, 在你的地图中放置一个 <code>LuaCutscene</code> 的 <code>LuaCutscene/LuaCutsceneTrigger</code>, 然后设置其 <code>Filename</code> 参数为一个 lua 文件的路径比如 <code>Luas/testlua</code>(注意没有后缀.lua),
+然后 Save Changes. 然后我们根据刚才设置的路径正确放置我们的 lua 文件:</p>
+<ul>
+<li>&lt;你的 mod 名字&gt;<ul>
+<li>Luas<ul>
+<li>testlua.lua</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<p>然后写上我们的 Hello World!</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;[Cutscene] Hello from the Cutscene!&quot;</span><span class="p">)</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>保存后按下 F3 键重载你的地图, 然后走进你摆放的 trigger 内, 之后, 检查你的控制台, 或者检查你最新的 log.txt, 你应该会在茫茫日志海中看到这一行输出:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span><code>(12/03/2023 10:36:35) [Everest] [Info] [LevelLoader] Loading Saplonily/FunnyButFuckingMaps/MaybeAFunnyMap
+(12/03/2023 10:36:35) [Everest] [Warn] [Content] CONFLICT in C:\Program Files (x86)\Steam\steamapps\common\Celeste\Mods\MaxHelpingHand v1.28.3.zip\Graphics\Sprites.xml: Overriding element player_playback.
+<span class="hll">[Cutscene] Hello from the Cutscene!
+</span>(12/03/2023 10:36:45) [Everest] [Info] [LevelLoader] Loading Saplonily/FunnyButFuckingMaps/MaybeAFunnyMapOverriding element player_playback.
+</code></pre></div></td></tr></table></div>
+<p>高亮行便是我们的 lua 代码打印出来的.</p>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p>在之后的过程中虽然你可以反复翻看 log.txt 来知晓你的 lua 代码的运行情况, 不过这显然不如你有一个控制台窗口直接能看到输出.<br />
+对于在 windows 上, 你可以向蔚蓝根目录下的文件 <code>everest-launch.txt</code> 新加入一行 <code>--console</code> 来在蔚蓝每次启动时附带一个控制台窗口.</p>
+</div>
+<h2 id="hello-world_1">对话 Hello World</h2>
+<p>当然, 在控制台里看无聊的日志打印是没意思的, 所以现在我们向它加入几条对话.<br />
+首先为你这一段对话起一段名字, 比如 <code>TESTDIALOG_HELLO</code>, 通常我们建议前缀是你的地图名以防命名冲突, 后缀你可以根据你的爱好来取,
+比如加上剧情所在面名, 或者干脆是剧情的自增序号. 然后新建一个 <code>Simplified Chinese.txt</code>, 也就是对话文件:</p>
+<ul>
+<li>&lt;你的 mod 名字&gt;<ul>
+<li>Dialog<ul>
+<li>Simplified Chinese.txt</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<p>以及它的内容:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code>TESTDIALOG_HELLO=
+    [MADELINE left normal]
+    我是 {+MADELINE}.
+</code></pre></div></td></tr></table></div>
+<p>然后更改 lua 代码:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_HELLO&quot;</span><span class="p">)</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>现在重载资源, 进入 trigger, 你就能看到 Madeline <sub>~微笑</sub>~着说 "我是 &lt;你的存档名&gt;." 了.<br />
+在这里对话状态时玩家依然能动, 可以通过将 lua 代码改成这样来在对话进行时禁止移动:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_HELLO&quot;</span><span class="p">)</span>
+    <span class="n">enableMovement</span><span class="p">()</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<h2 id="_3">基础概念</h2>
+<p><del>相信在前面的阅读中你肯定是一头雾水的</del>, 因为你对 lua 代码通常依然是一无所知的, 那就对了, 现在我们就来介绍几个简单的概念.</p>
+<h3 id="_4">函数</h3>
+<p>在我们刚刚的 lua 代码中, 最外围的由 <code>function</code> 到 <code>end</code> 围起来的东西我们就叫一个函数:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_HELLO&quot;</span><span class="p">)</span>
+    <span class="n">enableMovement</span><span class="p">()</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p><code>function</code> 和 <code>end</code> 这种关系到代码结构的东西我们就叫它 '关键字', <code>function</code> 关键字后面到左括号之内的内容就是这个函数的函数名,
+在这里即 <code>onBegin</code>, 在这里这个函数名是特殊的, 它会被 LuaCutscene 在玩家进入 trigger 时且剧情可以播放时 '调用'.
+括号内的内容我们叫参数, 这里 LuaCutscene 要求我们 <code>onBegin</code> 这个特殊函数不能带参数或者带一个参数, 这里我们暂时置空, 也就是只有一对括号, 不带参数.
+而这之中的内容便是函数的内容物, 也即主体, 它会从上到下顺序执行我们的代码.  </p>
+<p>通常主体是我们所聚焦的东西, 在这里, 我们的主体包含三行代码. 第一行代码是 <code>disableMovement()</code>, 也就是一个名称加上一对括号,
+它表示调用一个名为 <code>disableMovement</code> 的函数, 并且不带参数, 这和刚才函数的声明有点相像,
+<code>disableMovement</code> 是一个 LuaCutscene 为我们提前准备好的, 也即 '定义' 好的函数,
+它的作用是禁止玩家的移动, 与之相对的就是 <code>enableMovement</code> 函数, 它会允许玩家移动.
+中间的第二行代码调用了 <code>say</code> 这个函数, 它表示播放一个对话, 那么这里对话名就需要作为参数传递了,
+所以我们在括号中写入刚才我们的对话名 <code>TESTDIALOG_HELLO</code>, 记住要带双引号, 因为它是一个 '字符串'.  </p>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p><code>disableMovement</code> 与 <code>enableMovement</code> 函数都是瞬间执行完毕的, 函数会马上继续执行下面的代码,
+而 <code>say</code> 函数调用后直到玩家看完对话才会继续执行下面的代码. 对于后者我们特别地称为 <code>协程函数</code>.</p>
+</div>
+<h3 id="if">变量, 返回值, if</h3>
+<p>现在, 我们观察下面代码:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span>
+<span class="normal">8</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="kd">local</span> <span class="n">hasFlag</span> <span class="o">=</span> <span class="n">getFlag</span><span class="p">(</span><span class="s2">&quot;MY_AWESOME_FLAG&quot;</span><span class="p">)</span>
+    <span class="kr">if</span> <span class="n">hasFlag</span> <span class="kr">then</span>
+        <span class="n">disableMovement</span><span class="p">()</span>
+        <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_HELLO&quot;</span><span class="p">)</span>
+        <span class="n">enableMovement</span><span class="p">()</span>
+    <span class="kr">end</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>在函数开头我们使用了 <code>local a = b()</code> 这种语法, 开头的 <code>local</code> 关键字表示我们要声明一个变量, 紧跟的 <code>hasFlag</code> 表示这个变量的名称,
+随后再次跟上一个 <code>=</code> 号, 这表示我们想以 <code>=</code> 号后边的值作为这个变量的值, 在这里它是 <code>getFlag</code> 这个预先定义的函数的返回值,
+函数通常用于做一些事情, 而它的返回值就表示这件事做的如何, 在这里 <code>getFlag</code> 函数用于检测它的参数指代的那个 flag 是否存在,
+当检测到 flag 存在时它会返回 <code>true</code>, 否之则返回 <code>false</code>. 这里这个返回值的 '类型' 是 <code>bool</code>, 它只有刚才提到的两个值, 所以同样地 <code>hasFlag</code> 这个变量的类型是 <code>bool</code>.  </p>
+<p>当我们从 <code>getFlag</code> 得到了对应 flag 是否存在的信息后, 我们使用 if 语句来检测它, 首先我们以 <code>if</code> 开头, 然后紧跟一个 <code>bool</code> 类型的值,
+也就是这里的 <code>hasFlag</code> 变量, 然后再跟上一个 <code>then</code> 关键字, 随后再次跟上一小段代码, 随后以 <code>end</code> 结束, 这里的意思就是我们希望 <code>then</code> 到 <code>end</code>
+所包围起来 '代码块' 仅在 <code>hasFlag</code> 为 <code>true</code>, 也即 <code>getFlag</code> 返回 <code>true</code>, 也即 flag <code>MY_AWESOME_FLAG</code> 存在时执行. 现在你可以试试复制上述的代码,
+然后在你的地图中放置两个 flag Trigger, 一个开启 <code>MY_AWESOME_FLAG</code> 这个 flag, 一个关闭 flag, 然后分别尝试走进剧情 trigger,
+你很容易会发现仅在 <code>MY_AWESOME_FLAG</code> flag 开启时剧情才会被播放, 也就是播放剧情的那三行代码才会被执行.  </p>
+<p>实际上既然 <code>if</code> 到 <code>then</code> 之间只需要一个类型为 <code>bool</code> 的值, 那么这里其实不需要 <code>hasFlag</code> 这个变量作为过渡:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="kr">if</span> <span class="n">getFlag</span><span class="p">(</span><span class="s2">&quot;MY_AWESOME_FLAG&quot;</span><span class="p">)</span> <span class="kr">then</span>
+        <span class="n">disableMovement</span><span class="p">()</span>
+        <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_HELLO&quot;</span><span class="p">)</span>
+        <span class="n">enableMovement</span><span class="p">()</span>
+    <span class="kr">end</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>这行代码与上面是等效的.  </p>
+<p>通常有时候我们希望 flag 拥有情况不一的时候播放不同的剧情, 比如上面拥有 <code>MY_AWESOME_FLAG</code> flag 时播放剧情 A, 而没有时播放剧情 B. 首先我们先更新我们的对话文件:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span></pre></div></td><td class="code"><div><pre><span></span><code>TESTDIALOG_HELLO=
+    [MADELINE left normal]
+    拥有 flag
+
+TESTDIALOG_HELLO_NOFLAG=
+    [MADELINE left normal]
+    没有 flag
+</code></pre></div></td></tr></table></div>
+<p>然后更新 lua 代码:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 1</span>
+<span class="normal"> 2</span>
+<span class="normal"> 3</span>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span>
+<span class="normal">11</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="kr">if</span> <span class="n">getFlag</span><span class="p">(</span><span class="s2">&quot;MY_AWESOME_FLAG&quot;</span><span class="p">)</span> <span class="kr">then</span>
+        <span class="n">disableMovement</span><span class="p">()</span>
+        <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_HELLO&quot;</span><span class="p">)</span>
+        <span class="n">enableMovement</span><span class="p">()</span>
+    <span class="kr">else</span>
+        <span class="n">disableMovement</span><span class="p">()</span>
+        <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_HELLO_NOFLAG&quot;</span><span class="p">)</span>
+        <span class="n">enableMovement</span><span class="p">()</span>
+    <span class="kr">end</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>现在在游戏中尝试一下, 符合我们的期望: 没有 flag 时播放 <code>TESTDIALOG_HELLO_NOFLAG</code> 这个对话, 拥有 flag 时播放 <code>TESTDIALOG_HELLO</code> 这个对话.  </p>
+<p>观察上述代码, 我们发现禁止和允许移动的那一对函数调用没必要重复两遍写在 if 里, 因为无论 if 的条件是否成立它们都是先禁止移动, 然后再允许移动,
+所以我们将那一对代码抽离并放置在最上下:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span>
+<span class="normal">8</span>
+<span class="normal">9</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="kr">if</span> <span class="n">getFlag</span><span class="p">(</span><span class="s2">&quot;MY_AWESOME_FLAG&quot;</span><span class="p">)</span> <span class="kr">then</span>
+        <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_HELLO&quot;</span><span class="p">)</span>
+    <span class="kr">else</span>
+        <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_HELLO_NOFLAG&quot;</span><span class="p">)</span>
+    <span class="kr">end</span>
+    <span class="n">enableMovement</span><span class="p">()</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>当然, 效果是一样的, 但是我们的代码简洁了不少.</p>
+<h3 id="_5">更多函数</h3>
+<p>现在, 回忆一下我们已经了解到了哪些函数:</p>
+<ul>
+<li>一个最上面使用过的函数 <code>print</code>, 作用为将它的参数内容输出出来</li>
+<li><code>disableMovement</code>, 没有参数, 作用为禁止玩家的移动</li>
+<li><code>enableMovement</code>, 没有参数, 作用为允许玩家的移动</li>
+<li><code>say</code>, 作用为播放参数所指的对话</li>
+<li><code>getFlag</code>, 作用为检测参数所指的 flag 是否存在, 并且返回该值</li>
+</ul>
+<p>当然, 函数的参数不可能只有一个, 比如 <code>cassetteFly</code> 函数:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">cassetteFly</span><span class="p">(</span><span class="o">-</span><span class="mi">100</span><span class="p">,</span> <span class="o">-</span><span class="mi">100</span><span class="p">)</span>
+    <span class="c1">-- cassetteFly 调用完后并不会等待...</span>
+    <span class="n">enableMovement</span><span class="p">()</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p>-- 并加上空格起头的一行表示一行注释, 当代码执行到这时会直接忽略这一行, 此外还有块注释, 即忽略块所包围的一整块代码:
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 1</span>
+<span class="normal"> 2</span>
+<span class="normal"> 3</span>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="cm">--[[</span>
+<span class="cm">        在这里</span>
+<span class="cm">        写</span>
+<span class="cm">        任意</span>
+<span class="cm">        多</span>
+<span class="cm">        的注释!</span>
+<span class="cm">    ]]</span><span class="c1">--</span>
+    <span class="n">say</span><span class="p">(</span><span class="s2">&quot;SOMETHING_INTERESTING&quot;</span><span class="p">)</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div></p>
+</div>
+<p><code>cassetteFly</code> 函数作用为乘坐泡泡飞行一段距离(收集磁带后的动作), 它需要接收两个参数, 它们均为 <code>number</code> 类型, 表示一个数字,
+多个参数之间使用 <code>,</code> 逗号分隔开来, 注意这里参数类型是数字, 所以不需要加上双引号表示为字符串. 第一个参数表示横向的相对飞行距离, 单位 px,
+正值向右, 负值向左, 第二个参数表示纵向的相对飞行距离, 正值向<strong>下</strong>, 负值向<strong>上</strong>.  </p>
+<p>不过不太好的是 <code>cassetteFly</code> 不是协程函数, 这会造成调用了该函数后马上调用 <code>enableMovement</code> 函数, 这会打断泡泡飞行的过程,
+所以我们先暂时删掉 <code>enableMovement</code> 的调用, 不过不要担心, 泡泡飞行结束后会自动帮我们允许移动:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">cassetteFly</span><span class="p">(</span><span class="o">-</span><span class="mi">100</span><span class="p">,</span> <span class="o">-</span><span class="mi">100</span><span class="p">)</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>然后到游戏中观察这个泡泡飞行进行所需的大概时间, 发现大概是 1.5 秒, 所以我们在泡泡飞行的调用后面紧跟一个 <code>wait</code> 的调用:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">cassetteFly</span><span class="p">(</span><span class="o">-</span><span class="mi">100</span><span class="p">,</span> <span class="o">-</span><span class="mi">100</span><span class="p">)</span>
+    <span class="n">wait</span><span class="p">(</span><span class="mf">1.5</span><span class="p">)</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>顺便, 泡泡飞行结束后会自动允许移动, 所以我们还得再次禁掉移动:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">cassetteFly</span><span class="p">(</span><span class="o">-</span><span class="mi">100</span><span class="p">,</span> <span class="o">-</span><span class="mi">100</span><span class="p">)</span>
+    <span class="n">wait</span><span class="p">(</span><span class="mf">1.5</span><span class="p">)</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>以及, 我们还希望在这个过程之后再播放一段对话:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">cassetteFly</span><span class="p">(</span><span class="o">-</span><span class="mi">100</span><span class="p">,</span> <span class="o">-</span><span class="mi">100</span><span class="p">)</span>
+    <span class="n">wait</span><span class="p">(</span><span class="mf">1.5</span><span class="p">)</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_FLY&quot;</span><span class="p">)</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>这是对应的 dialog:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code>TESTDIALOG_FLY=
+    [MADELINE left normal]
+    嘿我刚才完成了一次泡泡飞行哎
+</code></pre></div></td></tr></table></div>
+<p>顺便不要忘了再允许移动:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span>
+<span class="normal">8</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">cassetteFly</span><span class="p">(</span><span class="o">-</span><span class="mi">100</span><span class="p">,</span> <span class="o">-</span><span class="mi">100</span><span class="p">)</span>
+    <span class="n">wait</span><span class="p">(</span><span class="mf">1.5</span><span class="p">)</span>
+    <span class="n">disableMovement</span><span class="p">()</span>
+    <span class="n">say</span><span class="p">(</span><span class="s2">&quot;TESTDIALOG_FLY&quot;</span><span class="p">)</span>
+    <span class="n">enableMovement</span><span class="p">()</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>现在在游戏里试一下, 是不是先向左上角进行一个 (-100, -100) 的泡泡飞行,
+然后过了 1.5 秒后准时播放 <code>TESTDIALOG_FLY</code> 这个对话, 然后仅在对话结束后才能移动?</p>
+<hr />
+<p>除了使用 flag trigger 设置 flag 以外, 还可以在 lua 中设置 flag:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">setFlag</span><span class="p">(</span><span class="s2">&quot;FLAG_FROM_LUA&quot;</span><span class="p">,</span> <span class="kc">true</span><span class="p">)</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p><code>setFlag</code> 函数接收两个参数, 第一个参数为 string 类型, 指代一个 flag, 第二个参数为 bool 类型, 表示要设置为开启还是关闭.
+那么显而易见, 效果就是经过这个 "剧情" trigger 时 <code>FLAG_FROM_LUA</code> 这个 flag 会被开启. 你可以找一些其他的 flag 驱动的实体来验证一下.  </p>
+<p>顺便我们还可以做一个有趣的效果, 经过 trigger 时反转开启状态:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="n">setFlag</span><span class="p">(</span><span class="s2">&quot;FLAG_FROM_LUA&quot;</span><span class="p">,</span> <span class="ow">not</span> <span class="n">getFlag</span><span class="p">(</span><span class="s2">&quot;FLAG_FROM_LUA&quot;</span><span class="p">))</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p><code>getFlag</code> 返回了一个 bool 类型的值, 然后我们在这个值, 在这里是函数调用的返回值左侧写一个 not, 它表示翻转 bool 的值,
+即 true -&gt; false, false -&gt; true, 那么在这里就是每次触发 trigger 时 <code>FLAG_FROM_LUA</code> 的开启状态被反转.  </p>
+<h3 id="_6">逻辑运算符</h3>
+<p>对于这些 lua 通用内容就直接丢个 w3c 的链接了:<br />
+<a href="https://www.w3cschool.cn/lua/lua-miscellaneous-operator.html">Lua 运算符 w3cschool - https://www.w3cschool.cn/...</a></p>
+<p>运用上面的知识你可以写一个 if 使得仅在两个 flag 同时成立时才执行内部的代码:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span>
+<span class="normal">8</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onBegin</span><span class="p">()</span>
+    <span class="kd">local</span> <span class="n">flagA</span> <span class="o">=</span> <span class="n">getFlag</span><span class="p">(</span><span class="s2">&quot;MY_FLAG_A&quot;</span><span class="p">)</span>
+    <span class="kd">local</span> <span class="n">flagB</span> <span class="o">=</span> <span class="n">getFlag</span><span class="p">(</span><span class="s2">&quot;MY_FLAG_B&quot;</span><span class="p">)</span>
+
+    <span class="kr">if</span> <span class="n">flagA</span> <span class="ow">and</span> <span class="n">flagB</span> <span class="kr">then</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;同时成立!&quot;</span><span class="p">)</span>
+    <span class="kr">end</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<h2 id="_7">其他特殊函数</h2>
+<p>除了上文提到的 <code>onBegin</code> 这个特殊函数外, 还有另外一个经常用到的 <code>onEnd</code> 函数,
+顾名思义, 就是剧情结束时被调用的函数, 它通常会带两个参数:</p>
+<div class="language-lua highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="kr">function</span> <span class="nf">onEnd</span><span class="p">(</span><span class="n">room</span><span class="p">,</span> <span class="n">wasSkipped</span><span class="p">)</span>
+    <span class="c1">-- 做一些清理工作...</span>
+<span class="kr">end</span>
+</code></pre></div></td></tr></table></div>
+<p>通常我们只会在 <code>onEnd</code> 调用中做清理工作, 比如说删掉剧情中出现的额外实体, 设置玩家的位置到最终位置等等,
+注意的是, 跳过剧情这个动作实际上会直接打断 <code>onBegin</code> 的执行, 并且也会调用 <code>onEnd</code>, 这个打断位置是不可预知.<br />
+其中第一个参数是 <code>Level</code> 类型的值, 它是一个蔚蓝代码中的类型, 这里我们暂时忽略, 来关注第二个参数, 它是一个 <code>bool</code> 类型的值,
+它表示这个剧情是自然结束的还是被跳过的, 比如在一些移动较多的剧情中<sub>~(多动症)</sub>~, 其 <code>onEnd</code> 就会通常是设置玩家的位置到最终位置,
+顺带一提, 官图中有些剧情的位置设置只设置了横坐标, 所以比如 5a 进入内部那段路的在半空中跳过剧情来直接横向移动到按钮上的速通技巧才得以实现.  </p>
+<p>注意的是, <code>onEnd</code> 函数中<strong>不能</strong>使用协程函数, 如果你这么做了你会得到一个 <code>attempt to yield from outside a coroutine</code> 的报错,
+这是因为 <code>onBegin</code> 函数本身也是一个协程函数, 这才允许你在内部使用协程函数.</p>
+<h2 id="_8">其他函数</h2>
+<p>除了上述提到的 <code>say</code>, <code>getFlag</code>, <code>setFlag</code> 等外, 还有非常多预先定义好的函数, 你可以在下面这个链接中找到:<br />
+<a href="https://maddie480.ovh/lua-cutscenes-documentation/modules/helper_functions.html">Lua Cutscenes Documentaion - https://maddie480.ovh/...</a>  </p>
+<p>在上面这个文档中比如这个函数:</p>
+<table>
+<thead>
+<tr>
+<th>Function</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>helpers.die([direction={0, 0}[, evenIfInvincible=false[, registerDeathInStats=true]]])</td>
+<td>Kills the player.</td>
+</tr>
+</tbody>
+</table>
+<p>其中 helpers.die 说明这个函数名是 die, 后面圆括号围起来的表示它的参数, 一层层中括号围起来的表示可选参数,
+参数名后面加等于号表示该可选参数的默认值, 比如上述函数的调用可以有:</p>
+<table>
+<thead>
+<tr>
+<th>调用方式</th>
+<th>等效调用方式</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>die()</td>
+<td>die(vector2(0, 0), false, true)</td>
+</tr>
+<tr>
+<td>die(vector2(1, 1))</td>
+<td>die(vector2(1, 1), false, true)</td>
+</tr>
+<tr>
+<td>die(vector2(1, 1), true)</td>
+<td>die(vector2(1, 1), true, true)</td>
+</tr>
+<tr>
+<td>die(vector2(1, 1), true, false)</td>
+<td>die(vector2(1, 1), true, false)</td>
+</tr>
+</tbody>
+</table>
+<p>顺便, 其中第一个参数的类型是个 <code>Vector2</code>, 表示一个二维向量, 这种类型的值你可以调用 <code>vector2(1, 1)</code> 函数来从返回值得到,
+顾名思义它的第一个参数是 x 坐标, y 坐标. 这里它的含义是玩家死亡时的特效方向.</p>
+<h2 id="c">C# 交互</h2>
+<p>// TODO</p>
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var tab,labels=set.querySelector(".tabbed-labels");for(tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
+        </div>
+        
+      </main>
+      
+        <footer class="md-footer">
+    <div class="md-footer-meta md-typeset">
+        <div class="md-footer-meta__inner md-grid">
+            <div class="md-copyright">
+                Made with
+                <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+                    Material for MkDocs
+                </a>
+            </div>
+            <a href="https://icp.gov.moe/?keyword=20221437" class="md-copyright" target="_blank" rel="noopener">
+                萌ICP备20221437号
+            </a>
+        </div>
+    </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "..", "features": ["content.code.copy", "content.tabs.link"], "search": "../assets/javascripts/workers/search.f886a092.min.js", "translations": {"clipboard.copied": "\u5df2\u590d\u5236", "clipboard.copy": "\u590d\u5236", "search.result.more.one": "\u5728\u8be5\u9875\u4e0a\u8fd8\u6709 1 \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.more.other": "\u5728\u8be5\u9875\u4e0a\u8fd8\u6709 # \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.none": "\u6ca1\u6709\u627e\u5230\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.one": "\u627e\u5230 1 \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.other": "# \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.placeholder": "\u952e\u5165\u4ee5\u5f00\u59cb\u641c\u7d22", "search.result.term.missing": "\u7f3a\u5c11", "select.version": "\u9009\u62e9\u5f53\u524d\u7248\u672c"}}</script>
+    
+    
+      <script src="../assets/javascripts/bundle.aecac24b.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/extra_luacs/lua-in-vscode.png b/extra_luacs/lua-in-vscode.png
new file mode 100755
index 0000000000000000000000000000000000000000..793bc20f9e1ddf61b2cf21e217e2311aadc1defc
GIT binary patch
literal 52743
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
Hu0mjfseT~0

literal 0
HcmV?d00001

diff --git a/index.html b/index.html
index b27c4ac..6355e18 100755
--- a/index.html
+++ b/index.html
@@ -22,7 +22,7 @@
     
     
       
-        <title>蔚蓝Code Mod教程</title>
+        <title>Celeste Code Mod 教程</title>
       
     
     
@@ -85,7 +85,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="assets/images/favicon.png" alt="logo">
 
@@ -98,7 +98,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -188,12 +188,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -711,6 +711,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/other/xml-speedrun/index.html b/other/xml-speedrun/index.html
index 0aee54e..6cb3a19 100755
--- a/other/xml-speedrun/index.html
+++ b/other/xml-speedrun/index.html
@@ -16,13 +16,15 @@
         <link rel="prev" href="../../arc/sdk-styled-proj/">
       
       
+        <link rel="next" href="../../extra_luacs/">
+      
       
       <link rel="icon" href="../../assets/images/favicon.png">
       <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.4.6">
     
     
       
-        <title>XML简单介绍 - 蔚蓝Code Mod教程</title>
+        <title>XML简单介绍 - Celeste Code Mod 教程</title>
       
     
     
@@ -85,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -98,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -188,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -757,6 +759,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/search/search_index.json b/search/search_index.json
index 690a5fa..02d4003 100755
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\u200b\\u3000\\-\u3001\u3002\uff0c\uff0e\uff1f\uff01\uff1b]+","pipeline":["stemmer"]},"docs":[{"location":"","title":"\u9996\u9875","text":"<p>\u672c\u7cfb\u5217\u6559\u7a0b\u4e3b\u8981\u5199\u81ea\u4e8e\u4e2a\u4eba\u5728\u5236\u4f5c\u851a\u84dd CodeMod \u7684\u4e00\u4e9b\u7ecf\u9a8c \u672c\u7f51\u7ad9\u5185\u5bb9\u5f00\u6e90\u5728: github.com/Saplonily/CelesteModTourial \u5341\u5206\u6b22\u8fce\u6765\u63d0 pr \u548c issue \u4ee5\u4fee\u590d\u5404\u79cd\u8bed\u6cd5\u9519\u8bef, \u7528\u8bcd\u9519\u8bef\u548c\u5185\u5bb9\u9519\u8bef\u4ee5\u53ca\u5efa\u8bae_(:\u0437\u300d\u2220)_  </p> <p>\u5927\u90e8\u5206\u6587\u7ae0\u53ef\u80fd\u4f1a\u5199\u7684\u4e0d\u660e\u4e0d\u767d\u4ee5\u81f3\u4e8e\u9700\u8981\u9891\u7e41\u4fee\u6539, \u5982\u679c\u4f60\u6709\u66f4\u597d\u7684\u4fee\u6539\u5efa\u8bae\u7684\u8bdd\u6b22\u8fce\u6765\u63d0 issue.  </p> <p>\u90a3\u4e48\u4e00\u5207\u5c31\u7eea, \u53ef\u4ee5\u5f00\u59cb\u9605\u8bfb \u5165\u95e8-\u7b2c\u4e00\u8282 \u4e86:</p> <p>\u5f00\u59cb - Celeste Everest MonoMod</p> <p>\u6700\u540e, \u611f\u8c22\u4e00\u4e9b\u4e3a\u672c\u6559\u7a0b\u8d21\u732e\u7684\u4eba:</p> <ul> <li>Apple Sheep - \u5728\u5199\u4f5c\u521d\u671f\u63d0\u4f9b\u4e86\u5927\u91cf\u4fee\u6539\u5efa\u8bae (Bilibili)</li> <li>\u591c\u8c37\u7d2b\u5e7d - \u4e3a\u914d\u7f6e\u73af\u5883\u8282\u63d0\u4f9b\u4e86\u4f7f\u7528\u6a21\u677f\u7684\u5efa\u8bae (Bilibili)</li> <li>\u7535\u7bb1 - \u5236\u4f5c\u4e86\u5305\u542b\u57fa\u7840 Loenn \u4f7f\u7528\u6559\u7a0b\u7684\u4f5c\u56fe\u6559\u7a0b (Bilibili)</li> </ul> <p>\u4ee5\u53ca\u6211\u81ea\u5df1 :D</p> <ul> <li>Saplonily (Bilibili, Outlook)</li> </ul> <p>\u8bf4\u8d77\u6765\u56fd\u5185\u7684 coder \u770b\u8d77\u6765\u771f\u7684\u597d\u5c11\u54ce, \u6240\u4ee5\u8bf4\u5199\u8fd9\u4e2a\u6559\u7a0b\u53ef\u4ee5\u8ba4\u4e3a\u662f\u6211\u4e0d\u60f3\u5199\u7801\u60f3\u63a8\u7ed9\u522b\u4eba((</p> <p>\u5728\u7f51\u7ad9\u4e2d\u7684\u4ee3\u7801\u5757\u4e2d\u7684\u4e00\u4e9b\u9ad8\u4eae\u5728\u6a2a\u5411\u6eda\u52a8\u65f6\u4f1a\u53d1\u751f\u622a\u65ad, \u5373\u9ad8\u4eae\u5e76\u6ca1\u6709\u8986\u76d6\u6574\u884c, \u8fd9\u4e2a\u662f <code>mkdocs-material</code> \u81ea\u8eab\u7684 bug, \u800c\u4e14\u770b\u4e0a\u53bb\u8bf4\u662f\u4fee\u590d\u8d77\u6765\u5f88\u56f0\u96be, issue \u94fe\u63a5: mkdocs-material issue #452.  </p> <p>bug \u4e8e\u4e0b: <pre><code>t11ntpj808mbc1gu4lx7n9d8tj5q3ck3t1c0aclc    Liquorice oat cake carrot cake. Halvah lemon drops bear claw fruitcake. Marshmallow danish jelly-o toffee.\njqlksiohper0brg9x2ajcm7ajjf8ptjxprqstvda    Apple pie cake jelly-o sugar plum.\nx3mjly0wn48wy7lgf2bfymbykommv8dbyp7an1n8    Toffee candy brownie carrot cake jujubes sweet roll chocolate gingerbread.\nq0b5pj6eacuwj3t1i4jv7yxf00mi6osc0h5etcfz    Cupcake tiramisu danish brownie danish jujubes gingerbread toffee gummi bears.\nu25qzla31ahqxd2x6b2wgpbxvw88h5w6mujoqtuq    Fruitcake jelly beans candy canes icing pastry liquorice. Bear claw tart chocolate sweet souffl\u00e9 sweet roll marshmallow ice cream liquorice.\n9xcjy4nvh1jinka64lkdr1nhagm8odp0frr56nks    Bear claw tootsie roll toffee biscuit cotton candy macaroon. \n5rmcwguz3jzws8w1hh2jbfdau74jip3f8rbu10oy    Pudding caramels carrot cake sweet roll danish oat cake.\ns50wqctf9059ets5ezp4oeq7p6pfr24ntww2d15v    Oat cake macaroon pastry cheesecake. Dessert topping chocolate bar. \nvue3y73jcwsg5um4pw8aqhuv3njgtg9iq0ortx5p    Sesame snaps candy canes muffin lollipop wafer. \n1o6edje4xcb7vtcvct4ghawafdvmvgkx4r0scny5    Macaroon pudding gingerbread. \n</code></pre></p> <p>\u672c\u7cfb\u5217\u5185\u5bb9\u4f9d\u636eCC BY-SA 4.0\u8bb8\u53ef\u8bc1\u8fdb\u884c\u6388\u6743</p>"},{"location":"arc/basic_env/","title":"\u57fa\u7840\u73af\u5883\u914d\u7f6e - \u65e7","text":""},{"location":"arc/basic_env/#_1","title":"\u9879\u76ee\u521b\u5efa","text":"<p>\u5728vs\u521b\u5efa\u9879\u76ee\u9875\u9762\u4e2d\u6211\u4eec\u9700\u8981\u9009\u62e9\u8fd9\u4e2a:  </p> <p> \u6ce8\u610f\u8981\u9009\u5e26 <code>.NET Framework</code> \u5b57\u6837\u7684, \u851a\u84dd\u7684\u5e95\u5c42\u6846\u67b6\u76f8\u5bf9\u4e8e\u76ee\u524d\u7684 <code>.NET</code> \u5df2\u7ecf\u5f88\u53e4\u8001\u4e86, \u6240\u4ee5\u53ef\u80fd\u4f1a\u88ab\u7a0d\u5fae\u7279\u6b8a\u70b9\u5bf9\u5f85(, \u4e4b\u540e\u5728\u4e3a\u9879\u76ee\u547d\u540d\u7684\u7a97\u53e3\u4e2d\u7684\u9879\u76ee\u6846\u67b6\u8bb0\u5f97\u7cbe\u786e\u9009\u62e9 <code>.NET Framework 4.5.2</code>.  </p> <p> \u5982\u679c\u4f60\u6ca1\u6709 <code>.NET Framework 4.5.2</code> \u7684\u9009\u9879\u8bf7\u68c0\u67e5\u662f\u5426\u5b89\u88c5\u4e86\u6b64\u6846\u67b6, \u5e76\u4e14\u4f60\u9009\u62e9\u7684\u662f\u5e26 <code>.NET Framework</code> \u5b57\u6837\u7684\u7c7b\u5e93\u9879\u76ee.</p> <p>\u5f53\u4f60\u521b\u5efa\u5b8c\u9879\u76ee\u540e, \u4f60\u4f1a\u5f97\u5230\u4e00\u4e2a\u4ee3\u7801\u6587\u4ef6 <code>Class1.cs</code>, \u5b83\u770b\u8d77\u6765\u50cf: Class1.cs<pre><code>using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace MyCelesteMod\n{\n    public class Class1\n    {\n\n    }\n}\n</code></pre></p>"},{"location":"arc/basic_env/#_2","title":"\u6dfb\u52a0\u5bf9\u851a\u84dd\u7684\u5f15\u7528","text":"<p>\u56e0\u4e3a\u6211\u4eec\u662f\u851a\u84dd mod \u561b, \u6240\u4ee5\u80af\u5b9a\u5f97\u4f9d\u8d56\u4e00\u4e9b\u851a\u84dd\u7684\u4e1c\u897f, \u5373\u4f9d\u8d56\u4e8e\u851a\u84dd\u7684\u7a0b\u5e8f\u96c6. \u5177\u4f53\u64cd\u4f5c\u6765\u8bf4:</p> <ul> <li>\u5728\u89e3\u51b3\u65b9\u6848\u89c6\u56fe\u7a97\u53e3\u4f60\u7684\u9879\u76ee\u4e0b\u7684<code>\u5f15\u7528</code>\u4e0a\u53f3\u51fb</li> <li>\u9009\u62e9<code>\u6dfb\u52a0\u5f15\u7528</code></li> <li>\u5728\u65b0\u7684\u7a97\u53e3\u9009\u62e9\u5de6\u4fa7\u7684<code>\u6d4f\u89c8</code></li> <li>\u70b9\u51fb\u7a97\u53e3\u53f3\u4e0b\u89d2\u7684<code>\u6d4f\u89c8</code> </li> <li>\u5b8c\u6210\u540e\u5728\u5f39\u51fa\u7684\u6587\u4ef6\u9009\u62e9\u6846\u4e2d\u9009\u62e9\u4ee5\u4e0b\u51e0\u4e2a\u5728\u851a\u84dd\u6839\u76ee\u5f55\u4e0b\u7684\u6587\u4ef6:<ul> <li><code>Celeste.exe</code></li> <li><code>FNA.dll</code></li> <li><code>MMHOOK_Celeste.dll</code></li> <li><code>YamlDotNet.dll</code></li> </ul> </li> </ul> <p>\u5bf9\u4e8e steam \u7248\u851a\u84dd\u7684\u76ee\u5f55\u901a\u5e38\u4f1a\u5728 <code>C:\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste</code></p> <p>\u53e6\u5916\u4e3a\u4e86\u4fdd\u8bc1\u4f60\u7684 mod \u7684\u8de8\u5e73\u53f0\u6027, \u4f60\u7684\u5f15\u7528\u5217\u8868\u91cc <code>System</code> \u5f00\u5934\u7684\u53ea\u80fd\u5305\u542b:</p> <ul> <li><code>System</code></li> <li><code>System.Configuration</code></li> <li><code>System.Core</code></li> <li><code>System.Data</code></li> <li><code>System.Drawing</code></li> <li><code>System.Runtime.Serialization</code></li> <li><code>System.Security</code></li> <li><code>System.Xml</code></li> <li><code>System.Xml.Linq</code></li> </ul> <p>\u5982\u679c\u4f60\u7684\u9879\u76ee\u5f15\u7528\u6709\u5176\u4ed6 <code>System</code> \u5f00\u5934\u7cfb\u5217\u7684\u5f15\u7528, \u5e76\u4e14\u5b83\u4eec\u4e0d\u5728\u4e0a\u8ff0\u5217\u8868\u4e0a, \u4f60\u9700\u8981\u5c06\u5176\u79fb\u9664(\u53f3\u952e-&gt;\u79fb\u9664).</p>"},{"location":"arc/basic_env/#module","title":"\u6dfb\u52a0 Module \u7c7b","text":"<p>ok\u5728\u6211\u4eec\u4e00\u756a\u6298\u817e\u4e0b\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u5f00\u59cb\u6765\u5199\u4ee3\u7801\u4e86, \u90a3\u4e48\u9996\u5148\u628a\u4f60\u7684 <code>Class1.cs</code> \u91cd\u547d\u540d\u6210 <code>(\u4f60\u7684mod\u540d)Module.cs</code>, \u6bd4\u5982\u8fd9\u91cc\u6211\u7684 mod \u540d\u53eb <code>MyCelesteMod</code>, \u90a3\u4e48\u8fd9\u4e2a\u6587\u4ef6\u6700\u597d\u53eb\u505a <code>MyCelesteModModule.cs</code>, \u8fd9\u662f\u4e3a\u4e86\u65b9\u4fbf\u65e5\u540e\u5f00\u53d1\u80fd\u4e00\u773c\u8bc6\u522b\u51fa\u8fd9\u662f\u6211\u4eec\u6700\u65e9\u671f\u521b\u5efa\u7684\u90a3\u4e2a\u5173\u952e\u7c7b.</p> <p>\u5982\u679c\u4f60\u7684 vs \u63d0\u793a\u4f60\u662f\u5426\u91cd\u547d\u540d\u6807\u8bc6\u7b26, \u4f60\u53ef\u4ee5\u9009\u662f, \u8fd9\u6837\u90a3\u4e2a\u6587\u4ef6\u91cc\u7684 <code>Class1</code> \u7c7b\u540d\u4e5f\u4f1a\u5e2e\u4f60\u91cd\u547d\u540d</p> <p>\u90a3\u4e48\u540c\u6837\u5730\u5bf9\u8fd9\u4e2a\u6587\u4ef6\u91cc\u7684\u7c7b\u7684\u540d\u5b57\u4e5f\u91cd\u547d\u540d, \u7136\u540e\u6211\u4eec\u8ba9\u8fd9\u4e2a\u7c7b\u7ee7\u627f\u4e8e <code>EverestModule</code>.</p> <p>\u5982\u679c\u51fa\u73b0\u4e86\u672a\u547d\u540d\u6807\u8bc6\u7b26\u7684\u9519\u8bef, \u8bf7\u68c0\u67e5\u4f60\u662f\u5426\u6b63\u786e\u5f15\u7528\u4e86 <code>Celeste.exe</code> \u5e76\u4e14 using \u4e86 <code>Celeste.Mod</code> \u547d\u540d\u7a7a\u95f4</p> <p><code>EverestModule</code> \u662f\u4e00\u4e2a\u62bd\u8c61\u7c7b ,\u90a3\u4e48\u73b0\u5728\u6211\u4eec\u9700\u8981\u52a0\u5165\u4e24\u4e2a\u65b9\u6cd5\u4ee5\u5b9e\u73b0\u5b83, \u540c\u65f6\u8ba9vs\u95ed\u5634. MyCelesteMod.cs<pre><code>public override void Load()\n{\n}\n\npublic override void Unload()\n{\n}\n</code></pre></p> <p><code>Load</code> \u65b9\u6cd5\u4f1a\u5728 Everest \u52a0\u8f7d\u4f60\u7684 Mod \u65f6\u88ab\u8c03\u7528 <code>Unload</code> \u65b9\u6cd5\u4f1a\u5728 Everest \u5378\u8f7d\u4f60\u7684 Mod \u65f6\u88ab\u8c03\u7528 \u5728\u8fd9\u91cc\u6211\u4eec\u4f1a\u5199\u4e2a\u7c7b\u4f3c Hello world \u7684\u4e1c\u897f, \u5373\u5728 <code>Load</code> \u91cc\u6253\u5370\u4e9b\u8bdd. em, \u53ef\u80fd\u4e0d\u662f\u4f60\u671f\u671b\u7684 <code>Console.WriteLine</code> \u800c\u662f <code>Logger.Log</code>, \u5c31\u50cf\u8fd9\u6837:</p> <pre><code>Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World! Hello Everest!\");\n</code></pre> <p>\u8fd9\u662f\u4e00\u4e2a\u851a\u84dd\u5e95\u5c42\u6846\u67b6 <code>Monocle</code> \u5f15\u64ce\u91cc\u7684\u4e00\u4e2a\u9759\u6001\u7c7b, \u5728\u4e4b\u540e\u6211\u4eec\u4f1a\u4ecb\u7ecd\u851a\u84dd\u4e2d\u5e38\u89c1\u7c7b\u7684\u4f7f\u7528. \u4e0b\u9762\u662f\u8fd9\u4e2a\u65b9\u6cd5\u7684\u53c2\u6570\u5217\u8868:</p> <ul> <li>\u7b2c\u4e00\u4e2a\u53c2\u6570: \u8fd9\u53e5\u65e5\u5fd7\u7684\u7b49\u7ea7, \u8fd9\u91cc\u6211\u4eec\u5148\u9009 <code>Info</code>.</li> <li>\u7b2c\u4e8c\u4e2a\u53c2\u6570: \u8fd9\u53e5\u65e5\u5fd7\u7684 <code>Tag</code>, \u901a\u5e38\u5b83\u662f\u4f60\u7684 Mod \u540d\u5b57</li> <li>\u7b2c\u4e09\u4e2a\u53c2\u6570: \u6211\u4eec\u5e0c\u671b\u8f93\u51fa\u7684\u8bdd</li> </ul> <p>\u90a3\u4e48\u4f60\u73b0\u5728\u7684\u4ee3\u7801\u5e94\u8be5\u662f\u5927\u6982\u8fd9\u6837\u5b50\u7684: MyCelesteMod.cs<pre><code>using Celeste.Mod;\nusing System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace MyCelesteMod\n{\n    public class MyModModule : EverestModule\n    {\n        public override void Load()\n        {\n            Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World! Hello Everest!\");\n        }\n\n        public override void Unload()\n        {\n\n        }\n    }\n}\n</code></pre></p> <p>\u73b0\u5728, \u6309\u4e0b <code>Ctrl + B</code>, vs \u5e94\u8be5\u4f1a\u542f\u52a8\u7f16\u8bd1.</p> <p>\u4f60\u4f1a\u9047\u5230\u4e00\u4e2a\u5173\u4e8e <code>x86</code> \u4e0e <code>AnyCpu</code> \u67b6\u6784\u4e0d\u7b26\u7684\u8b66\u544a, \u8fd9\u91cc\u6211\u4eec\u5148\u5ffd\u7565\u5b83\u5e76\u5728\u540e\u9762\u89e3\u51b3.</p> <p>\u7f16\u8bd1\u5b8c\u6210, \u6211\u4eec\u5c31\u53ef\u4ee5\u627e\u5230\u6211\u4eec\u7f16\u8bd1\u51fa\u6765\u7684\u65b0\u9c9c\u7684\u7a0b\u5e8f\u96c6: <code>&lt;\u4f60\u7684\u9879\u76ee\u540d&gt;/&lt;\u4f60\u7684\u9879\u76ee\u540d&gt;/bin/Debug/&lt;\u4f60\u7684\u9879\u76ee\u540d&gt;.dll</code>, \u4f60\u7684 vs \u7684\u8f93\u51fa\u7a97\u53e3\u4e5f\u5e94\u8be5\u4f1a\u5199\u4e0a\u8fd9\u4e2a dll \u7684\u5b8c\u6574\u8def\u5f84.</p>"},{"location":"arc/basic_env/#everest","title":"\u8ba9 Everest \u52a0\u8f7d","text":"<p>\u4ee5\u4e0a\u4e00\u987f\u64cd\u4f5c\u8fc7\u540e\u4f60\u4f1a\u53d1\u73b0\u4f60\u7684\u851a\u84dd\u4ec0\u4e48\u4e5f\u6ca1\u53d1\u751f(\u4e50). \u56e0\u4e3a\u6211\u4eec\u8fd8\u6ca1\u544a\u8bc9\u5b83\u8ba9\u5b83\u52a0\u8f7d\u6211\u4eec\u7684 mod! \u4e3a\u4e86\u8ba9 Everest \u52a0\u8f7d\u6211\u4eec\u7684 mod, \u5176\u4e2d\u4e00\u4e2a\u65b9\u6cd5\u5c31\u662f\u5728\u851a\u84dd\u7684 Mods \u6587\u4ef6\u5939\u91cc\u9762\u65b0\u5efa\u4e00\u4e2a\u6587\u4ef6\u5939, \u5e76\u653e\u5165\u6211\u4eec\u7684 mod \u6587\u4ef6, \u5b83\u7684\u540d\u5b57\u6211\u4eec\u6700\u597d\u5c31\u662f\u9879\u76ee\u540d\u5b57, \u6bd4\u5982 <code>MyCelesteMod</code>, \u7136\u540e\u5728\u8fd9\u91cc\u5199\u4e00\u4efd <code>everest.yaml</code> \u6587\u4ef6, \u5b83\u5305\u542b\u6211\u4eec mod \u7684\u4e00\u4e9b\u57fa\u672c\u4fe1\u606f: everest.yaml<pre><code>- Name: &lt;mod\u540d\u5b57&gt;\nVersion: &lt;\u7248\u672c&gt;\nDLL: &lt;dll\u4f4d\u7f6e&gt;\nDependencies:\n    - Name: Everest\n    Version: &lt;\u4f9d\u8d56\u7684 everest \u7248\u672c&gt;\n</code></pre> ok, \u6211\u4eec\u6765\u6162\u6162\u586b\u8fd9\u4e9b\u4e1c\u897f - <code>mod\u540d\u5b57</code>: \u63a8\u8350\u4e3a\u9879\u76ee\u540d\u6bd4\u5982 <code>MyCelesteMod</code> - <code>\u7248\u672c</code>: \u7531\u4e8e\u662f\u5f00\u53d1\u65e9\u671f, \u6240\u4ee5\u7248\u672c\u63a8\u8350\u6307\u5b9a\u4e3a0\u5f00\u5934\u7684 <code>0.1.0</code> - <code>\u4f9d\u8d56\u7684 everest \u7248\u672c</code>: \u8fd9\u91cc\u586b\u4f60\u7684 everest \u7248\u672c\u5c31\u884c\u4e86, \u6bd4\u5982\u8bf4\u5982\u679c\u4f60\u662f 3876 \u90a3\u4e48\u8fd9\u91cc\u5e94\u8be5\u5199 <code>1.3876.0</code> - <code>Dll \u4f4d\u7f6e</code>: \u6211\u4eec\u5148\u628a\u4e4b\u524d\u7f16\u8bd1\u7684\u65b0\u9c9c(\u53ef\u80fd\u73b0\u5728\u4e0d\u548b\u65b0\u9c9c\u4e86)\u7684 dll \u590d\u5236\u5230\u8fd9\u4e2a\u6587\u4ef6\u5939\u6765, \u6ca1\u8bb0\u9519\u7684\u8bdd\u5728\u8fd9\u91cc\u53eb <code>MyCelesteMod.dll</code>, ok, <code>everest.yaml</code> \u91cc\u8981\u5199\u7684 dll \u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u8fd9\u4e2a\u6587\u4ef6\u5939\u7684, \u6211\u4eec\u5c31\u653e\u5728\u5b83\u91cc\u9762\u7b2c\u4e00\u5c42, \u6240\u4ee5\u6211\u4eec\u76f4\u63a5\u5199 <code>MyCelesteMod.dll</code> \u5c31\u884c\u4e86.</p> <p>\u73b0\u5728\u4f60\u7684\u90a3\u4e2a\u6587\u4ef6\u5939\u73b0\u5728\u53ef\u80fd\u957f\u8fd9\u4e2a\u6837\u5b50:</p> <ul> <li>MyCelesteMod<ul> <li>MyCelesteMod.dll</li> <li>everest.yaml</li> </ul> </li> </ul> <p>everest.yaml\u53ef\u80fd\u957f\u8fd9\u4e2a\u6837\u5b50: everest.yaml<pre><code>- Name: MyCelesteMod\nVersion: 0.1.0\nDLL: MyCelesteMod.dll\nDependencies:\n    - Name: Everest\n    Version: 1.3876.0\n</code></pre></p> <p>ok, \u5728\u542f\u52a8\u4e4b\u524d\u6211\u4eec\u8fd8\u8981\u5e72\u6700\u540e\u4e00\u4ef6\u5c0f\u4e8b, \u5c31\u662f\u6211\u4eec\u7684\u65e5\u5fd7, \u5b83\u6253\u5370\u5728\u6587\u4ef6\u91cc\u540c\u65f6\u4e5f\u6253\u5370\u5728\u63a7\u5236\u53f0\u91cc, \u65e5\u5fd7\u6587\u4ef6\u7ffb\u9605\u6bd4\u8f83\u9ebb\u70e6, \u6240\u4ee5\u4e3a\u4e86\u65e5\u540e\u65b9\u4fbf\u8c03\u8bd5, \u6211\u4eec\u8fd8\u662f\u5148\u8ba9\u851a\u84dd\u542f\u52a8\u7684\u540c\u65f6\u542f\u52a8\u4e00\u4e2a\u63a7\u5236\u53f0\u597d\u4e00\u70b9. Everest \u5df2\u7ecf\u4e3a\u6211\u4eec\u505a\u4e86\u8fd9\u4ef6\u4e8b\u4e86, \u6211\u4eec\u8981\u505a\u7684\u53ea\u662f\u5728\u851a\u84ddexe\u540c\u76ee\u5f55\u4e0b\u627e\u5230<code>everest-launch.txt</code>, \u6ca1\u627e\u5230\u4e5f\u6ca1\u5173\u7cfb, \u65b0\u5efa\u4e00\u4e2a\u5c31\u53ef\u4ee5\u4e86, \u7136\u540e\u5728\u91cc\u9762\u5199\u4e0a<code>--console</code>, \u662f\u7684\u5c31\u8fd9\u4e00\u5c0f\u70b9\u4e1c\u897f, \u7136\u540e\u6211\u4eec\u4fdd\u5b58, \u542f\u52a8\u851a\u84dd!</p> <p>\u542f\u52a8\u540e\u4f60\u5e94\u8be5\u4f1a\u540c\u65f6\u770b\u5230\u4e00\u4e2a\u63a7\u5236\u53f0\u7a97\u53e3, \u626b\u89c6\u4e00\u4e0b: console output<pre><code>[MonoMod] [AutoPatch] Patch pass\n[MonoMod] [AutoPatch] PatchRefs pass\n[MonoMod] [PostProcessor] PostProcessor pass #1\n[MonoMod] [Write] Writing modded module into output file.\n(07/05/2023 23:22:16) [Everest] [Info] [MyCelesteMod] Hello World! Hello Everest!\n(07/05/2023 23:22:16) [Everest] [Info] [core] Module MyCelesteMod 0.1.0 registered.\n(07/05/2023 23:22:16) [Everest] [Info] [loader] Loading mods with unsatisfied optional dependencies (if any)\nFNA3D Driver: D3D11\nD3D11 Adapter: Intel(R) UHD Graphics 630\nBEGIN LOAD\n- GFX LOAD: 139ms\n- MTN LOAD: 9ms\nWINDOW-1600x900\nGAME DISPLAYED (in 291ms)\n- AUDIO LOAD: 454ms\n- GFX DATA LOAD: 75ms\n</code></pre> \u5927\u6982\u5728\u5982\u4e0a\u7684\u4f4d\u7f6e\u9644\u8fd1(\u5728\u8fd9\u91cc\u662f\u7b2c5\u884c)\u4f60\u5c31\u80fd\u627e\u5230\u4f60\u7684 Hello world \u4e86, \u81f3\u6b64\u57fa\u672c\u73af\u5883\u914d\u7f6e\u7ed3\u675f.</p>"},{"location":"arc/sdk-styled-proj/","title":"\u504f\u597d - sdk-styled csproj","text":""},{"location":"arc/sdk-styled-proj/#sdk-style-csproj","title":"Sdk-style csproj","text":"<p>\u73b0\u5728\u6253\u5f00\u4f60\u7684\u9879\u76ee\u76ee\u5f55\u4e2d\u7684 <code>.csproj</code> \u6587\u4ef6(\u901a\u5e38\u4e5f\u4f1a\u88ab\u53eb\u4f5c*\u9879\u76ee\u6587\u4ef6*), \u5b83\u7528\u4e8e\u7ec4\u7ec7\u63cf\u8ff0\u4f60\u7684\u9879\u76ee\u662f\u4ec0\u4e48\u6837\u5b50\u7684, \u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u975e\u5e38\u7684\u6742\u4e71\u4e0d\u53ef\u8bfb, \u5c31\u50cf:</p> .csproj<pre><code>&lt;?xml version=\"1.0\" encoding=\"utf-8\"?&gt;\n&lt;Project ToolsVersion=\"15.0\" xmlns=\"http://schemas.microsoft.com/developer/msbuild/2003\"&gt;\n  &lt;Import Project=\"$(MSBuildExtensionsPath)\\$(MSBuildToolsVersion)\\Microsoft.Common.props\" Condition=\"Exists('$(MSBuildExtensionsPath)\\$(MSBuildToolsVersion)\\Microsoft.Common.props')\" /&gt;\n  &lt;PropertyGroup&gt;\n    &lt;Configuration Condition=\" '$(Configuration)' == '' \"&gt;Debug&lt;/Configuration&gt;\n    &lt;Platform Condition=\" '$(Platform)' == '' \"&gt;AnyCPU&lt;/Platform&gt;\n    &lt;ProjectGuid&gt;{100E625E-04C6-434F-865C-3E6E50A379B5}&lt;/ProjectGuid&gt;\n    &lt;OutputType&gt;Library&lt;/OutputType&gt;\n    &lt;AppDesignerFolder&gt;Properties&lt;/AppDesignerFolder&gt;\n    &lt;RootNamespace&gt;MyCelesteMod&lt;/RootNamespace&gt;\n    &lt;AssemblyName&gt;MyCelesteMod&lt;/AssemblyName&gt;\n    &lt;TargetFrameworkVersion&gt;v4.5.2&lt;/TargetFrameworkVersion&gt;\n    &lt;FileAlignment&gt;512&lt;/FileAlignment&gt;\n    &lt;Deterministic&gt;true&lt;/Deterministic&gt;\n  &lt;/PropertyGroup&gt;\n  &lt;PropertyGroup Condition=\" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' \"&gt;\n    &lt;DebugSymbols&gt;true&lt;/DebugSymbols&gt;\n    &lt;DebugType&gt;full&lt;/DebugType&gt;\n    &lt;Optimize&gt;false&lt;/Optimize&gt;\n    &lt;OutputPath&gt;bin\\Debug\\&lt;/OutputPath&gt;\n    &lt;DefineConstants&gt;DEBUG;TRACE&lt;/DefineConstants&gt;\n    &lt;ErrorReport&gt;prompt&lt;/ErrorReport&gt;\n    &lt;WarningLevel&gt;4&lt;/WarningLevel&gt;\n  &lt;/PropertyGroup&gt;\n  &lt;PropertyGroup Condition=\" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' \"&gt;\n    &lt;DebugType&gt;pdbonly&lt;/DebugType&gt;\n    &lt;Optimize&gt;true&lt;/Optimize&gt;\n    &lt;OutputPath&gt;bin\\Release\\&lt;/OutputPath&gt;\n    &lt;DefineConstants&gt;TRACE&lt;/DefineConstants&gt;\n    &lt;ErrorReport&gt;prompt&lt;/ErrorReport&gt;\n    &lt;WarningLevel&gt;4&lt;/WarningLevel&gt;\n  &lt;/PropertyGroup&gt;\n  &lt;ItemGroup&gt;\n    &lt;Reference Include=\"Celeste\"&gt;\n      &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\Celeste.exe&lt;/HintPath&gt;\n    &lt;/Reference&gt;\n    &lt;Reference Include=\"FNA\"&gt;\n      &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\FNA.dll&lt;/HintPath&gt;\n    &lt;/Reference&gt;\n    &lt;Reference Include=\"MMHOOK_Celeste\"&gt;\n      &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\MMHOOK_Celeste.dll&lt;/HintPath&gt;\n    &lt;/Reference&gt;\n    &lt;Reference Include=\"YamlDotNet\"&gt;\n      &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\YamlDotNet.dll&lt;/HintPath&gt;\n    &lt;/Reference&gt;\n    &lt;Reference Include=\"System\" /&gt;\n    &lt;Reference Include=\"System.Core\" /&gt;\n    &lt;Reference Include=\"System.Xml.Linq\" /&gt;\n    &lt;Reference Include=\"Microsoft.CSharp\" /&gt;\n    &lt;Reference Include=\"System.Xml\" /&gt;\n  &lt;/ItemGroup&gt;\n  &lt;ItemGroup&gt;\n    &lt;Compile Include=\"MyModModule.cs\" /&gt;\n    &lt;Compile Include=\"Properties\\AssemblyInfo.cs\" /&gt;\n  &lt;/ItemGroup&gt;\n  &lt;Import Project=\"$(MSBuildToolsPath)\\Microsoft.CSharp.targets\" /&gt;\n&lt;/Project&gt;\n</code></pre> <p>Note</p> <p>\u5bf9\u4e8e\u6b64\u90e8\u5206\u7684\u5185\u5bb9\u4f60\u53ef\u80fd\u9700\u8981\u9605\u8bfb\u4e86\u89e3\u4e00\u4e0b <code>XML</code> \u683c\u5f0f\u6587\u4ef6</p> <p>\u5b9e\u9645\u4e0a\u5bf9\u4e8e\u6211\u4eec\u771f\u6b63\u7ecf\u5e38\u4fee\u6539\u7684\u5c5e\u6027\u53ea\u6709\u4e0a\u9762\u6807\u4eae\u7684\u884c, \u90a3\u4e48\u5982\u679c\u8fd9\u65f6\u5019\u4f7f\u7528 <code>Sdk-style csproj</code> \u4f1a\u597d\u5f88\u591a, \u5b83\u770b\u4e0a\u53bb\u662f\u8fd9\u6837\u7684:</p> Sdk-style csproj<pre><code>&lt;Project Sdk=\"Microsoft.NET.Sdk\"&gt;\n\n    &lt;PropertyGroup&gt;\n        &lt;OutputType&gt;Library&lt;/OutputType&gt;\n        &lt;RootNamespace&gt;MyCelesteMod&lt;/RootNamespace&gt;\n        &lt;AssemblyName&gt;MyCelesteMod&lt;/AssemblyName&gt;\n        &lt;TargetFramework&gt;net452&lt;/TargetFramework&gt;\n    &lt;/PropertyGroup&gt;\n\n    &lt;ItemGroup&gt;\n        &lt;Reference Include=\"Celeste\"&gt;\n            &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\Celeste.exe&lt;/HintPath&gt;\n        &lt;/Reference&gt;\n        &lt;Reference Include=\"FNA\"&gt;\n            &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\FNA.dll&lt;/HintPath&gt;\n        &lt;/Reference&gt;\n        &lt;Reference Include=\"MMHOOK_Celeste\"&gt;\n            &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\MMHOOK_Celeste.dll&lt;/HintPath&gt;\n        &lt;/Reference&gt;\n        &lt;Reference Include=\"YamlDotNet\"&gt;\n            &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\YamlDotNet.dll&lt;/HintPath&gt;\n        &lt;/Reference&gt;\n        &lt;Reference Include=\"System\" /&gt;\n        &lt;Reference Include=\"System.Core\" /&gt;\n        &lt;Reference Include=\"System.Xml.Linq\" /&gt;\n        &lt;Reference Include=\"Microsoft.CSharp\" /&gt;\n        &lt;Reference Include=\"System.Xml\" /&gt;\n    &lt;/ItemGroup&gt;\n\n&lt;/Project&gt;\n</code></pre> <p>\u4f60\u4f1a\u53d1\u73b0\u5176\u5b9e\u8fd9\u91cc\u53ea\u7559\u4e0b\u4e86\u6211\u4eec\u4e0a\u9762\u6807\u9ec4\u7684\u4e1c\u897f, \u662f\u7684, \u8fd9\u5c31\u662f <code>Sdk-style csproj</code> \u7684\u4f18\u70b9. \u8fc1\u79fb\u81f3 <code>Sdk-style csproj</code> \u975e\u5e38\u7b80\u5355, \u4f60\u53ea\u9700\u8981:</p> <ul> <li>\u5220\u9664 <code>PropertyGroup</code> \u548c <code>ItemGroup</code> \u53ca\u65c1\u8fb9\u7684\u975e\u6807\u9ec4\u8282\u70b9</li> <li>\u5220\u9664 <code>Project</code> \u8282\u70b9\u4e0b\u7684\u4e24\u4e2a <code>Import</code></li> <li>\u5220\u9664 <code>Project</code> \u8282\u70b9\u7684\u6240\u6709\u5c5e\u6027</li> <li>\u91cd\u65b0\u5728 <code>Project</code> \u8282\u70b9\u4e0a\u52a0\u5165\u5c5e\u6027: <code>Sdk = \"Microsoft.NET.Sdk\"</code></li> <li><code>TargetFrameworkVersion</code> \u66f4\u6539\u4e3a\u65b0\u7248\u7684 <code>TargetFramework</code>, <code>v4.5.2</code> \u66f4\u6539\u4e3a <code>net452</code></li> </ul> <p>Note</p> <p>\u4e0d\u7528\u62c5\u5fc3\u5220\u6389\u8fd9\u4e48\u591a\u4e1c\u897f\u4f1a\u51fa\u73b0\u95ee\u9898, \u5b9e\u9645\u4e0a\u6211\u4eec\u5220\u6389\u7684\u4e1c\u897f\u53ea\u662f\u5408\u5e76\u5165 <code>Sdk = \"Microsoft.NET.Sdk\"</code> \u8fd9\u4e00\u53e5\u4e86\u800c\u5df2</p> <p>\u8fd9\u4e2a\u65f6\u5019\u6574\u4e2a\u6587\u4ef6\u6e05\u6670\u53ef\u8bfb:</p> <ul> <li>\u6839\u8282\u70b9\u7684 <code>Project</code> \u4e0b\u6302\u8f7d\u7740 <code>PropertyGroup</code> \u4ee5\u53ca <code>ItemGroup</code>,</li> <li><code>PropertyGroup</code> \u63cf\u8ff0\u4e86\u6211\u4eec\u9879\u76ee\u7684\u4e00\u4e9b\u901a\u7528\u5c5e\u6027, \u6bd4\u5982\u8f93\u51fa\u7c7b\u578b, \u547d\u540d\u7a7a\u95f4, \u7a0b\u5e8f\u96c6\u6635\u79f0\u4ee5\u53ca\u9879\u76ee\u6846\u67b6\u7248\u672c,</li> <li><code>ItemGroup</code> \u5219\u63cf\u8ff0\u4e86\u6211\u4eec\u9879\u76ee\u4e2d\u7684\u4e00\u4e9b\u5f15\u7528\u7b49.</li> </ul> <p>\u5728\u8fd9\u91cc\u63d0\u53ca\u8fd9\u4e2a\u662f\u56e0\u4e3a\u5728\u540e\u9762\u90e8\u5206\u6211\u4eec\u4f1a\u9700\u8981\u4fee\u6539 <code>.csproj</code> \u6587\u4ef6, \u901a\u8fc7\u5bf9\u6bd4\u4f60\u53ef\u4ee5\u53d1\u73b0\u8fd9\u4e24\u4e2a xml \u6587\u4ef6\u90fd\u6709 <code>PropertyGroup</code> \u548c <code>ItemGroup</code> \u8282\u70b9 (\u5982\u679c\u6709\u591a\u4e2a\u8282\u70b9\u7684\u8bdd, \u4efb\u610f\u4e00\u4e2a\u90fd\u884c), \u6240\u4ee5\u6211\u4eec\u4e4b\u540e\u5bf9\u9879\u76ee\u6587\u4ef6\u7684\u4fee\u6539\u7684\u63cf\u8ff0\u90fd\u4f1a\u57fa\u4e8e\u8fd9\u4e24\u4e2a\u8282\u70b9.</p> <p>Warning</p> <p>\u8bb0\u5f97\u5220\u9664 <code>Properties</code> \u6587\u4ef6\u5939\u91cc\u7684 cs \u6587\u4ef6, \u5b83\u53ef\u80fd\u4f1a\u4e0e sdk-styled csproj \u81ea\u52a8\u751f\u6210\u7684\u6587\u4ef6\u76f8\u51b2\u7a81</p>"},{"location":"begin/basic_env/","title":"\u57fa\u7840\u73af\u5883\u914d\u7f6e","text":"<p>Note</p> <p>\u672c\u8282\u5185\u5bb9\u7531\u624b\u52a8\u914d\u7f6e\u91cd\u5199\u4e3a\u901a\u8fc7\u6a21\u677f\u914d\u7f6e, \u65e7\u7248\u4f60\u53ef\u4ee5\u5230\u5f52\u6863-\u57fa\u7840\u73af\u5883\u914d\u7f6e\u4e2d\u627e\u5230(\u4e0d\u63a8\u8350)</p>"},{"location":"begin/basic_env/#celeste","title":"Celeste","text":"<p>Note</p> <p>\u5982\u679c\u4f60\u4e0d\u662f Windows \u7528\u6237\u7684\u8bdd\u8fd9\u4e00\u6b65\u4f60\u53ef\u4ee5\u76f4\u63a5\u8df3\u8fc7.</p> <p>Everest \u9700\u6c42\u6211\u4eec\u4f7f\u7528 FNA \u7248\u672c\u7684\u851a\u84dd, \u800c Linux \u548c MacOS \u4e0a\u7684\u851a\u84dd\u5df2\u7ecf\u5c31\u662f FNA \u7248\u672c\u4e86, \u800c\u5728 Windows \u4e0a\u5219\u662f XNA \u7248\u672c, \u6240\u4ee5\u6211\u4eec\u9700\u8981\u4e00\u4e9b\u65b9\u6cd5\u5207\u6362\u5230 FNA \u7248\u672c:</p> <ul> <li>\u5728 Steam \u4e0a:  \u5e93-&gt;Celeste, \u53f3\u952e\u83dc\u5355\u5c5e\u6027-&gt;\u6d4b\u8bd5\u7248-&gt;Opengl</li> <li>\u5728 itch \u4e0a: \u91cd\u65b0\u4e0b\u8f7d\u4e00\u4e2a <code>Celeste Windows OpenGL</code> \u7248\u672c</li> <li>\u5728 Epic \u4e0a: \u5df2\u7ecf\u662f FNA \u7248\u672c\u4e86</li> </ul> <p>Note</p> <p>Everest \u4f1a\u5728\u8fd0\u884c\u65f6\u5c06\u4f60\u4ee5 FNA \u7248\u672c\u5236\u4f5c\u7684 mod \u91cd\u94fe\u63a5\u4e3a XNA, \u6240\u6709\u4f60\u4e0d\u662f\u5f88\u9700\u8981\u5728\u610f\u8fd9\u4fe9\u7684\u5dee\u8ddd \u6ce8\u610f\u66f4\u6362\u7248\u672c\u540e\u901a\u5e38\u4f1a\u53d8\u56de\u539f\u7248, \u8bb0\u5f97\u91cd\u65b0\u5b89\u88c5 Everest</p>"},{"location":"begin/basic_env/#c","title":"C# \u7f16\u7a0b\u80fd\u529b \u4e0e \u5f00\u53d1\u73af\u5883","text":"<p>\u56e0\u4e3a\u6211\u4eec\u662f CodeMod, \u55ef, \u90a3\u4e48\u5199\u4e00\u4e9b\u4ee3\u7801\u662f\u5fc5\u4e0d\u53ef\u5c11\u7684, \u851a\u84dd\u662f\u4f7f\u7528 <code>C#</code> \u57fa\u4e8e <code>.NET framework 4.5.2</code> \u6765\u5236\u4f5c\u7684, \u90a3\u4e48\u5b66\u4e60 <code>C#</code> \u5f53\u7136\u662f\u5fc5\u4e0d\u53ef\u5c11\u7684.</p> <p>Info</p> <p>\u7406\u8bba\u4e0a\u6240\u6709 .NET \u7cfb\u8bed\u8a00\u6bd4\u5982 <code>VB.NET</code> <code>F#</code> \u90fd\u53ef\u4ee5, \u4e0d\u8fc7\u4e3a\u4e86\u65b9\u4fbf\u8d77\u89c1\u6211\u4eec\u8fd8\u662f\u4f7f\u7528 C#.</p> <p>\u597d\u5427\u8fd9\u53e5\u8bdd\u53ef\u80fd\u8bf4\u7684\u592a\u5e73\u6de1\u4e86(wuwu), \u6bd5\u7adf\u5927\u90e8\u5206\u851a\u6279\u851a\u84dd mod \u7231\u597d\u8005\u5c31\u662f\u88ab\u8fd9\u4e00\u6b65\u5361\u4f4f\u7684, \u90a3\u4e48\u8fd9\u91cc...\u53ea\u80fd\u7ed9\u4f60\u63a8\u8350\u51e0\u4e2a\u5b66\u4e60\u6e20\u9053\u4e86, \u6bd5\u7adf\u5728\u8fd9\u91cc\u6ca1\u5fc5\u8981\u8ba9\u8fd9\u4e2a\u6559\u7a0b\u8fc7\u4e8e\u5168\u80fd.</p> <ol> <li>\u89c6\u9891: Bilibili - \u4e11\u840c\u6c14\u8d28\u72d7 - \u3010C#\u96f6\u57fa\u7840\u5165\u95e8\u6559\u7a0b Visual Studio 2022\u3011\u4eba\u751f\u4f4e\u8c37\u6765\u5b66C# (\u5168p, \u7a0d\u5fae\u4e0d\u5168)</li> <li>\u89c6\u9891: Bilibili - C#\u4ece\u5165\u95e8\u5230\u7cbe\u901a\uff08\u7b2c5\u7248\uff09 (1-71p, 109-132p)</li> <li>\u89c6\u9891: Bilibili - \u5218\u94c1\u731b - C#\u8bed\u8a00\u5165\u95e8\u8be6\u89e3-\u7b2c1\u5b63-\u526a\u8f91\u7248-\u516833\u8bfe-\u5206154\u96c6 (1-152p)</li> <li>\u7f51\u7ad9: Runnob - C# \u6559\u7a0b</li> <li>\u7f51\u7ad9: w3schools - C# \u6559\u7a0b (\u82f1\u6587)</li> <li>\u4e66\u7c4d: C#\u5165\u95e8\u7ecf\u5178-\u7b2c7\u7248-C# 6.0</li> </ol> <p>Info</p> <p>\u5982\u679c\u4f60\u6ca1\u6709\u80fd\u529b\u652f\u6301\u6b63\u7248\u4e66\u7c4d\u7684\u8bdd, \u4f60\u53ef\u4ee5\u5230\u4e00\u4e9b C# \u5f00\u53d1\u8005\u7fa4\u5185\u5bfb\u627e\u5b83\u7684\u7535\u5b50\u975e\u6b63\u7248(\u6bd4\u5982\u89c6\u9891 <code>1.</code> up \u7684\u7fa4\u5185) \u4e0a\u9762\u51e0\u4e2a\u6211\u66f4\u52a0\u63a8\u8350\u7684\u662f <code>1.</code> \u548c <code>3.</code> \u501f\u7528 <code>4.</code> \u7684\u76ee\u5f55, \u786e\u4fdd\u4f60\u5bf9\u4e0b\u9762\u8fd9\u4e9b\u6982\u5ff5(\u753b \u00d7 \u7684\u6682\u65f6\u5728\u851a\u84dd CodeMod \u4e2d\u7528\u4e0d\u5230)\u6709\u8db3\u591f\u6e05\u6670\u7684\u4e86\u89e3\u5728\u5f00\u59cb\u4f60\u7684\u851a\u84dd CodeMod \u4e4b\u65c5\u4e4b\u524d: </p> <p>\u76f8\u4fe1\u5728\u4e0a\u9762\u7684\u6559\u7a0b\u4e2d\u4f60\u5e94\u8be5\u5df2\u7ecf\u88ab\u63a8\u8350\u4e86\u4e00\u4e9b\u7f16\u8f91\u5668/IDE, \u90a3\u4e48\u5728\u672c\u6559\u7a0b\u4e2d\u6211\u4e2a\u4eba\u4f1a\u4e3a\u4e86\u65b9\u4fbf\u4ec5\u5728 <code>Windows</code> \u4e0a\u4f7f\u7528 <code>Visual Studio</code>, \u90a3\u4f60\u9047\u5230\u4e86\u4ec0\u4e48\u5947\u602a\u7684\u95ee\u9898\u53ef\u4ee5\u5230\u4efb\u4f55\u80fd\u8054\u7cfb\u5230\u6211\u7684\u5730\u65b9\u95ee\u6211_(:\u0437\u300d\u2220)_</p>"},{"location":"begin/basic_env/#_2","title":"\u901a\u8fc7\u6a21\u677f\u521b\u5efa\u9879\u76ee","text":"<p>_(:\u0437\u300d\u2220)_ \u6839\u636e\u4e00\u4e9b\u53cd\u9988\u6211\u4eec\u53d1\u73b0\u65e7\u7684\u624b\u52a8\u914d\u7f6e\u73af\u5883\u7684\u65b9\u5f0f\u975e\u5e38\u7684\u590d\u6742\u96be\u64cd\u4f5c( \u6240\u4ee5\u5462\u8fd9\u91cc\u5c31\u63a8\u8350\u4e00\u79cd\u65b0\u7684\u914d\u7f6e\u73af\u5883\u7684\u65b9\u5f0f - \u4f7f\u7528\u6a21\u677f \u8003\u8651\u5230 nuget \u5b89\u88c5\u6a21\u677f\u4e5f\u9700\u8981\u4e00\u5b9a\u7684\u547d\u4ee4\u884c\u57fa\u7840... \u6240\u4ee5\u8fd9\u91cc\u8003\u8651\u63d0\u4f9b\u76f4\u63a5\u7684\u4e0b\u8f7d\u94fe\u63a5, \u6216\u8005Github\u6e90,  \u4e0b\u8f7d\u89e3\u538b/clone\u540e, \u4f7f\u7528\u4f60\u7684 vs \u6253\u5f00\u5176\u4e2d\u7684 csproj \u6587\u4ef6, \u90a3\u4e48\u6309\u7406\u6765\u8bf4\u4f60\u4f1a\u770b\u5230\u8fd9\u51e0\u4e2a\u6587\u4ef6:</p> <p>Note</p> <p>\u4f60\u53ef\u80fd\u8fd8\u9700\u8981\u5b89\u88c5 <code>.NET 6 SDK</code> \u6765\u4f7f\u7528\u8be5\u6a21\u677f, \u4f60\u53ef\u4ee5\u70b9\u51fb\u8fd9\u91cc\u4e0b\u8f7d</p> <ul> <li>CelesteMod.props</li> <li>CelesteMod.targets</li> <li>Common.props</li> <li>MyCelesteModModule.cs</li> <li>MyCelesteMod.csproj</li> </ul> <p>\u4ee5\u53ca\u4f60\u7684\u9879\u76ee, \u5b83\u7684\u540d\u5b57\u662f <code>MyCelesteMod</code>, \u4e0d\u540c\u4e8e\u65e7\u7684\u65b9\u6cd5, \u5728\u8fd9\u91cc\u4f60\u7684\u914d\u7f6e\u8fc7\u7a0b\u5f88\u7b80\u5355:</p> <ul> <li>\u9996\u5148\u6253\u5f00 <code>Common.props</code>, \u5c06\u91cc\u9762\u7684 <code>CelesteRootPath</code> \u5185\u7684\u5185\u5bb9\u6539\u6210\u4f60\u7684\u851a\u84dd\u5b89\u88c5\u4f4d\u7f6e</li> </ul> <pre><code>&lt;Project&gt;\n    &lt;PropertyGroup&gt;\n        &lt;CelesteRootPath&gt;C:\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste&lt;/CelesteRootPath&gt;\n        &lt;CommonCelesteUsings&gt;true&lt;/CommonCelesteUsings&gt;\n        &lt;CommonCelesteReferences&gt;true&lt;/CommonCelesteReferences&gt;\n        &lt;ModAssetsFolderName&gt;ModFolder&lt;/ModAssetsFolderName&gt;\n    &lt;/PropertyGroup&gt;\n&lt;/Project&gt;\n</code></pre> <p>\u73b0\u5728\u4f60\u53ef\u4ee5\u6309\u4e0b <code>Ctrl+B</code> \u6216\u8005\u624b\u52a8\u70b9\u51fb <code>\u751f\u6210-&gt;\u751f\u6210\u89e3\u51b3\u65b9\u6848</code>, \u5982\u679c\u4f60\u5728\u4f60\u7684 vs \u8f93\u51fa\u91cc\u9762\u770b\u5230\u4e86\u7c7b\u4f3c\u8fd9\u4e00\u53e5:</p> <pre><code>1&gt;Copied files in 'ModFolder' to 'C:\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\Mods\\MyCelesteMod'\n</code></pre> <p>\u5e76\u4e14\u4f60\u5728\u4f60\u7684\u851a\u84dd Mod \u76ee\u5f55\u4e0b\u627e\u5230\u4e86\u8fd9\u4e2a\u88ab\u521b\u5efa\u7684\u76ee\u5f55, \u90a3\u4e48\u4f60\u7684\u73af\u5883\u5c31\u7b97\u662f\u914d\u5b8c\u4e86, \u5982\u679c\u4f60\u5f88\u611f\u5174\u8da3\u8fd9\u4e4b\u4e2d\u53d1\u751f\u4e86\u4ec0\u4e48, \u8981\u5f15\u7528\u54ea\u4e9b\u7a0b\u5e8f\u96c6, \u8fd9\u4e2a\u6a21\u677f\u80cc\u540e\u5e72\u4e86\u4ec0\u4e48, \u4f60\u53ef\u4ee5\u53bb\u770b\u90a3\u590d\u6742\u7684\u65e7\u7684\u914d\u7f6e\u65b9\u6cd5.</p> <p>Note</p> <p>\u8fd9\u4e2a\u6a21\u677f\u4f7f\u7528 <code>msbuild</code> \u5e2e\u52a9\u4e86\u4f60\u5f88\u591a\u4e8b! \u6bd4\u5982\u5f53\u4f60\u7f16\u8bd1\u5b8c\u9879\u76ee\u4e4b\u540e\u5b83\u4f1a\u590d\u5236\u7f16\u8bd1\u7ed3\u679c\u5230\u9879\u76ee\u76ee\u5f55\u7684 <code>ModFolder</code> \u76ee\u5f55\u4e0b, \u7136\u540e\u5c06\u6574\u4e2a <code>ModFolder</code> \u590d\u5236\u5230\u851a\u84dd\u7684 <code>Mods\\{\u4f60\u7684mod\u540d}</code> \u6587\u4ef6\u5939\u4e0b! \u6240\u4ee5\u5f53\u6211\u4eec\u9700\u8981\u66f4\u6539\u4e00\u4e9b\u6bd4\u5982\u8bf4 loenn \u7684\u914d\u7f6e\u6587\u4ef6, <code>everest.yaml</code> \u7684\u5185\u5bb9, \u4f60\u7684\u6d4b\u8bd5\u5730\u56fe\u7b49\u65f6,  \u4f60\u53ea\u9700\u8981\u7b80\u5355\u5730\u91cd\u65b0\u7f16\u8bd1\u4e00\u904d\u9879\u76ee, \u7136\u540e\u7b49\u5f85\u6a21\u677f\u6765\u5e2e\u4f60\u505a\u5269\u4e0b\u7684\u6d3b!  </p>"},{"location":"begin/basic_env/#_3","title":"\u66f4\u6539\u7ec6\u8282","text":"<p>\u901a\u8fc7\u6a21\u677f\u7684\u8bdd\u4f9d\u7136\u6709\u4e9b\u4e1c\u897f\u9700\u8981\u81ea\u884c\u66f4\u6539, \u6bd4\u5982\u8fd9\u4e2a Mod \u7684\u540d\u5b57. \u66f4\u6539 Mod \u7684\u540d\u5b57\u5f88\u7b80\u5355, \u4f60\u53ea\u9700\u8981\u7b80\u5355\u5730\u5728 vs \u91cc\u91cd\u547d\u540d\u9879\u76ee\u7684\u540d\u5b57 \u6bd4\u5982\u6211\u60f3\u53eb\u505a <code>MyAwesomeMod</code>, \u90a3\u4e48\u4f60\u53ef\u4ee5\u901a\u8fc7\u8fd9\u6837:  \u987a\u4fbf\u522b\u5fd8\u4e86\u628a\u7c7b\u4f3c <code>MyCelesteModModule.cs</code> \u7684\u6587\u4ef6\u540d\u4e5f\u6539\u6210\u7c7b\u4f3c <code>MyAwesomeModModule.cs</code>, \u4ee5\u53ca\u6539\u540d\u540e\u6e05\u7406\u4e00\u4e0b ModFolder \u4e0b\u9762\u53ef\u80fd\u6709\u7684\u4e00\u4e9b\u4ee5\u8fc7\u53bb\u540d\u5b57\u547d\u540d\u7684 .dll \u548c .pdb \u6587\u4ef6!  </p>"},{"location":"begin/basic_env/#module","title":"Module \u7c7b","text":"<p>\u5c31\u50cf\u6211\u4eec\u7684\u7ecf\u5178\u7684\u63a7\u5236\u53f0 C# \u5e94\u7528\u7a0b\u5e8f\u4e00\u6837\u6709\u4e2a <code>Main</code> \u65b9\u6cd5, \u6211\u4eec\u7684\u851a\u84dd Mod \u4e5f\u6709\u4e00\u4e2a \u7c7b\u4f3c\u7684\u4e1c\u897f,  \u90a3\u5c31\u662f Everest \u63d0\u4f9b\u7ed9\u6211\u4eec\u7684 <code>EverestModule</code> \u7c7b. \u90a3\u4e48, \u73b0\u5728\u6253\u5f00\u4f60\u7684 <code>Module.cs</code> \u90a3\u4e2a\u6587\u4ef6, \u4f60\u5e94\u8be5\u4f1a\u770b\u5230\u7ed3\u6784\u8fd9\u6837\u7684\u4ee3\u7801: <pre><code>namespace MyCelesteMod;\n\npublic class MyAwesomeModModule : EverestModule\n{\n    public override void Load()\n    {\n        Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World!\");\n\n    }\n\n    public override void Unload()\n    {\n    }\n}\n</code></pre> \u5728\u5f00\u5934\u6211\u4eec\u58f0\u660e\u4e86\u547d\u540d\u7a7a\u95f4, \u63a5\u4e0b\u6765\u6211\u4eec\u58f0\u660e\u4e86\u4e00\u4e2a\u7c7b, \u7136\u540e\u8ba9\u5b83\u7ee7\u627f\u4e8e <code>EverestModule</code>, \u6ce8\u610f\u8fd9\u4e2a\u7c7b\u662f\u62bd\u8c61\u7684, \u5b83\u8981\u6c42\u6211\u4eec\u5b9e\u73b0\u7684\u4e24\u4e2a\u65b9\u6cd5\u5206\u522b\u4e3a <code>Load</code> \u4e0e <code>Unload</code>. \u8fd9\u4e24\u4e2a\u65b9\u6cd5\u5f88\u7b80\u5355:</p> <ul> <li><code>Load</code> \u65b9\u6cd5\u5728\u4f60\u7684 mod \u88ab\u52a0\u8f7d\u65f6\u8c03\u7528.</li> <li><code>Unload</code> \u65b9\u6cd5\u5728\u4f60\u7684 mod \u88ab\u5378\u8f7d\u65f6\u8c03\u7528.</li> </ul> <p>\u901a\u5e38\u6211\u4eec\u4f1a\u5728 <code>Load</code> \u65b9\u6cd5\u91cc\u52a0\u8f7d\u6211\u4eec\u9700\u8981\u7684\u8d44\u6e90, \u8fdb\u884c\u9002\u5f53\u7684\u521d\u59cb\u5316, \u5728 <code>Unload</code> \u65b9\u6cd5\u91cc\u91ca\u653e\u6211\u4eec\u7684\u8d44\u6e90. \u5728\u8fd9\u91cc\u4e3a\u4e86\u660e\u663e\u53ef\u89c1, \u6211\u4eec\u5728 <code>Load</code> \u65b9\u6cd5\u91cc\u901a\u8fc7\u4e00\u4e2a\u851a\u84dd\u4e2d\u7684\u7c7b <code>Logger</code> \u6253\u5370\u51fa\u4e86\u4e00\u53e5 \"Hello World\".</p> \u5982\u679c\u4f60\u597d\u5947 <code>Logger.Log</code> \u8fd9\u4e2a\u65b9\u6cd5\u4f60\u53ef\u4ee5\u5c55\u5f00\u6765\u4e86\u89e3 <p><code>Logger</code> \u662f\u4e00\u4e2a\u851a\u84dd\u5e95\u5c42\u5f15\u64ce <code>Monocle</code> \u7684\u4e00\u4e2a\u5de5\u5177\u7c7b, \u5b83\u5e2e\u52a9\u4f60\u6253\u5370\u8f93\u51fa\u4e00\u4e9b\u8c03\u8bd5\u4fe1\u606f, \u901a\u5e38\u8fd9\u4e9b\u4fe1\u606f\u4f1a\u88ab\u6253\u5370\u8fdb\u63a7\u5236\u53f0\u7684\u540c\u65f6\u5199\u5165\u6e38\u620f\u7684 <code>log.txt</code> \u6587\u4ef6\u4e2d,  \u8fd9\u4e5f\u5c31\u89e3\u91ca\u4e86\u4e3a\u4ec0\u4e48\u4f60\u9047\u5230\u5404\u79cd\u95ee\u9898\u65f6\u522b\u4eba\u603b\u8981\u6c42\u4f60\u53d1\u9001\u4f60\u7684 <code>log.txt</code>. <code>Logger.Log</code> \u6709\u4e24\u4e2a\u91cd\u8f7d, \u5176\u4e2d\u4e00\u4e2a\u7684\u7b7e\u540d\u662f: <pre><code>public static void Log(LogLevel logLevel, string tag, string str)\n</code></pre> \u5b83\u4f1a\u4ee5 <code>logLevel</code> \u7684\u65e5\u5fd7\u7b49\u7ea7\u6253\u5370\u4e00\u4e2a\u6807\u7b7e\u4e3a <code>tag</code> \u7684\u6d88\u606f <code>str</code>, \u53e6\u4e00\u4e2a\u91cd\u8f7d\u4e0d\u8981\u6c42\u4f60\u4f20\u5165 <code>logLevel</code> \u4f46\u4f1a\u9ed8\u8ba4\u4f60\u7684 <code>logLevel</code> \u4e3a <code>LogLevel.Verbose</code>. <code>LogLevel</code> \u679a\u4e3e\u5305\u542b <code>Verbose, Debug, Info, Warn, Error</code>. \u901a\u5e38\u5bf9\u4e8e\u666e\u901a\u65e5\u5fd7\u6211\u4eec\u4f1a\u9009\u62e9 <code>Info</code>, \u5bf9\u4e8e\u8f83\u591a\u7684\u8c03\u8bd5\u4fe1\u606f\u9009\u62e9 <code>Debug</code>, \u5bf9\u4e8e\u5197\u4f59\u7684\u4fe1\u606f\u9009\u62e9 <code>Verbose</code>, \u5bf9\u4e8e\u4e00\u4e9b\u9519\u8bef\u4f46\u4e0d\u5f71\u54cd\u6e38\u620f\u8fdb\u884c\u7684\u4fe1\u606f\u9009\u62e9 <code>Warn</code>, \u5bf9\u4e8e\u4e00\u4e9b\u81f4\u547d\u6027\u9519\u8bef\u6211\u4eec\u4f1a\u9009\u62e9 <code>Error</code>. \u4e00\u822c\u5730, \u6e38\u620f\u53ea\u4f1a\u6253\u5370 <code>Info</code> \u7b49\u7ea7\u53ca\u4ee5\u4e0a\u7684\u65e5\u5fd7, \u4f60\u53ef\u4ee5\u901a\u8fc7\u5728\u851a\u84dd\u542f\u52a8\u7684\u547d\u4ee4\u884c\u4e2d\u52a0\u5165<code>--loglevel {\u7b49\u7ea7}</code>\u6765\u6307\u5b9a\u8fc7\u6ee4\u7b49\u7ea7.</p>"},{"location":"begin/basic_env/#everestyaml","title":"everest.yaml","text":"<p>ok, \u6211\u4eec\u524d\u9762\u51e0\u4e4e\u5df4\u62c9\u5df4\u62c9\u8bb2\u4e86\u51e0\u4e4e\u4e09\u5343\u591a\u4e2a\u5b57, \u4f46\u662f\u4f9d\u7136\u6ca1\u6709\u8ba9\u851a\u84dd\u52a0\u8f7d\u5230\u6211\u4eec\u7684mod, \u4e0d\u8fc7\u522b\u6025, \u8fd9\u662f\u5012\u6570\u7b2c\u4e8c\u6b65\u4e86. \u5b9e\u9645\u4e0a\u6709\u5173 code mod \u7684\u6240\u6709\u4ee3\u7801\u76f8\u5173\u7684\u4e1c\u897f\u6211\u4eec\u90fd\u5df2\u7ecf\u505a\u5b8c\u4e86, \u5269\u4f59\u7684\u5176\u5b9e\u53ea\u662f\u4e00\u4e2a\u666e\u901a mod \u8981\u505a\u7684 ---- \u5199 <code>everest.yaml</code>. \u5728\u8fd9\u91cc\u6211\u4eec\u9700\u8981\u5728 <code>ModFolder</code> \u8fd9\u4e2a\u6587\u4ef6\u5939\u91cc\u505a\u8fd9\u4ef6\u4e8b, \u90a3\u4e48, \u5728\u4f60\u7684\u8fd9\u4e2a\u6587\u4ef6\u5939\u4e0b\u521b\u5efa <code>everest.yaml</code> \u7a7a\u6587\u4ef6, \u4f60\u7684\u76ee\u5f55\u7ed3\u6784\u53ef\u80fd\u50cf\u662f:  </p> <p>Note</p> <p><code>.dll</code> \u6587\u4ef6\u548c <code>.pdb</code> \u6587\u4ef6\u4ec5\u4f1a\u5728\u4f60\u6784\u5efa\u8fc7\u9879\u76ee\u540e\u51fa\u73b0, \u6709\u65f6\u5019\u751a\u81f3 ModFolder \u76ee\u5f55\u4e5f\u4f1a\u5728\u6784\u5efa\u8fc7\u540e\u51fa\u73b0</p> <ul> <li>ModFolder<ul> <li>everest.yaml</li> <li>MyCelesteMod.dll</li> <li>MyCelesteMod.pdb</li> </ul> </li> </ul> <p>\u597d\u7684, \u73b0\u5728\u6211\u4eec\u6253\u5f00 <code>everest.yaml</code>, \u7136\u540e\u50cf\u4e00\u4e2a\u666e\u901a\u7684 mapper \u4e00\u6837\u586b\u5199\u4fe1\u606f: <pre><code>- Name: MyCelesteMod\n  Version: 0.1.0\n  DLL: MyCelesteMod.dll\n  Dependencies:\n    - Name: Everest\n      Version: 1.3971.0\n</code></pre> \u8fd9\u4e9b\u53c2\u6570\u5206\u522b\u662f:</p> <ul> <li><code>Name</code>: \u4f60\u7684 mod \u540d\u5b57</li> <li><code>Version</code>: \u4f60\u7684 mod \u7684\u7248\u672c</li> <li><code>DLL</code>: \u5982\u679c\u4f60\u662f code mod \u7684\u8bdd, \u8fd9\u91cc\u586b\u5165\u4f60\u7684 code (\u4e5f\u5c31\u662f dll \u6587\u4ef6) \u7684\u4f4d\u7f6e, \u8fd9\u91cc\u6211\u4eec\u662f\u76f4\u63a5\u628a .dll \u6587\u4ef6\u653e\u5230\u8fd9\u4e2a yaml \u7684\u65c1\u8fb9\u4e86, \u6240\u4ee5\u76f4\u63a5\u5199\u540d\u5b57\u5c31\u597d</li> </ul> <p>\u6700\u540e\u662f\u6700\u5e95\u4e0b\u7684\u90a3\u4e2a\u4f9d\u8d56, \u8fd9\u91cc\u6211\u4eec\u53ea\u4f9d\u8d56\u6700\u57fa\u7840\u7684 Everest, \u7248\u672c\u586b\u4e0a\u4f60\u76ee\u524d\u4f7f\u7528\u7684 Everest \u7248\u672c, \u8fd9\u91cc\u6211\u5c31\u586b\u5199 3971 \u4e86.  </p>"},{"location":"begin/basic_env/#_4","title":"\u6700\u540e\u4e00\u6b65!","text":"<p>\u4e3a\u4e86\u65b9\u4fbf\u6211\u4eec\u7684\u8c03\u8bd5, \u6211\u4eec\u9700\u8981\u8ba9\u851a\u84dd\u6253\u5f00\u7684\u540c\u65f6\u6253\u5f00\u63a7\u5236\u53f0, \u8fd9\u4e00\u6b65\u5f88\u7b80\u5355:</p> <ul> <li>\u627e\u5230\u851a\u84dd\u6839\u76ee\u5f55\u4e0b\u7684 <code>everest-launch.txt</code>, \u6ca1\u6709\u7684\u8bdd\u65b0\u5efa\u4e00\u4e2a\u7a7a\u7684\u5c31\u884c\u4e86</li> <li>\u5411\u91cc\u9762\u5199\u5165 <code>--console</code></li> <li>\u641e\u5b9a, \u8d70\u4f60!</li> </ul> <p>\u73b0\u5728, \u91cd\u65b0\u7f16\u8bd1\u9879\u76ee, \u8ba9 <code>msbuild</code> \u5e26\u7740\u4f60\u7684 <code>ModFolder</code> \u7684\u5185\u5bb9\u524d\u5f80\u851a\u84dd Mods \u6587\u4ef6\u5939\u4e0b, \u542f\u52a8\u851a\u84dd. \u5728\u540c\u65f6\u542f\u52a8\u7684\u9ed1\u4e4e\u4e4e\u7684\u547d\u4ee4\u884c\u7a97\u53e3\u4e0a\u4f60\u5e94\u8be5\u80fd\u5728\u8fd9\u9644\u8fd1\u770b\u5230\u90a3\u53e5\u719f\u6089\u7684 Hello world: <pre><code>(07/08/2023 21:18:59) [Everest] [Info] [core] Module DialogCutscene 1.0.0 registered.\n(07/08/2023 21:18:59) [Everest] [Info] [core] Module UpdateChecker 1.0.2 registered.\n(07/08/2023 21:18:59) [Everest] [Info] [core] Module InfiniteSaves 1.0.0 registered.\n(07/08/2023 21:18:59) [Everest] [Info] [core] Module DebugRebind 1.0.0 registered.\n(07/08/2023 21:18:59) [Everest] [Info] [core] Module RebindPeriod 1.0.0 registered.\n(07/08/2023 21:19:00) [Everest] [Info] [Everest.LuaBoot] Lua ready.\n(07/08/2023 21:19:00) [Everest] [Info] [MyCelesteMod] Hello World!\n(07/08/2023 21:19:00) [Everest] [Info] [core] Module MyAwesomeMod 0.1.0 registered.\n(07/08/2023 21:19:00) [Everest] [Info] [loader] Loading mods with unsatisfied optional dependencies (if any)\nFNA3D Driver: D3D11\nD3D11 Adapter: Intel(R) UHD Graphics 630\n</code></pre></p>"},{"location":"begin/basic_env/#_5","title":"\u8fd8\u6ca1\u5b8c","text":"<p>\u5728\u7ecf\u8fc7\u5982\u4e0a\u7684\u914d\u7f6e\u540e, \u4f60\u4f1a\u53d1\u73b0\u5728\u851a\u84dd\u542f\u52a8\u7684\u65f6\u5019, \u8fdb\u884c\u7f16\u8bd1\u5e76\u590d\u5236\u8d44\u6e90\u65f6\u4f1a\u62a5\u9519,  \u8fd9\u662f\u56e0\u4e3a everest \u9501\u5b9a\u5360\u7528\u4e86\u5b83\u4eec, \u5bfc\u81f4\u4f60\u4e0d\u5f97\u4e0d\u8ba9\u8fd9\u4e00\u5207\u5728\u851a\u84dd\u5173\u95ed\u65f6\u8fdb\u884c, \u540c\u65f6\u7531\u4e8e\u851a\u84dd\u7684\u91cd\u542f\u901f\u5ea6\u4e0d\u662f\u5f88\u7406\u60f3, \u8fd9\u5927\u5927\u7684\u62c9\u4f4e\u4e86 mod \u5f00\u53d1\u6548\u7387.  \u4e0d\u8fc7\u597d\u5728 everest \u63d0\u4f9b\u4e86\u4e00\u4e2a\u6280\u672f\u53eb\u505a <code>hot reload</code>, \u5373\u70ed\u91cd\u8f7d, \u5b83\u5141\u8bb8\u4f60\u5728\u6e38\u620f\u8fd0\u884c\u671f\u95f4\u66ff\u6362\u4f60\u7684\u4ee3\u7801\u5e76\u91cd\u8f7d\u8d44\u6e90, \u5b83\u76ee\u524d\u8fd8\u5728 wip \u72b6\u6001. \u8981\u5f00\u542f\u8fd9\u9879\u529f\u80fd, \u9996\u5148\u5230\u4f60\u7684\u851a\u84dd\u6839\u76ee\u5f55\u4e0b\u7684 Saves \u76ee\u5f55, \u627e\u5230\u5e76\u6253\u5f00 <code>modsettings-Everest.celeste</code> \u8fd9\u4e2a\u6587\u4ef6, \u7ffb\u5230\u5927\u6982\u4e2d\u95f4\u7684\u4f4d\u7f6e, \u627e\u5230\u5c5e\u6027 <code>CodeReload_WIP</code>, \u5c06\u5176\u66f4\u6539\u4e3a <code>true</code>, \u6b64\u65f6\u91cd\u65b0\u7f16\u8bd1\u4f60\u7684\u9879\u76ee, \u4f60\u5e94\u8be5\u5c31\u4e0d\u4f1a\u518d\u5f97\u5230\u4efb\u4f55\u9519\u8bef, \u5e76\u4e14 everest \u4e5f\u6b63\u786e\u5730\u70ed\u91cd\u8f7d\u4e86\u4f60\u7684 mod \u548c\u4f60\u7684 mod \u8d44\u6e90.</p>"},{"location":"begin/basic_env/#_6","title":"\u6700\u540e\u4e00\u4e9b\u788e\u788e\u5ff5","text":"<p>\u8fd9\u4e00\u8282\u5b8c\u6210\u540e\u4f60\u7684\u76ee\u5f55\u7ed3\u6784\u5927\u6982\u4f1a\u50cf\u662f:</p> <ul> <li>MyCelesteMod (\u4f60\u7684\u6839\u76ee\u5f55)<ul> <li>ModFolder<ul> <li>everest.yaml</li> <li>MyCelesteMod.dll</li> <li>MyCelesteMod.pdb</li> </ul> </li> <li>CelesteMod.props</li> <li>CelesteMod.targets</li> <li>Common.props</li> <li>MyCelesteMod.csproj</li> <li>MyCelesteModModule.cs</li> </ul> </li> </ul> <p>\u5176\u4e2d\u6b63\u5982\u4e4b\u524d\u6240\u4ecb\u7ecd\u7684, \u6211\u63a8\u8350\u5982\u679c\u4f60\u4f7f\u7528\u8be5\u6a21\u677f\u7684\u8bdd, mod \u7684\u8d44\u6e90\u6587\u4ef6\u5e94\u8be5\u653e\u5728 <code>ModFolder</code> \u4e2d, \u7136\u540e\u5c31\u50cf\u5f80\u5e38\u4e00\u6837\u653e\u7f6e\u4f60\u7684 mod \u8d44\u6e90, \u5f53\u4f60\u7684\u9879\u76ee\u5728\u6784\u5efa\u65f6\u5b83\u4eec\u4f1a\u81ea\u52a8\u88ab\u590d\u5236. \u5982\u679c\u4f60\u6ca1\u6709\u66f4\u6539\u4f60\u7684\u9879\u76ee\u800c\u53ea\u66f4\u6539\u4e86\u8d44\u6e90\u6587\u4ef6\u65f6\u4f60\u4f1a\u53d1\u73b0\u7f16\u8bd1\u9879\u76ee\u4f1a\u56e0\u4e3a\"\u6240\u6709\u6587\u4ef6\u90fd\u662f\u6700\u65b0\u7684\"\u800c\u8df3\u8fc7\u7f16\u8bd1, \u800c\u540c\u65f6\u4e5f\u4f1a\u8df3\u8fc7\u6211\u4eec\u7684\u8d44\u6e90\u590d\u5236, \u5bf9\u6b64\u7684\u8bdd\u6211\u4eec\u6709\u4e24\u79cd\u89e3\u51b3\u65b9\u6848:</p> <ul> <li>\u76f4\u63a5\u5f3a\u5236\u91cd\u65b0\u6784\u5efa\u9879\u76ee (vs\u4e2d \"\u751f\u6210\" -&gt; \"\u91cd\u65b0\u751f\u6210\u9879\u76ee\")</li> <li>\u5728\u9879\u76ee\u6839\u76ee\u5f55\u6267\u884c <code>msbuild -target:PostModBuild</code> \u547d\u4ee4\u884c</li> </ul> <p>\u597d\u50cf\u662f\u6709\u66f4\u597d\u7684\u89e3\u51b3\u65b9\u6cd5, \u4e0d\u8fc7\u9274\u4e8e\u672c\u4eba MSBuild \u77e5\u8bc6\u4e0d\u8db3\u53ea\u80fd\u505a\u6210\u8fd9\u6837\u4e86(x</p>"},{"location":"begin/celeste_everest_monomod/","title":"Celeste Everest MonoMod","text":""},{"location":"begin/celeste_everest_monomod/#celeste","title":"Celeste","text":"<p>\u989d, \u6765\u8fd9\u91cc\u7684\u5e94\u8be5\u90fd\u77e5\u9053 Celeste \u662f\u4ec0\u4e48\u5427(( \u540e\u6587\u4e2d\u63d0\u5230\u7684 <code>Celeste</code>, <code>\u851a\u84dd</code> \u90fd\u4f1a\u53ea\u6307 Celeste \u8fd9\u4e2a\u6e38\u620f, \u4e5f\u5c31\u662f\u6211\u4eec\u6b63\u5728\u5b66\u4e60\u4e3a\u5176\u5236\u4f5c mod \u7684\u5bf9\u8c61.</p>"},{"location":"begin/celeste_everest_monomod/#everest","title":"Everest","text":"<p>\u4f5c\u4e3a\u4e00\u4e2a\u851a\u84dd\u7684 mod \u73a9\u5bb6, \u5b89\u88c5 Everest \u662f\u5fc5\u4e0d\u53ef\u5c11\u7684\u6b65\u9aa4, \u56e0\u4e3a\u6211\u4eec\u7684 mod \u4f9d\u8d56\u4e8e\u5b83\u6240\u63d0\u4f9b\u7684\u5236\u4f5c mod \u4e2d\u6240\u5fc5\u987b\u7684\u4e1c\u897f. \u5b83\u5f00\u6e90\u5728Github\u4e0a. \u53ef\u80fd\u4f60\u8fd8\u542c\u8fc7 Olympus, \u5b83\u662f\u4e00\u4e2a Everest \u7684\u5b89\u88c5\u5668, \u4e5f\u662f\u4e00\u4e2a mod \u7ba1\u7406\u5668.</p> <p>\u5982\u679c\u4f60\u8fd8\u73a9\u8fc7 Minecraft \u7684\u8bdd\u6211\u4eec\u53ef\u4ee5\u5efa\u7acb\u4e00\u4e2a\u8fd9\u6837\u7684\u5947\u5999\u5173\u7cfb:</p> \u851a\u84dd\u4fa7 MC\u4fa7 Celeste Minecraft Everest Forge/Fabric Olympus PCL2/HCML <p>\u989d\u5916\u5730, Everest, Forge, Fabric \u8fd9\u4e00\u7c7b\u4e1c\u897f\u6211\u4eec\u5bf9\u5176\u6709\u4e2a\u7edf\u79f0, \u53eb\u505a <code>ModApi</code>. \u5c31\u50cf Celeste \u548c Minecraft \u88ab\u7edf\u79f0\u4e3a\u6e38\u620f\u672c\u4f53/\u539f\u7248.</p>"},{"location":"begin/celeste_everest_monomod/#monomod","title":"MonoMod","text":"<p>Everest \u5e95\u5c42\u57fa\u4e8e MonoMod, \u5728\u8fd9\u91cc\u4f60\u53ea\u9700\u8981\u77e5\u9053 Everest \u4f9d\u8d56\u4e86 MonoMod, \u540c\u6837\u5730\u8fd9\u4e5f\u662f\u4e00\u4e2a\u5f00\u6e90\u9879\u76ee(Github), \u6709\u8da3\u7684\u662f, Everest \u7684\u4e3b\u8981\u7ef4\u62a4\u8005\u4e4b\u4e00\u4e5f\u662f MonoMod \u7684\u4e3b\u8981\u7ef4\u62a4\u8005, \u540c\u65f6 MonoMod \u4e5f\u662f\u4e00\u4e9b\u5176\u4ed6\u6e38\u620f\u7684 mod \u5e95\u5c42, \u6bd4\u5982 Terraria \u7684 tModLoader, Fez \u7684 FEZMod \u7b49\u7b49.</p> <p>\u90a3\u4e48\u5728\u8fd9\u4e09\u4e2a\u57fa\u7840\u6982\u5ff5\u4e86\u89e3\u4e4b\u540e\u4f60\u5c31\u53ef\u4ee5\u5f00\u59cb\u5236\u4f5c\u4f60\u7684\u7b2c\u4e00\u4e2a mod\u4e86: \u57fa\u7840\u73af\u5883\u914d\u7f6e</p>"},{"location":"begin/hook%2Creading_1/","title":"\u94a9\u5b50, \u9605\u8bfb\u4ee3\u7801, demo1","text":""},{"location":"begin/hook%2Creading_1/#_1","title":"\u524d\u8a00","text":"<p>\u5728\u8fd9\u4e00\u8282, \u6211\u4eec\u4f1a\u4ecb\u7ecd\u5728\u5236\u4f5c mod \u4e2d\u7684\u4e00\u4e2a\u5f88\u91cd\u8981\u7684\u6280\u672f: \u94a9\u5b50(Hook), \u6211\u4eec\u4e3b\u8981\u4ecb\u7ecd On \u94a9\u5b50, \u5728\u4e4b\u540e\u6211\u4eec\u4f1a\u9605\u8bfb\u851a\u84dd\u7684\u4ee3\u7801, \u6700\u540e\u6211\u4eec\u4f1a\u5236\u4f5c\u4e00\u4e2a\u4fee\u6539\u73a9\u5bb6\u51b2\u523a\u6570\u7684\u5c0f demo.</p>"},{"location":"begin/hook%2Creading_1/#on","title":"\u94a9\u5b50 (\u7279\u6307 On \u94a9\u5b50)","text":"<p>\u5bf9\u4e8e C# \u7684\u4e00\u4e2a\u666e\u901a\u7684\u51fd\u6570\u6765\u8bf4, \u5b83\u88ab\u8c03\u7528\u65f6\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684:</p> <pre><code>graph LR\n    A[\u8c03\u7528\u65b9] --&gt; B[\u5373\u5c06\u8c03\u7528\u8be5\u51fd\u6570];\n    subgraph \u8be5\u51fd\u6570\n    B --&gt; C[\u8be5\u51fd\u6570\u4e3b\u4f53];\n    C --&gt; D[\u7ed3\u675f\u8c03\u7528\u8be5\u51fd\u6570];\n    end\n    D --&gt; E[\u8c03\u7528\u65b9];</code></pre> <p>\u5f53\u6211\u4eec\u5f15\u5165\u94a9\u5b50\u6280\u672f\u540e, \u8fd9\u4e2a\u51fd\u6570\u8c03\u7528\u65f6\u4f1a\u50cf\u88ab\"\u94a9\"\u4f4f\u4e00\u6837\u8f6c\u8eab\u53bb\u8c03\u7528\u6211\u4eec\u7684\u51fd\u6570:</p> <pre><code>graph LR\n    A[\u8c03\u7528\u65b9]; B[\u5373\u5c06\u8c03\u7528\u8be5\u51fd\u6570];\n    F[\u94a9\u5b50]; G[\u6211\u4eec\u7684\u51fd\u6570];\n    H[\u8be5\u51fd\u6570\u4e3b\u4f53];\n    D[\u7ed3\u675f\u8c03\u7528\u8be5\u51fd\u6570];\n    E[\u8c03\u7528\u65b9];\n    subgraph \u8be5\u51fd\u6570\n    B; H; D;\n    end\n    A --&gt; B;\n    B --&gt; F;\n    F --&gt; G;\n    H --&gt; D;\n    G --&gt; H;\n    G -.\u6216\u8005.-&gt; D;\n    D --&gt; E;</code></pre> <p>\u5982\u56fe\u6240\u89c1, \u8be5\u94a9\u5b50\u5141\u8bb8\u4f60\u5728\u8c03\u7528\u67d0\u4e2a\u51fd\u6570\u65f6\u8f6c\u8eab\u53bb\u8c03\u7528\u6211\u4eec\u7684\u51fd\u6570, \u540c\u65f6\u4f60\u80fd\u9009\u62e9\u6211\u4eec\u7684\u51fd\u6570\u6267\u884c\u5b8c\u540e\u662f\u5426\u518d\u6267\u884c\u56de\u539f\u51fd\u6570.</p> <p>\u5728 Everest \u4e2d, \u501f\u52a9\u4e8e MonoMod \u7684\u6280\u672f, \u521b\u5efa\u4e00\u4e2a On \u94a9\u5b50\u7b80\u5355\u7684\u5c31\u50cf:</p> \u7b80\u5355\u7684\u94a9\u53d6...<pre><code>public override void Load()\n{\n    On.Celeste.Player.Update += Player_Update;\n}\n\nprivate void Player_Update(On.Celeste.Player.orig_Update orig, Player self)\n{\n    orig(self);\n}\n\npublic override void Unload()\n{\n    On.Celeste.Player.Update -= Player_Update;\n}\n</code></pre> <p>\u5728\u4e0a\u9762\u7684\u4ee3\u7801\u4e2d\u6211\u4eec\u4f7f\u7528\u7c7b\u4f3c\u8ba2\u9605\u4e8b\u4ef6\u7684\u8bed\u6cd5\u53bb\u94a9\u4f4f\u4e86 <code>Player</code> \u7c7b\u7684 <code>Update</code> \u65b9\u6cd5(\u8be5\u65b9\u6cd5\u6bcf\u5e27\u90fd\u4f1a\u8c03\u7528\u4e00\u904d), Everest \u4e3a\u6211\u4eec\u628a\u51e0\u4e4e\u6240\u6709\u53ef\u80fd\u94a9\u53d6\u7684\u51fd\u6570\u653e\u5230\u4e86\u547d\u540d\u7a7a\u95f4 <code>On</code> \u4e2d, \u5f53\u4f60\u60f3\u94a9\u53d6\u67d0\u4e2a\u65b9\u6cd5\u65f6\u53ea\u9700\u901a\u8fc7 <code>On</code> \u547d\u540d\u7a7a\u95f4\u4e00\u8def\"\u70b9\"\u5230\u4f60\u60f3\u8981\u7684\u65b9\u6cd5\u4e0a, \u7136\u540e\u4f7f\u7528\u4e00\u4e2a\u94a9\u5b50\u51fd\u6570\u4ee5\u50cf\u4e8b\u4ef6\u4e00\u6837\u7684\u8bed\u6cd5\"\u8ba2\u9605\"\u5c31\u80fd\u94a9\u4f4f\u5b83! \u5728\u8fd9\u91cc\u6211\u4eec\u7684\u94a9\u5b50\u51fd\u6570\u5c31\u662f<code>Player_Update</code>, \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u53c2\u6570\u5f88\u590d\u6742, \u662f\u7684, \u6240\u4ee5\u4e00\u822c\u6765\u8bf4\u6211\u90fd\u662f\u4f9d\u8d56 IDE \u5e2e\u6211\u81ea\u52a8\u586b\u5199\u8fd9\u4e9b\u53c2\u6570\u5c31\u50cf:  </p> <p> </p> <p></p> <p>Note</p> <p>\u6ce8\u610f IDE \u751f\u6210\u7684\u51fd\u6570\u9ed8\u8ba4\u5305\u542b\u4e00\u53e5\u629b\u51fa\u5f02\u5e38\u8bed\u53e5, \u8bb0\u5f97\u628a\u5b83\u6539\u6389</p> <p><code>orig</code> \u53c2\u6570\u662f\u4e00\u4e2a\u59d4\u6258, \u8c03\u7528\u5b83\u5c31\u76f8\u5f53\u4e8e\u8c03\u7528\u8fd9\u4e2a\u94a9\u5b50\u94a9\u4f4f\u7684\u539f\u51fd\u6570, \u4e5f\u5c31\u662f\u8bf4\u4f60\u53ef\u4ee5\u5728\u8be5\u51fd\u6570\u8c03\u7528\u524d\u505a\u4e9b\u4e8b, \u4e5f\u53ef\u4ee5\u5728\u8be5\u51fd\u6570\u8c03\u7528\u540e\u505a\u4e9b\u4e8b, \u6216\u8005\u5e72\u8106\u4e0d\u8c03\u7528\u8fd9\u4e2a\u51fd\u6570, \u751a\u81f3\u8c03\u7528\u8fd9\u4e2a\u51fd\u6570\u591a\u6b21. \u901a\u5e38\u6765\u8bf4\u6211\u4eec\u90fd\u4f1a\u5728\u672b\u5c3e\u7b80\u5355\u7684\u8c03\u7528\u56de\u53bb\u907f\u514d\u9020\u6210\u4e0d\u5fc5\u8981\u7684\u9ebb\u70e6.</p> \u4e00\u4e9b\u94a9\u5b50\u672c\u8eab...<pre><code>private void Player_Update(On.Celeste.Player.orig_Update orig, Player self)\n{\n    // \u5728\u8fd9\u4e4b\u524d\u505a\u4e00\u4e9b\u4e8b...\n\n    // \u5f53\u67d0\u4e9b\u5947\u602a\u7684\u6761\u4ef6\u4e0d\u6210\u7acb\u65f6\u6211\u4eec\u624d\u8c03\u7528\u56de\u53bb\u539f\u6765\u7684\u51fd\u6570...\n    if (!xxx)\n        orig(self);\n\n    // \u5728\u8fd9\u4e4b\u540e\u505a\u4e00\u4e9b\u4e8b...\n}\n</code></pre> <p>\u5982\u679c\u4f60\u94a9\u53d6\u5230\u7684\u662f\u4e00\u4e2a\u6210\u5458\u51fd\u6570(\u4e5f\u53eb\u6210\u5458\u65b9\u6cd5), \u90a3\u4e48\u53c2\u6570\u901a\u5e38\u4f1a\u5e26\u6709\u4e00\u4e2a <code>self</code>, \u5b83\u8868\u793a\u6267\u884c\u8fd9\u4e2a\u6210\u5458\u51fd\u6570\u65f6 <code>this</code> \u7684\u503c, \u90a3\u4e48\u81ea\u7136\u5730\u5982\u679c\u4f60\u94a9\u53d6\u7684\u662f\u4e00\u4e2a\u9759\u6001\u51fd\u6570\u90a3\u4e48\u662f\u6ca1\u6709\u8fd9\u4e2a\u53c2\u6570\u7684. \u5982\u679c\u4f60\u94a9\u53d6\u7684\u51fd\u6570\u662f\u5e26\u53c2\u6570\u7684, \u90a3\u4e48\u53c2\u6570\u5217\u8868\u4f1a\u539f\u5c01\u4e0d\u52a8\u7684\u6392\u5217\u5728\u524d\u9762\u63d0\u5230\u7684\u53c2\u6570\u7684\u540e\u9762.  </p> <p>\u6bd4\u5982\u4f60\u5c1d\u8bd5\u94a9\u53d6 <code>Player.Jump</code> \u51fd\u6570\u65f6, \u5b83\u7684\u4e09\u4e2a\u53c2\u6570\u4f1a\u8fd9\u6837\u4f20\u9012\u7ed9\u4f60:</p> <pre><code>private void Player_Jump(On.Celeste.Player.orig_Jump orig, Player self, bool particles, bool playSfx)\n</code></pre> <p>\u6700\u540e, \u4e0d\u8981\u5fd8\u8bb0\u5728 <code>Unload</code> \u65b9\u6cd5\u91cc\u53d6\u6d88\u6389\u6211\u4eec\u7684\u94a9\u5b50(\u901a\u8fc7<code>-=</code>), \u9632\u6b62\u6211\u4eec\u7684\u94a9\u5b50\u5728\u4e0d\u5fc5\u8981\u7684\u5730\u65b9\u4ea7\u751f\u4e0d\u597d\u7684\u5f71\u54cd: \u53d6\u6d88\u94a9\u5b50<pre><code>public override void Unload()\n{\n    On.Celeste.Player.Update -= Player_Update;\n}\n</code></pre></p>"},{"location":"begin/hook%2Creading_1/#i","title":"\u9605\u8bfb\u4ee3\u7801 I","text":"<p>\u5230\u8fd9\u91cc\u4f60\u662f\u5426\u6709\u5f88\u591a\u95ee\u53f7(((, \u6bd4\u5982\u8fd9\u4e9b\u51fd\u6570\u90fd\u662f\u5e72\u4ec0\u4e48\u7684? </p> <ul> <li><code>Player</code> \u662f\u4ec0\u4e48?</li> <li><code>Player.Update</code> \u662f\u4ec0\u4e48?</li> <li><code>Player.Jump</code> \u53c8\u662f\u4ec0\u4e48??</li> </ul> <p>\u6240\u4ee5\u8fd9\u65f6\u6211\u4eec\u5c31\u9700\u8981\u9605\u8bfb\u851a\u84dd\u7684\u4ee3\u7801\u6765\u4e86\u89e3\u8fd9\u4e9b\u4e1c\u897f. \u5f53\u7136, \u851a\u84dd\u662f\u4e2a\u5546\u4e1a\u6e38\u620f, \u60f3\u6307\u671b\u5b83\u5f00\u6e90\u6240\u6709\u4ee3\u7801\u662f\u4e0d\u53ef\u80fd\u7684, \u90a3\u6211\u4eec\u5c31\u5fc5\u987b\u5f97\u501f\u52a9\u4e00\u4e9b\u53cd\u7f16\u8bd1\u5de5\u5177. \u5728\u8fd9\u91cc\u6211\u4f1a\u63a8\u8350 <code>dnSpy</code></p> <p>\u4f7f\u7528\u8be5\u8f6f\u4ef6\u5f88\u7b80\u5355:</p> <ul> <li>\u6253\u5f00\u5b83</li> <li>\u70b9\u51fb\u5de6\u4e0a\u89d2\u7684<code>\u6587\u4ef6</code>, <code>\u6253\u5f00</code></li> <li>\u9009\u62e9 <code>Celeste.exe</code></li> <li>\u5c55\u5f00\u851a\u84dd\u7684\u7a0b\u5e8f\u96c6</li> <li>\u4f60\u73b0\u5728\u53ef\u4ee5\u770b\u5230\u851a\u84dd\u90fd\u6709\u54ea\u4e9b\u7c7b\u4e86</li> <li>\u4f60\u73b0\u5728\u4e5f\u53ef\u4ee5\u770b\u5230\u851a\u84dd\u90fd\u6709\u54ea\u4e9b\u51fd\u6570\u4e86</li> </ul> <p>Warning</p> <p>\u4e0d\u8981\u4e0a\u4f20\u53cd\u7f16\u8bd1\u540e\u7684\u4ee3\u7801\u5230\u4efb\u4f55\u5730\u65b9, \u8fd9\u53ef\u80fd\u4f1a\u4e0d\u907f\u514d\u7684\u9020\u6210\u4e00\u4e9b\u4e89\u8bae.</p> <p>\u73b0\u5728\u6211\u4eec\u6d4f\u89c8\u851a\u84dd\u7684\u4ee3\u7801\u5c31\u50cf\u4f60\u5728 IDE \u91cc\u6d4f\u89c8\u4f60\u7684\u9879\u76ee\u4e00\u6837, \u867d\u7136\u8fd9\u4e0d\u662f\u6211\u4eec\u7684\u9879\u76ee. \u5728\u6d4f\u89c8\u8fc7\u7a0b\u4e2d, \u901a\u5e38\u53ef\u80fd\u4f60\u4f1a\u5bf9\u7740\u4e00\u4e2a\u5b57\u6bb5\u3001\u4e00\u4e2a\u51fd\u6570\u53d1\u5446, \u5927\u6982\u662f\u56e0\u4e3a\u4f60\u6839\u672c\u4e0d\u77e5\u9053\u5b83\u662f\u505a\u4ec0\u4e48\u7684! \u597d\u5728 <code>dnSpy</code> \u63d0\u4f9b\u4e86\u4e00\u4e2a\u5f88\u597d\u7528\u7684\"\u5206\u6790\"\u529f\u80fd\u6765\u7f13\u89e3\u8fd9\u4e2a :  \u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u770b\u5230\u54ea\u4e9b\u5b57\u6bb5\u3001\u54ea\u4e9b\u51fd\u6570\u88ab\u8c01\u8c03\u7528\u4e86\u3001\u88ab\u8c01\u5f15\u7528\u4e86\u3001\u88ab\u8c01\u66f4\u6539\u4e86:  </p>"},{"location":"begin/hook%2Creading_1/#monocle-ec","title":"Monocle, EC \u67b6\u6784","text":"<p>\u5728\u8fd9\u91cc\u6211\u4f1a\u7b80\u5355\u4ecb\u7ecd\u4e00\u4e0b\u6574\u4e2a\u851a\u84dd\u662f\u600e\u4e48\u7ec4\u7ec7\u8d77\u6765\u7684. \u9996\u5148\u851a\u84dd\u57fa\u4e8e <code>Monocle</code> \u5f15\u64ce, \u8fd9\u662f <code>matt</code> \u81ea\u5df1\u5f00\u53d1\u7684\u4e00\u4e2a\u5f15\u64ce, \u6240\u4ee5\u522b\u6307\u671b\u4f60\u80fd\u5728\u7f51\u4e0a\u627e\u5230\u5b83\u7684\u6559\u7a0b(, \u5176\u6b21 <code>Monocle</code> \u518d\u6b21\u4f9d\u8d56 <code>Monogame</code> \u6216\u8005 <code>FNA</code>, \u5b83\u4eec\u90fd\u662f\u5fae\u8f6f\u7684 <code>XNA</code> \u6846\u67b6\u7684\u91cd\u65b0\u5b9e\u73b0(\u56e0\u4e3a <code>XNA</code> \u65e9\u505c\u66f4\u4e86), <code>XNA</code> \u63d0\u4f9b\u7684 api \u90fd\u975e\u5e38\u539f\u59cb, \u751a\u81f3\u8fde\u6700\u57fa\u672c\u7684\u573a\u666f\u7ec4\u7ec7\u4e4b\u7c7b\u7684\u90fd\u6ca1\u6709, \u90a3\u4e48 <code>Monocle</code> \u5c31\u662f\u6765\u5b9e\u73b0\u8fd9\u4e9b\u7684.  </p> <p>\u901a\u5e38\u6765\u8bf4\u4e00\u4e2a\u6b63\u5728\u8fd0\u884c\u7684 <code>Monocle</code> \u6e38\u620f\u7684\u7ed3\u6784\u5c31\u50cf: <pre><code>graph LR\nR[Engine] --- A;\n\nA[Scene] --- B[Entity A];\nA --- C[Entity B];\nA --- E[Entity ...];\nB --- F[Component A];\nB --- G[Component B];\nC --- H[Component A];\nC --- I[Component C];\nC --- J[Component ...];</code></pre></p> <ul> <li><code>Scene</code> \u8868\u793a\u4e00\u4e2a\u573a\u666f, \u6bd4\u5982\u4e3b\u754c\u9762\u573a\u666f, pico8 \u573a\u666f, \u4ee5\u53ca\u6700\u5e38\u89c1\u7684 gameplay \u573a\u666f.  </li> <li><code>Entity</code> \u8868\u793a\u4e00\u4e2a\u5b9e\u4f53, \u6bd4\u5982\u8bf4\u739b\u5fb7\u7433\u5c31\u662f\u4e00\u4e2a\u5b9e\u4f53, \u4e00\u4e2a\u5f39\u7403\u662f\u4e00\u4e2a\u5b9e\u4f53, \u4e00\u4e2a\u6ce1\u6ce1\u662f\u4e00\u4e2a\u5b9e\u4f53.</li> <li><code>Component</code> \u8868\u793a\u4e00\u4e2a\u7ec4\u4ef6, \u5b83\u9644\u52a0\u4e0e\u5b9e\u4f53\u4e4b\u4e0a, \u901a\u5e38\u6211\u4eec\u80fd\u76f4\u63a5\u770b\u5230\u7684\u53ea\u6709\u56fe\u7247\u7ec4\u4ef6, \u6bd4\u5982\u5ca9\u6d46\u5757\u7684\u8d34\u56fe\u5c31\u662f\u7531 <code>Image</code> \u7ec4\u4ef6\u6765\u5c55\u73b0\u7684, \u73a9\u5bb6\u7684\u52a8\u753b\u7531 <code>Sprite</code> \u7ec4\u4ef6\u5c55\u73b0.  </li> </ul> <p>Info</p> <p>\u4ee5\u4e0a\u8fd9\u4e2a\u67b6\u6784\u6211\u4eec\u5c31\u79f0\u4e3a <code>EC</code> \u67b6\u6784, \u5b83\u662f\u6e38\u620f\u7684\u4e00\u79cd\u7ec4\u7ec7\u65b9\u5f0f\u7684\u5b9e\u73b0.  </p> <p>\u901a\u5e38\u5730, \u6bcf\u8fc7 <code>1/60</code> \u79d2, <code>Engine</code> \u5c31\u4f1a\u88ab\u8c03\u7528\u5b83\u7684 <code>Update()</code> \u51fd\u6570\u7528\u6765\u66f4\u65b0\u6e38\u620f\u903b\u8f91, <code>Engine.Update()</code> \u5185\u90e8\u4f1a\u518d\u6b21\u8c03\u7528 <code>Scene</code> \u7684 <code>Update()</code> \u51fd\u6570, <code>Scene.Update()</code> \u5185\u90e8\u4f1a\u904d\u5386\u5b83\u6240\u6709\u7684 <code>Entity</code> \u5e76\u8c03\u7528\u5b83\u4eec\u7684 <code>Update()</code> \u51fd\u6570, <code>Entity.Update()</code> \u5185\u90e8\u8fd8\u4f1a\u904d\u5386\u5b83\u6240\u6709\u7684 <code>Component</code> \u5e76\u8c03\u7528\u5b83\u4eec\u7684 <code>Update()</code> \u51fd\u6570.  </p> <p>\u90a3\u4e48\u81ea\u7136, <code>Player.Update()</code> \u5c31\u662f\u739b\u5fb7\u7433\u6bcf\u5e27\u7684\u66f4\u65b0\u903b\u8f91\u6240\u5728\u7684\u5730\u65b9\u4e86. \u73b0\u5728\u6211\u4eec\u505a\u4e00\u4e2a\u5c0f demo, \u5c06\u73a9\u5bb6\u7684\u51b2\u523a\u6570\u91cf\u9501\u6b7b\u4e3a\u5355\u51b2.  </p>"},{"location":"begin/hook%2Creading_1/#-demo1","title":"\u9501\u5b9a\u5355\u51b2 - demo1","text":"<p>\u901a\u8fc7\u7b80\u5355\u7684\u6d4f\u89c8\u851a\u84dd\u7684\u4ee3\u7801, \u4f60\u4e86\u89e3\u5230(\u6ca1\u4e86\u89e3\u5230\u4e5f\u6b63\u5e38, \u540e\u9762\u4f1a\u8bf4\u4e00\u4e9b\u5e38\u89c1\u7c7b\u548c\u7ed3\u6784\u5e2e\u52a9\u4f60\u7406\u89e3) <code>Player.Dashes</code> \u8fd9\u4e2a\u5b57\u6bb5\u50a8\u5b58\u4e86\u73a9\u5bb6\u7684\u51b2\u523a\u6570\u91cf, \u90a3\u4e48\u73b0\u5728\u6211\u4eec\u5c06\u5b83\u9501\u5b9a\u4e3a 1, \u4e5f\u5c31\u662f\u5355\u51b2. \u9996\u5148\u6211\u4eec\u94a9\u53d6 <code>Player.Update()</code>, \u7136\u540e\u5728\u786e\u4fdd\u8c03\u7528\u56de\u539f\u6765\u7684\u51fd\u6570\u540e\u76f4\u63a5\u5c06 <code>Dashes</code> \u5f3a\u5236\u4fee\u6539\u4e3a 1.</p> \u9501\u5b9a\u51b2\u523a\u4e3a1!<pre><code>public override void Load()\n{\n    On.Celeste.Player.Update += Player_Update;\n}\n\nprivate void Player_Update(On.Celeste.Player.orig_Update orig, Player self)\n{\n    self.Dashes = 1;\n    orig(self);\n}\n\npublic override void Unload()\n{\n    On.Celeste.Player.Update -= Player_Update;\n}\n</code></pre> <p>\u90a3\u4e48\u73b0\u5728\u7f16\u8bd1, \u6309\u4e4b\u524d\u7684\u5185\u5bb9\u64cd\u4f5c, \u5e76\u91cd\u542f\u851a\u84dd, \u4f60\u5e94\u8be5\u5c31\u4f1a\u770b\u5230\u4f60\u7684\u739b\u5fb7\u7433\u6c38\u8fdc\u90fd\u4f1a\u6709\u5355\u51b2\u4e86(\u5373\u4f7f\u662f\u5728\u7a7a\u4e2d!).</p>"},{"location":"begin/hook%2Creading_1/#_2","title":"\u94a9\u5b50\u7684\u6700\u4f73\u5b9e\u8df5","text":"<p>\u6211\u4eec\u5e94\u8be5\u5c3d\u53ef\u80fd\u4e00\u6b21\u6027\u5730\u5c31\u5c06\u6211\u4eec\u6240\u9700\u8981\u7684\u6240\u6709\u94a9\u5b50\u5728 <code>Load</code> \u91cc\u52a0\u8f7d\u5b8c, \u56e0\u4e3a\u521b\u5efa\u94a9\u5b50\u5b9e\u9645\u4e0a\u7684\u5f00\u9500\u5e76\u4e0d\u5c0f, \u5982\u679c\u4f60\u9700\u8981\u67d0\u4e9b \"\u67d0\u4e9b\u6761\u4ef6\u4e0d\u6210\u7acb\u4e0d\u542f\u52a8\u94a9\u5b50, \u6761\u4ef6\u6210\u7acb\u518d\u542f\u52a8\u94a9\u5b50\" \u7684\u903b\u8f91\u7684\u8bdd, \u6211\u5efa\u8bae\u4f60\u5e94\u8be5\u59cb\u7ec8\u4fdd\u6301\u94a9\u5b50, \u7136\u540e\u5728\u94a9\u5b50\u5185\u90e8\u5224\u65ad\u4f60\u7684\u6761\u4ef6, \u4e0d\u6210\u7acb\u65f6\u4f60\u5e94\u8be5\u76f4\u63a5\u56de\u8c03\u539f\u6765\u7684\u65b9\u6cd5\u5e76\u4e0d\u505a\u4efb\u4f55\u5176\u4ed6\u4e8b\u60c5.</p>"},{"location":"begin/preference/","title":"\u504f\u597d","text":"<p>\u5728\u672c\u7cfb\u5217\u6559\u7a0b\u4e2d\u672c\u4eba\u53ef\u80fd\u4f1a\u5076\u5c14\u4e60\u60ef\u6027\u7684\u4f7f\u7528\u4e00\u4e9b\u6bd4\u8f83\u65b0\u7684 C# \u8bed\u6cd5\u6216\u8005\u662f\u7279\u6027, \u901a\u5e38\u8fd9\u662f\u5927\u90e8\u5206 C# \u6559\u7a0b\u4e2d\u5f88\u5c11\u63d0\u53ca\u7684, \u6240\u4ee5\u4e3a\u4e86\u907f\u514d\u56f0\u60d1\u6211\u4f1a\u5728\u8fd9\u91cc\u63d0\u53ca\u4ed6\u4eec.</p> <p>Note</p> <p>\u4e3a\u4e86\u4f7f\u7528\u8fd9\u4e9b\u8bed\u6cd5\u4f60\u53ef\u80fd\u9700\u8981\u5b89\u88c5 <code>.NET 6 SDK</code>, \u5982\u679c\u4f60\u65e0\u6cd5\u7406\u89e3\u67d0\u4e9b\u4e1c\u897f, \u6ca1\u5173\u7cfb, \u4f60\u4f9d\u7136\u53ef\u4ee5\u4f7f\u7528\u540c\u65f6\u63d0\u53ca\u5230\u7684\u7b49\u6548\u65b9\u6cd5</p>"},{"location":"begin/preference/#_2","title":"\u7b80\u5355\u4e86\u89e3\u9879\u76ee\u6587\u4ef6","text":"<p>\u5728\u89e3\u51b3\u65b9\u6848\u8d44\u6e90\u7ba1\u7406\u5668\u4e2d, \u53cc\u51fb\u4f60\u7684\u9879\u76ee, \u6309\u7406\u6765\u8bf4\u4f60\u5e94\u8be5\u4f1a\u6253\u5f00\u8be5\u9879\u76ee\u7684 <code>.csproj</code> \u6587\u4ef6, \u901a\u5e38\u4e5f\u53eb\u505a\u9879\u76ee\u6587\u4ef6, \u5b83\u63cf\u8ff0\u4e86\u8fd9\u4e2a\u9879\u76ee\u7684\u5404\u65b9\u9762\u7684\u4fe1\u606f, \u5e76\u4e14\u4ee5\u4e0b\u51e0\u5c0f\u8282\u7684\u5185\u5bb9\u4e5f\u4f9d\u8d56\u4e8e\u6b64. \u5982\u679c\u4f60\u4f7f\u7528\u7684\u662f\u4ece\u6a21\u677f\u914d\u7f6e\u7684\u73af\u5883, \u90a3\u4e48\u4f60\u5e94\u8be5\u4f1a\u770b\u5230\u5982\u4e0b\u5185\u5bb9:</p> .csproj<pre><code>&lt;Project Sdk=\"Microsoft.NET.Sdk\"&gt;\n    &lt;Import Project=\"CelesteMod.props\" /&gt;\n    &lt;Import Project=\"Common.props\" /&gt;\n    &lt;PropertyGroup&gt;\n        &lt;RootNamespace&gt;$(AssemblyName)&lt;/RootNamespace&gt;\n        &lt;LangVersion&gt;preview&lt;/LangVersion&gt;\n    &lt;/PropertyGroup&gt;\n\n    &lt;ItemGroup&gt;\n        &lt;Reference Include=\"System\" /&gt;\n        &lt;Reference Include=\"System.Core\" /&gt;\n        &lt;Reference Include=\"System.Xml.Linq\" /&gt;\n        &lt;Reference Include=\"System.Xml\" /&gt;\n    &lt;/ItemGroup&gt;\n\n    &lt;Import Project=\"CelesteMod.targets\" /&gt;\n&lt;/Project&gt;\n</code></pre> <p>Note</p> <p>\u8fd9\u4e2a\u6587\u4ef6\u662f XML \u683c\u5f0f\u7684, \u5982\u679c\u4f60\u4e0d\u719f\u6089 XML \u7684\u8bdd\u4f60\u53ef\u4ee5\u5230\u8fd9\u91cc\u7b80\u5355\u770b\u4e00\u4e0b, \u514d\u5f97\u4f60\u4e0d\u77e5\u9053\u6211\u4eec\u8ba8\u8bba\u7684\u4e1c\u897f\u90fd\u662f\u4ec0\u4e48</p> <p>\u5176\u4e2d\u6211\u4eec\u53ea\u9700\u8981\u5173\u6ce8\u91cc\u9762\u7684 <code>PropertyGroup</code> \u4ee5\u53ca <code>ItemGroup</code> \u8282\u70b9 <code>PropertyGroup</code> \u8282\u70b9\u5b9a\u4e49\u4e86\u8fd9\u4e2a\u9879\u76ee\u6709\u54ea\u4e9b\u5c5e\u6027, \u6bd4\u5982\u9879\u76ee\u6846\u67b6\u7248\u672c, \u8bed\u8a00\u7248\u672c, \u7a0b\u5e8f\u96c6\u6635\u79f0\u7b49 <code>ItemGroup</code> \u5219\u5b9a\u4e49\u4e86\u8fd9\u4e2a\u9879\u76ee\u5305\u542b\u4ec0\u4e48, \u6bd4\u5982\u5f15\u7528\u4e86\u54ea\u4e9b\u7a0b\u5e8f\u96c6\u3001\u54ea\u4e9b nuget \u5305\u7b49.</p>"},{"location":"begin/preference/#implicit-usings-using","title":"Implicit Usings (\u9690\u5f0f Using)","text":"<p>Note</p> <p>\u5bf9\u4e8e\u901a\u8fc7\u6a21\u677f\u6784\u5efa\u7684\u9879\u76ee\u6765\u8bf4\u8fd9\u4e00\u6b65\u5df2\u7ecf\u5b8c\u6210, \u4f60\u53ef\u4ee5\u5c1d\u8bd5\u5c06 <code>Common.props</code> \u4e2d\u7684 <code>CommonCelesteUsings</code> \u66f4\u6539\u4e3a <code>false</code> \u6765\u611f\u53d7\u6ca1\u6709\u542f\u7528\u7684\u6548\u679c</p> <p>\u73b0\u5728\u770b\u770b\u4f60\u7684\u6e90\u6587\u4ef6\u5934\u9876\u662f\u4e0d\u662f\u5145\u6ee1\u4e86\u4e00\u5927\u5806 <code>using xxx</code>? \u90a3\u5c31\u5bf9\u4e86, \u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd9\u4e2a\u7279\u6027\u6765\u8ba9\u5b83\u770b\u8d77\u6765\u66f4\u7b80\u4ecb\u4e9b. \u90a3\u4e48\u6253\u5f00\u4f60\u7684\u9879\u76ee\u6587\u4ef6, \u5411\u4f60\u7684 <code>ItemGroup</code> \u4e2d\u52a0\u5165\u8fd9\u4e9b:</p> <pre><code>&lt;Using Include=\"System\"/&gt;\n&lt;Using Include=\"System.Collections.Generic\"/&gt;\n&lt;Using Include=\"System.IO\"/&gt;\n&lt;Using Include=\"System.Linq\"/&gt;\n&lt;Using Include=\"System.Threading\"/&gt;\n&lt;Using Include=\"System.Threading.Tasks\"/&gt;\n</code></pre> <p>\u8fd9\u4e2a\u65f6\u5019\u4f60\u5c31\u53ef\u4ee5\u79fb\u9664\u4f60\u7684\u5927\u90e8\u5206 <code>System</code> \u5f00\u5934\u7684 Using \u8bed\u53e5\u5566, \u8fd9\u88ab\u79f0\u4e3a <code>\u9690\u5f0f Using</code>, \u56e0\u4e3a\u6211\u4eec\u662f\u851a\u84dd mod, \u6240\u4ee5\u6211\u4eec\u7ecf\u5e38\u4e5f\u4f1a Using \u4ee5\u4e0b\u51e0\u4e2a\u547d\u540d\u7a7a\u95f4:</p> <ul> <li><code>Celeste.Mod</code>: \u5305\u542b\u5f88\u591a Everest \u76f8\u5173\u4e1c\u897f</li> <li><code>Celeste</code>: \u851a\u84dd\u672c\u4f53\u6240\u5728\u547d\u540d\u7a7a\u95f4</li> <li><code>Monocle</code>: \u851a\u84dd\u81ea\u5df1\u7684\u6e38\u620f\u5f15\u64ce</li> <li><code>Microsoft.Xna.Framework</code>: \u851a\u84dd\u81ea\u5df1\u7684\u6e38\u620f\u5f15\u64ce\u7684\u5e95\u5c42\u6846\u67b6</li> </ul> <p>\u5bf9\u8fd9\u4e9b\u9690\u5f0f Using \u6211\u4eec\u4e5f\u5411 <code>ItemGroup</code> \u52a0\u5165: <pre><code>&lt;Using Include=\"Celeste.Mod\"/&gt;\n&lt;Using Include=\"Celeste\"/&gt;\n&lt;Using Include=\"Monocle\"/&gt;\n&lt;Using Include=\"Microsoft.Xna.Framework\"/&gt;\n</code></pre></p> <p>\u73b0\u5728\u6253\u5f00\u4f60\u7684\u4ee3\u7801\u6587\u4ef6, \u4f60\u53ef\u4ee5\u5c06\u5934\u9876\u4e0a\u7684\u5927\u90e8\u5206 Using \u90fd\u5220\u9664\u4e86, \u8fd9\u6837, \u4f60\u7684\u4ee3\u7801\u6587\u4ef6\u53d8\u7684\u66f4\u52a0\u7684\u5e72\u51c0\u6574\u6d01: MyModModule.cs<pre><code>namespace MyCelesteMod\n{\n    public class MyModModule : EverestModule\n    {\n        public override void Load()\n        {\n\n            Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World! Hello Everest!\");\n        }\n\n        public override void Unload()\n        {\n\n        }\n    }\n}\n</code></pre></p>"},{"location":"begin/preference/#file-scoped-namespaces","title":"File Scoped Namespaces","text":"<p>\u5bf9\u4e8e namespace \u547d\u540d\u7a7a\u95f4\u6765\u8bf4\u6211\u4eec\u901a\u5e38\u4e00\u4e2a\u6587\u4ef6\u53ea\u6709\u4e00\u4e2a\u547d\u540d\u7a7a\u95f4, \u90a3\u4e48\u6700\u5916\u5c42\u7684 namespace \u7684\u7f29\u8fdb\u5c31\u6709\u4e9b\u6d6a\u8d39\u6a2a\u5411\u7a7a\u95f4, \u6240\u4ee5\u6211\u4eec\u9009\u62e9\u4f7f\u7528 <code>File Scoped Namespaces</code>, \u8fd9\u5f88\u7b80\u5355:</p> <ul> <li>\u5728 <code>namespace MyCelesteMod</code> \u540e\u52a0\u4e0a\u4e00\u4e2a\u5206\u53f7</li> <li>\u5220\u9664 namespace \u7684\u4e24\u4e2a\u5927\u62ec\u53f7</li> <li>\u56de\u9000 namespace \u4e0b\u7684\u6240\u6709\u7f29\u8fdb</li> <li>\u641e\u5b9a\u4e86, \u8d70\u4f60!</li> </ul> MyModModule.cs<pre><code>namespace MyCelesteMod;\n\npublic class MyModModule : EverestModule\n{\n    public override void Load()\n    {\n        Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World! Hello Everest!\");\n    }\n\n    public override void Unload()\n    {\n\n    }\n}\n</code></pre> <p>\u5982\u679c\u4f60\u6536\u5230\u9519\u8bef <code>CS8370</code>, \u90a3\u4f60\u5c31\u9700\u8981\u5728 <code>PropertyGroup</code> \u4e0b\u6dfb\u52a0\u8fd9\u4e00\u884c: <pre><code>&lt;LangVersion&gt;preview&lt;/LangVersion&gt;\n</code></pre></p>"},{"location":"begin/preference/#_3","title":"\u65b9\u6cd5? \u51fd\u6570?","text":"<p>\u55ef\u8fd9\u4e2a\u662f\u540e\u6765\u52a0\u7684, \u56e0\u4e3a\u6211\u53d1\u73b0\u6211\u5728\u6574\u4e2a\u6587\u6863\u91cc\u90fd\u5728\u6df7\u7528\"\u65b9\u6cd5\"\u548c\"\u51fd\u6570\"\u8fd9\u4e24\u4e2a\u540d\u5b57, \u4f46\u662f\u4fee\u6539\u8d77\u6765\u6bd4\u8f83\u9ebb\u70e6\u6240\u4ee5\u6211\u8fd8\u662f\u9009\u62e9\u5728\u8fd9\u91cc\u8bf4\u51e0\u53e5: \"\u51fd\u6570\"\u662f\u6e90\u81ea\u53e4\u65e9\u7684\u9762\u5411\u8fc7\u7a0b\u8bed\u8a00\u7684\u6982\u5ff5, \u540e\u6765\u968f\u7740 OOP \u9762\u5411\u5bf9\u8c61\u601d\u60f3\u7684\u6d41\u884c, \u51fd\u6570\u9010\u6e10\u88ab\u5c01\u88c5\u5230\u7c7b\u91cc, \u800c\u7c7b\u91cc\u7684\u8fd9\u4e9b\u51fd\u6570\u5728\u4e60\u60ef\u4e0a\u6211\u4eec\u4f1a\u79f0\u4e4b\u4e3a\"\u65b9\u6cd5\", \u4f46\u662f\u4e5f\u6709\u4eba\u4ecd\u7136\u5c06\u8fd9\u4e9b\u4e1c\u897f\u79f0\u4e4b\u4e3a\"\u51fd\u6570\", \u6240\u4ee5\u5b9e\u9645\u4e0a\u5728\u9762\u5411\u5bf9\u8c61\u7684\u8bed\u8a00\u91cc\u4f60\u53ef\u4ee5\u5c06\"\u65b9\u6cd5\"\u548c\"\u51fd\u6570\"\u770b\u4e3a\u4e00\u4e2a\u4e1c\u897f, \u6216\u8005\u4ec5\u5728\u672c\u6587\u6863\u4e2d\u8fd9\u4e48\u770b.</p>"},{"location":"begin/reading_2/","title":"\u9605\u8bfb\u4ee3\u7801 II","text":"<p>\u4e00\u4e9b\u60c5\u51b5\u4e0b, \u9605\u8bfb\u7531\u53cd\u7f16\u8bd1\u5668\u751f\u6210\u7684\u4ee3\u7801\u65f6\u53ef\u80fd\u4e0d\u662f\u90a3\u4e48\u987a\u5229, \u90a3\u4e48\u8fd9\u4e00\u8282\u4f1a\u7b80\u5355\u8bf4\u4e00\u4e9b\u53cd\u7f16\u8bd1\u5668\u751f\u6210\u7684\u4ee3\u7801\u4e0e\u901a\u5e38\u7684 C# \u4ee3\u7801\u4e0d\u4e00\u6837\u7684\u5730\u65b9.</p>"},{"location":"begin/reading_2/#_1","title":"\u5947\u5947\u602a\u602a\u7684\u6635\u79f0\u4e0e\u4ee3\u7801","text":"<p>\u5728\u53cd\u7f16\u8bd1\u5668\u4e2d\u53ef\u80fd\u4f1a\u51fa\u73b0\u8fd9\u79cd\u5947\u602a\u7684\u8bed\u6cd5: Celeste.FinalBoss (\u5373 6a \u540e\u534a\u6bb5 Badeline Boss \u5b9e\u4f53)<pre><code>public void orig_ctor(EntityData e, Vector2 offset)\n{\n    this..ctor(e.Position + offset, e.NodesOffset(offset), e.Int(\"patternIndex\", 0), e.Float(\"cameraPastY\", 120f), e.Bool(\"dialog\", false), e.Bool(\"startHit\", false), e.Bool(\"cameraLockY\", true));\n}\n</code></pre></p> <p>\u55ef...\u597d\u7684, \u9996\u5148 <code>orig_ctor</code> \u8fd9\u4e2a\u540d\u5b57\u6709\u70b9\u602a\u4f46\u662f\u80fd\u63a5\u53d7, \u4f46\u662f\u63a5\u4e0b\u6765\u7684 <code>this..ctor</code> \u662f\u4ec0\u4e48? \u5b83\u751a\u81f3\u5728 <code>C#</code> \u4e2d\u662f\u4e2a\u975e\u6cd5\u8bed\u6cd5! \u5176\u5b9e\u8fd9\u5e76\u4e0d\u7f55\u89c1, \u7531\u4e8e Everest \u5bf9\u851a\u84dd\u7a0b\u5e8f\u7684\u4fee\u6539\u5e76\u4e0d\u53ea\u662f\u505c\u7559\u5728\u8868\u9762, \u800c\u66f4\u662f\u6df1\u5165\u5230\u4e86 IL \u4ee3\u7801\u5c42, \u8fd9\u662f\u4e00\u79cd\u76f8\u5bf9\u5e95\u5c42\u7684\u4ee3\u7801, \u4f60\u7684 <code>C#</code> \u4ee3\u7801\u6700\u7ec8\u90fd\u4f1a\u88ab\u7f16\u8bd1\u4e3a <code>IL</code> \u7136\u540e\u6254\u7ed9\u8fd0\u884c\u65f6(runtime)\u6765\u6267\u884c, \u540c\u6837\u5730, \u6240\u6709\u5176\u4ed6\u7684 <code>.NET</code> \u7cfb\u8bed\u8a00\u6bd4\u5982 <code>VB.NET</code> \u548c <code>F#</code> \u4e5f\u90fd\u4f1a\u88ab\u7f16\u8bd1\u4e3a IL. \u90a3\u4e48\u65e2\u7136\u8fd9\u91cc\u7684 IL \u662f\u7531 <code>C#</code> \u7f16\u8bd1\u800c\u6765\u7684, \u90a3\u4e48\u8fd9\u6837\u7684 IL \u591a\u591a\u5c11\u5c11\u4f1a\u6709\u4e00\u79cd \"C# \u5473\", \u53cd\u7f16\u8bd1\u5668\u5c31\u662f\u9760\u8fd9\u79cd\u4e00\u5b9a\u7684 \"C# \u5473\" \u6765\u9006\u63a8\u51fa\u53ef\u80fd\u7684 <code>C#</code> \u6e90\u7801.  \u4f46\u662f\u65e2\u7136\u8fd9\u91cc Everest \u76f4\u63a5\u5728 IL \u4ee3\u7801\u5c42\u8fdb\u884c\u4e86\u4fee\u6539, \u7834\u574f\u4e86\u8fd9\u79cd \"C# \u5473\", \u90a3\u81ea\u7136\u53cd\u7f16\u8bd1\u5668\u5c31\u4f1a\u751f\u6210\u5947\u5947\u602a\u602a\u7684\u4ee3\u7801.</p> <p>\u90a3\u4e48\u539f\u56e0\u8bf4\u5b8c\u4e86, \u63a5\u4e0b\u6765\u5c31\u6765\u89e3\u51b3\u8fd9\u4e9b \"\u662f\u4ec0\u4e48\" \u7684\u95ee\u9898:</p>"},{"location":"begin/reading_2/#ctor-cctor","title":".ctor / .cctor","text":"<p><code>.ctor</code> \u662f\u4e00\u79cd\u7279\u6b8a\u7684\u51fd\u6570\u540d\u79f0, \u8868\u793a\u7c7b\u7684\u6784\u9020\u51fd\u6570, \u6bd4\u5982 <code>Player..ctor(a, b)</code> \u5c31\u8868\u793a\u8fd9\u91cc\u8c03\u7528\u4e86 <code>Player..ctor</code> \u8fd9\u4e2a\u51fd\u6570, \u867d\u7136\u4f60\u81ea\u5df1\u5728 C# \u4e2d\u662f\u505a\u4e0d\u5230\u7684. \u6240\u4ee5\u6211\u4eec\u7ecf\u5e38\u4e5f\u4f1a\u7528 <code>ctor</code> \u6216\u8005 <code>.ctor</code> \u6765\u6307\u4ee3 \"\u6784\u9020\u51fd\u6570\".  </p> <p><code>.cctor</code> \u4e5f\u662f\u4e00\u79cd\u7279\u6b8a\u7684\u51fd\u6570\u540d\u79f0, \u8868\u793a\u7c7b\u7684\u9759\u6001\u6784\u9020\u51fd\u6570, \u6bd4\u5982 <code>Input..cctor()</code> \u5c31\u8868\u793a\u8c03\u7528 <code>Input</code> \u7c7b\u7684\u65e0\u53c2\u9759\u6001\u6784\u9020\u51fd\u6570. \u540c\u6837\u5730\u6211\u4eec\u901a\u5e38\u4e5f\u4f1a\u7528 <code>cctor</code> \u6216\u8005 <code>.cctor</code> \u6765\u6307\u4ee3 \"\u9759\u6001\u6784\u9020\u51fd\u6570\".</p> <p>\u8fd9\u4e00\u7c7b\u51fd\u6570\u5728 <code>IL</code> \u5c42\u6709\u4e2a\u6807\u8bb0\u53eb <code>special name</code>, \u5f53\u53cd\u7f16\u8bd1\u5668\u53d1\u73b0\u4e00\u4e2a\u65b9\u6cd5\u540d\u4e3a <code>.ctor</code> \u4e14\u5e26\u6709 <code>special name</code> \u6807\u8bb0\u7684\u65b9\u6cd5\u65f6, \u53cd\u7f16\u8bd1\u5668\u5c31\u4f1a\u8ba4\u4e3a\u5b83\u662f\u4e00\u4e2a\u6784\u9020\u51fd\u6570, \u5982\u679c\u53cd\u7f16\u8bd1\u5668\u53d1\u73b0\u8fd9\u4e2a\u65b9\u6cd5\u5728\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u5f00\u5934\u8c03\u7528\u4e86, \u90a3\u4e48\u53cd\u7f16\u8bd1\u5668\u5c31\u4f1a\u8ba4\u4e3a\u8fd9\u4e2a\u6784\u9020\u51fd\u6570\u5e26\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u94fe, \u4f46\u662f\u5982\u679c\u5b83\u7684\u8c03\u7528\u4f4d\u7f6e\u5728\u5176\u4ed6\u4f4d\u7f6e, \u540c\u65f6\u53c8\u56e0\u4e3a <code>C#</code> \u7f16\u8bd1\u5668\u662f\u4e0d\u53ef\u80fd\u7f16\u8bd1, \u90a3\u4e48\u53cd\u7f16\u8bd1\u5668\u5c31\u4f1a\u4e0d\u77e5\u6240\u63aa, \u53ea\u80fd\u65e0\u5948\u7684\u751f\u6210 <code>xxx..ctor()</code> \u8fd9\u79cd\u9519\u8bef\u7684\u8bed\u6cd5. \u8fd9\u4e5f\u662f\u6211\u4eec\u4e0a\u9762\u770b\u5230\u7684 <code>this..ctor</code> \u8fd9\u79cd\u8bed\u6cd5\u88ab\u751f\u6210\u7684\u539f\u56e0, \u56e0\u4e3a\u8fd9\u4e2a\u6784\u9020\u51fd\u6570\u8c03\u7528\u4e0d\u5728\u6784\u9020\u51fd\u6570\u91cc\u51fa\u73b0, \u800c\u662f\u5728\u4e00\u4e2a\u6b63\u5e38\u7684 <code>orig_ctor</code> \u65b9\u6cd5\u91cc\u9762!</p> <p>Info</p> <p>\u5728\u524d\u9762\u7684\u94a9\u5b50\u8282\u6211\u4eec\u6ca1\u6709\u63a2\u8ba8\u8fc7\u6784\u9020\u51fd\u6570\u5982\u4f55\u94a9\u53d6, \u5728\u8fd9\u91cc\u4f60\u53ef\u80fd\u5c31\u4f1a\u660e\u767d, \u94a9\u53d6\u540d\u5b57\u4e3a <code>ctor</code> \u7684\u51fd\u6570\u5c31\u662f\u94a9\u53d6\u4e86\u6784\u9020\u51fd\u6570, \u9759\u6001\u6784\u9020\u51fd\u6570\u540c\u7406.</p>"},{"location":"begin/reading_2/#orig_","title":"orig_*","text":"<p>\u8fd8\u6709\u4e00\u4e9b\u51fd\u6570\u4ee5 <code>orig_</code> \u5f00\u5934, \u8fd9\u5176\u5b9e\u662f everest \u81ea\u5df1\"\u94a9\u53d6\"\u7684\u51fd\u6570. \u5728\u8fd9\u91cc, \u6bd4\u5982 <code>Player.Update</code> \u65b9\u6cd5\u5c31\u88ab everest \u8fdb\u884c\u4e86\"\u94a9\u53d6\", \u800c\u94a9\u5b50\u51fd\u6570\u672c\u4f53\u5c31\u662f <code>Player.Update</code>, \u800c\u5bf9\u5e94\u6211\u4eec\u94a9\u5b50\u7684 <code>orig</code> \u59d4\u6258\u5728\u5c31\u4f53\u73b0\u4e3a <code>orig_Update</code> \u65b9\u6cd5.</p> Player.Update  (\u50cf\u94a9\u5b50\u672c\u4f53\u4e00\u6837!)<pre><code>public override void Update()\n{\n    this.orig_Update(); // \u5c31\u50cf\u5728\u6211\u4eec\u7684\u94a9\u5b50\u91cc\u8c03\u7528 orig \u59d4\u6258\u4e00\u6837\n    // \u5c31\u50cf\u5728\u6211\u4eec\u7684\u94a9\u5b50\u91cc\u5728\u51fd\u6570\u6267\u884c\u5b8c\u540e\u505a\u4e9b\u4e8b\u60c5\u4e00\u6837\n    Level level = base.Scene as Level;\n    if (level == null)\n    ......\n}\n// Player.orig_Update() \u5c31\u50cf\u6211\u4eec\u7684\u94a9\u5b50\u94a9\u53d6\u7684\u539f\u51fd\u6570!\n</code></pre> <p>Info</p> <p>\u5982\u679c\u4f60\u81ea\u884c\u94a9\u53d6 <code>Player.Update</code> \u51fd\u6570\u8fd9\u79cd\u5df2\u88ab everest \"\u94a9\u53d6\" \u7684\u51fd\u6570\u5b9e\u9645\u4e0a\u4f60\u94a9\u53d6\u7684\u662f everest \u7684\u94a9\u5b50, \u8fd9\u5bf9\u4e8e <code>On</code> \u94a9\u5b50\u53ef\u80fd\u6ca1\u6709\u5927\u5f71\u54cd, \u4f46\u662f\u5bf9\u4e8e\u540e\u9762\u6211\u4eec\u4f1a\u8bf4\u7684 <code>IL</code> \u94a9\u5b50\u6709\u5f88\u5927\u5f71\u54cd, \u4e0d\u8fc7\u8fd9\u4e9b\u6211\u4eec\u7b49\u5230\u540e\u9762\u518d\u8bf4.</p>"},{"location":"begin/reading_2/#statemachine","title":"StateMachine","text":"<p>\u8fd9\u662f Monocle \u4e2d\u7684\u4e00\u4e2a Component \u7c7b, \u662f\u4e00\u4e2a\u72b6\u6001\u673a\u7684\u5b9e\u73b0, \u5177\u4f53\u7684\u7528\u6cd5\u6211\u4f1a\u5728 \u5e38\u89c1 Celeste, Monocle \u7c7b<sub>\u5728\u5199\u4e86.jpg</sub> \u8282\u8bf4, \u8fd9\u91cc\u4ec5\u662f\u65b9\u4fbf\u4f60\u9605\u8bfb\u4e00\u4e0b\u76f8\u5173\u7684\u4ee3\u7801:</p>"},{"location":"begin/reading_2/#st","title":"<code>St*</code> \u7c7b\u5b57\u6bb5","text":"<p>\u5728\u9605\u8bfb <code>Player</code> \u7c7b\u7684\u4ee3\u7801\u65f6, \u4f60\u4f1a\u770b\u5230\u8fd9\u4e9b<code>St</code>\u5f00\u5934\u540d\u5b57\u7684\u5e38\u91cf\u4f46\u662f\u4f60\u627e\u4e0d\u5230\"\u88ab\u4f7f\u7528\"\u7684\u5730\u65b9:</p> <ul> <li>const int StNormal = 0;</li> <li>const int StClimb = 1;</li> <li>const int StDash = 2;</li> <li>const int StSwim = 3;</li> <li>const int StBoost = 4;</li> <li>......</li> </ul> <p>\u8fd9\u4e9b\u662f\u73a9\u5bb6\u72b6\u6001\u673a\u7684\u72b6\u6001\u7f16\u53f7, \u81f3\u4e8e\u4f60\u627e\u4e0d\u5230\"\u88ab\u4f7f\u7528\"\u662f\u56e0\u4e3a\u5bf9\u4e8e const \u5e38\u91cf\u6210\u5458, c# \u7f16\u8bd1\u5668\u5728\u7f16\u8bd1\u671f\u5c31\u628a\u5f15\u7528\u7684\u8fd9\u4e9b\u4e1c\u897f\u76f4\u63a5\u66ff\u6362\u4e3a\u4e86\u6570\u5b57, \u4f60\u80fd\u770b\u5230\u7684\u53ea\u6709\u4fdd\u7559\u4e0b\u6765\u7684\u8fd9\u4e9b\u5e38\u91cf\u7684\u503c\u548c\u540d\u5b57. \u90a3\u8fd9\u6837\u4ee3\u7801\u4e2d\u5c31\u4e0d\u907f\u514d\u7684\u51fa\u73b0\u4e86\u5947\u602a\u7684\u9b54\u6570, \u6bd4\u5982\u8fd9\u91cc\u7684 24: int Player.FlingBirdUpdate()<pre><code>private int FlingBirdUpdate()\n{\n    base.MoveTowardsX(this.flingBird.X, 250f * Engine.DeltaTime, null);\n    base.MoveTowardsY(this.flingBird.Y + 8f + base.Collider.Height, 250f * Engine.DeltaTime, null);\n    return 24;\n}\n</code></pre></p> <p>Info</p> <p>FlingBirdUpdate \u662f\u4e00\u4e2a\u72b6\u6001\u673a\u7684 Update \u51fd\u6570, \u6240\u6709\u8be5\u7c7b\u51fd\u6570\u7684\u8fd4\u56de\u503c\u8868\u793a\u4e0b\u4e00\u5e27\u73a9\u5bb6\u7684\u72b6\u6001\u5e94\u8be5\u662f\u4ec0\u4e48.</p> <p>\u4f60\u80af\u5b9a\u5f88\u7591\u60d1\u8fd9\u4e2a\u5947\u602a\u7684 24 \u662f\u4ec0\u4e48, \u8fd9\u91cc\u6211\u4eec\u5df2\u7ecf\u77e5\u9053\u5b83\u662f\u4e2a\u72b6\u6001\u673a\u7f16\u53f7\u4e86, \u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e0b\u8fd9\u4e2a\u7f16\u53f7\u5bf9\u5e94\u7684\u72b6\u6001. \u7ecf\u8fc7\u67e5\u8be2, \u4f60\u4f1a\u77e5\u9053\u7f16\u53f7\u4e3a 24 \u7684\u72b6\u6001\u662f <code>StFlingBird</code>, \u5373\u88ab\u9e1f\u6254\u72b6\u6001(\u7b26\u5408\u8fd9\u91cc\u7684\u51fd\u6570\u540d!):</p> <pre><code>const int StFlingBird = 24;\n</code></pre> <p>\u5728\u8fd9\u91cc\u4f1a\u7b80\u5355\u5217\u51fa\u4e00\u4e0b <code>Player</code> \u7684\u6240\u6709\u72b6\u6001\u4fbf\u4e8e\u67e5\u8be2:</p> <pre><code>const int StNormal = 0; // \u6b63\u5e38\nconst int StClimb = 1; // \u6500\u722c\nconst int StDash = 2; // \u51b2\u523a\nconst int StSwim = 3; // \u6c34\u4e2d\nconst int StBoost = 4; // \u7eff\u6ce1\u6ce1\u4e2d\nconst int StRedDash = 5; // \u7ea2\u6ce1\u6ce1\u4e2d\nconst int StHitSquash = 6; // \u88ab\u56fa\u4f53\u6324\u538b?\nconst int StLaunch = 7; // \u88ab \u5f39\u7403, \u9c7c \u5f39\u5f00\nconst int StPickup = 8; // \u6361\u8d77\u6293\u53d6\u7269\nconst int StDreamDash = 9; // \u7a7f\u679c\u51bb\nconst int StSummitLaunch = 10; // 7a, 7b \u4e0a\u5347\u8fc7\u573a\nconst int StDummy = 11; // \u5267\u60c5\u8fc7\u573a\u72b6\u6001\nconst int StIntroWalk = 12; // Walk \u7c7b\u578b\u7684 Intro (Intro \u5373\u73a9\u5bb6\u8fdb\u5165\u5173\u5361\u7684\u8868\u73b0\u65b9\u5f0f)\nconst int StIntroJump = 13; // Jump \u7c7b\u578b\u7684 Intro (1a)\nconst int StIntroRespawn = 14; // Respawn \u7c7b\u578b\u7684 Intro (\u91cd\u751f)\nconst int StIntroWakeUp = 15; // WakeUp \u7c7b\u578b\u7684 Intro (2a awake)\nconst int StBirdDashTutorial = 16; // \u5e8f\u7ae0\u6559\u51b2\u523a\u65f6\u51b2\u523a\u7ed3\u675f\u540e\u8fdb\u5165\u7684\u72b6\u6001\nconst int StFrozen = 17; // \u672a\u77e5\nconst int StReflectionFall = 18; // 6a-2 \u6389\u843d\u5267\u60c5\u6bb5\nconst int StStarFly = 19; // \u7fbd\u6bdb\u98de\u884c\nconst int StTempleFall = 20; // 5a \u955c\u5b50\u540e\u7684\u6389\u843d\u6bb5\nconst int StCassetteFly = 21; // \u6361\u5230\u78c1\u5e26\u540e\u7684\u6ce1\u6ce1\u5305\u88f9\u6bb5\nconst int StAttract = 22; // 6a badeline boss \u9760\u8fd1\u65f6\u7684\u5438\u5f15\u6bb5\nconst int StIntroMoonJump = 23; // 9a \u5f00\u573a\u4e0a\u5347\u5267\u60c5\u6bb5\nconst int StFlingBird = 24; // 9a \u9e1f\u6254\u72b6\u6001\nconst int StIntroThinkForABit = 25; // 9a Intro\n</code></pre>"},{"location":"begin/simple_entity/","title":"\u7b80\u5355\u81ea\u5b9a\u4e49\u5b9e\u4f53","text":"<p>\u5728\u77e5\u9053\u4e00\u4e9b mod \u5236\u4f5c\u4e2d\u6700\u4e3a\u57fa\u7840\u7684\u4e1c\u897f\u540e, \u6211\u4eec\u9996\u5148\u628a\u5174\u8da3\u70b9\u8f6c\u5411\u81ea\u5b9a\u4e49\u5b9e\u4f53, \u76f8\u4fe1\u76f8\u5bf9\u4e8e\u4fee\u6539\u5df2\u6709\u7684\u4e1c\u897f\u5e76\u4f34\u968f\u7740\u4e00\u5b9a\u7684\u70e7\u8111(\u6211\u8be5\u600e\u4e48\u6539? \u8fd9\u4e48\u6539\u4f1a\u4e0d\u4f1a\u7834\u574f\u5b98\u56fe\u5143\u7d20?), \u4f60\u53ef\u80fd\u66f4\u559c\u6b22\u81ea\u5df1\u5236\u4f5c\u4e00\u4e2a\u5b9e\u4f53, \u90a3\u5c31\u5bf9\u4e86! \u5728\u8fd9\u4e00\u8282, \u6211\u4eec\u4f1a\u4e86\u89e3 loenn \u7684\u57fa\u7840\u4f7f\u7528\u3001\u6dfb\u52a0\u4e00\u4e2a\u81ea\u5b9a\u4e49\u5b9e\u4f53\u7684\u901a\u7528\u6b65\u9aa4, \u4ee5\u53ca\u4e00\u4e9b\u6e38\u620f\u5e38\u7528\u7684\u65b9\u6cd5!</p>"},{"location":"begin/simple_entity/#_2","title":"\u6211\u4eec\u7684\u81ea\u5b9a\u4e49\u5b9e\u4f53\u7c7b","text":""},{"location":"begin/simple_entity/#_3","title":"\u5b83\u80fd\u5e72\u4ec0\u4e48","text":"<p>\u5728\u5f00\u59cb\u5236\u4f5c\u8fd9\u4e2a\u81ea\u5b9a\u4e49\u5b9e\u4f53\u4e4b\u524d, \u6211\u4eec\u5148\u660e\u767d\u4e00\u4e0b\u8fd9\u4e2a\u5b9e\u4f53\u505a\u51fa\u6765\u662f\u4ec0\u4e48\u6548\u679c\u7684. \u90a3\u4e48, \u4e3a\u4e86\u7b80\u5355\u8d77\u89c1, \u8fd9\u91cc\u5c31\u505a\u4e00\u4e2a\u7b80\u5355\u7684\u529f\u80fd, \u5b83\u5927\u6982\u662f:</p> <ul> <li>\u5b83\u53eb\u505a <code>PassByRefill</code></li> <li>\u957f\u5ea6\u548c\u5bbd\u5ea6\u662f\u968f\u610f\u7684</li> <li>\u5b83\u770b\u8d77\u6765\u662f\u4e2a\u900f\u660e\u7684\u7ea2\u8272\u7269\u4f53</li> <li>\u73a9\u5bb6\u4e0e\u5176\u78b0\u649e\u65f6\u4f1a\u9501\u5b9a\u4e3a\u67d0\u4e2a\u51b2\u523a\u6570</li> <li>\u8fd9\u4e2a\u51b2\u523a\u6570\u53ef\u4ee5\u5728\u4f5c\u56fe\u8f6f\u4ef6\u4e2d\u8bbe\u7f6e</li> </ul> <p>\u662f\u7684\u5c31\u8fd9\u6837\u7b80\u5355, \u90a3\u4e48\u6211\u4eec\u5f00\u59cb\u5427.</p>"},{"location":"begin/simple_entity/#_4","title":"\u58f0\u660e\u8fd9\u4e2a\u7c7b","text":"<p>Warning</p> <p>\u5728\u524d\u9762\u6211\u4eec\u94a9\u53d6\u4e86 <code>Player.Update()</code> \u5e76\u4e14\u5728\u4e00\u76f4\u4fee\u6539\u51b2\u523a\u6570\u4e3a 1! \u4e0d\u8981\u5fd8\u8bb0\u628a\u94a9\u5b50\u51fd\u6570\u4ee5\u53ca\u94a9\u53d6\u548c\u53d6\u6d88\u94a9\u53d6\u7684\u90a3\u4e9b\u4ee3\u7801\u5220\u6389, \u6700\u540e\u4f60\u7684 Module \u7c7b\u5e94\u8be5\u53ea\u5305\u542b\u4e24\u4e2a\u7a7a\u7684 <code>Load</code> \u548c <code>Unload</code> \u65b9\u6cd5!</p> <p>\u9996\u5148\u5728\u4ee3\u7801\u4e2d, \u6211\u4eec\u9700\u8981\u58f0\u660e\u8fd9\u4e2a\u7c7b, \u4e5f\u5c31\u662f\u521b\u5efa\u4e00\u4e2a .cs \u6587\u4ef6, \u7136\u540e\u547d\u4e2a\u540d. \u5728\u8fd9\u91cc\u4f60\u8fd8\u9700\u8981\u7ee7\u627f\u4e00\u4e0b <code>Entity</code>, \u5728\u524d\u9762\u6211\u4eec\u5df2\u7ecf\u4e86\u89e3\u8fc7\u4e86\u5b83\u662f <code>Monocle</code> \u7684\u4e00\u4e2a\u7c7b, \u8868\u793a\u573a\u666f\u4e2d\u7684\u5b9e\u4f53. \u90a3\u4e48\u4f60\u5e94\u8be5\u4f1a\u5199\u51fa\u5982\u4e0b\u7684\u4ee3\u7801:</p> PassByRefill.cs<pre><code>namespace MyCelesteMod;\n\npublic class PassByRefill : Entity\n{\n\n}\n</code></pre> <p>ok, \u63a5\u4e0b\u6765, \u6211\u4eec\u52a0\u4e00\u4e2a\u8868\u793a\u51b2\u523a\u6570\u7684\u5b57\u6bb5, \u7136\u540e\u641e\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u63a5\u6536\u5e76\u8d4b\u503c\u5b83: PassByRefill.cs<pre><code>public int Dashes = 0;\n\npublic PassByRefill(Vector2 position, Vector2 size, int dashes)\n{\n    Position = position;\n    Dashes = dashes;\n}\n</code></pre></p> <p>\u8fd9\u91cc\u7684 <code>position</code> \u53c2\u6570\u4f1a\u88ab\u7528\u4e8e\u8bbe\u7f6e\u5b83\u7684 <code>Position</code> \u5b57\u6bb5, \u8fd9\u4e2a\u5b57\u6bb5\u4ece <code>Monocle.Entity</code> \u7ee7\u627f\u800c\u6765, \u5b83\u8868\u793a\u8fd9\u4e2a <code>Entity</code> \u5728\u573a\u666f\u4e2d\u6240\u5728\u7684\u4f4d\u7f6e(\u4e16\u754c\u5750\u6807). <code>Vector2</code> \u662f\u4e00\u4e2a XNA \u4e2d\u7684\u7ed3\u6784\u4f53, \u5305\u542b\u4e00\u4e2a <code>X</code> \u548c\u4e00\u4e2a <code>Y</code> \u7684 <code>float</code> \u5b57\u6bb5, \u5b83\u7528\u4e8e\u63cf\u8ff0\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e, \u5c31\u50cf\u4f60\u5728\u5e73\u9762\u76f4\u89d2\u5750\u6807\u7cfb\u4e2d\u6240\u505a\u7684\u4e00\u6837! \u4e0d\u8fc7\u8fd9\u91cc\u9700\u8981\u6ce8\u610f, \u6e38\u620f\u4e2d\u7684\u5750\u6807\u7cfb\u548c\u6211\u4eec\u901a\u5e38\u6570\u5b66\u4e2d\u7684\u5750\u6807\u7cfb\u4e0d\u540c, \u5b83\u7684\u9876\u70b9\u5728\u5de6\u4e0a\u89d2, X \u8f74\u6c34\u5e73\u5411\u53f3\u4f46\u662f Y \u8f74\u7ad6\u76f4\u5411\u4e0b! \u5207\u8bb0\u4e0d\u8981\u641e\u6df7\u4e86. <code>Vector2</code> \u540c\u65f6\u4e5f\u53ef\u80fd\u8868\u793a\u5927\u5c0f, \u5373 <code>X</code> \u5b57\u6bb5\u8868\u793a\u5bbd\u5ea6, <code>Y</code> \u5b57\u6bb5\u8868\u793a\u957f\u5ea6, \u5728\u8fd9\u91cc\u6211\u4eec\u7528\u5b83\u6765\u63a5\u6536\u5b83\u7684\u5927\u5c0f. \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u6211\u4eec\u5e76\u6ca1\u6709\u7406 <code>size</code> \u8fd9\u4e2a\u8868\u793a\u5927\u5c0f\u53c2\u6570, \u7a0d\u7b49\u4e00\u4e0b, \u6211\u4eec\u5728\u672c\u8282\u540e\u8fb9\u5c31\u4f1a\u4f7f\u7528\u5b83\u4e86.</p> <p> </p> <p>\u63a5\u4e0b\u6765, \u6211\u4eec\u9700\u8981\u58f0\u660e\u4e00\u4e2a\u7279\u6b8a\u7684\u6784\u9020\u51fd\u6570, \u8fd9\u4e2a\u6784\u9020\u51fd\u6570\u7531 Everest \u53cd\u5c04\u8c03\u7528, \u7528\u4e8e\u5c06\u4f5c\u56fe\u8f6f\u4ef6\u90a3\u8fb9\u7684\u6570\u636e\u4f20\u9012\u7ed9\u6211\u4eec: PassByRefill.cs<pre><code>public PassByRefill(EntityData data, Vector2 offset) \n        : this(data.Position + offset, new Vector2(data.Width, data.Height), data.Int(\"dashes\"))\n    { }\n</code></pre> \u5728\u8fd9\u91cc, <code>EntityData data</code> \u50a8\u5b58\u4e86\u4f5c\u56fe\u8f6f\u4ef6\u4fdd\u5b58\u7684\u76f8\u5173\u6570\u636e, \u6211\u4eec\u8981\u63d0\u53d6\u5b83\u4eec\u5f88\u7b80\u5355, \u6bd4\u5982\u8bf4\u6211\u4eec\u8981\u63d0\u53d6\u4e00\u4e2a\u540d\u4e3a <code>dashes</code> \u7684 <code>int</code> \u7c7b\u578b\u7684\u6570\u636e, \u6211\u4eec\u5c31\u7b80\u5355\u5730\u8c03\u7528\u5b83\u7684\u65b9\u6cd5 <code>Int(string name)</code> \u5c31\u5f97\u5230\u4e86, \u7136\u540e\u662f\u5b83\u7684\u5927\u5c0f\u6570\u636e, \u7531\u4e8e\u5927\u5c0f\u662f\u4e2a\u7279\u6b8a\u7684\u4e1c\u897f, \u8fd9\u91cc\u6211\u4eec\u53ef\u4ee5\u76f4\u63a5\u901a\u8fc7 <code>Width</code> \u548c <code>Height</code> \u5c5e\u6027\u63d0\u53d6\u5e76 <code>new</code> \u4e00\u4e2a <code>Vector2</code> \u7ed3\u6784\u4f53\u6765\u4f20\u9012\u7ed9\u6211\u4eec\u4e0a\u9762\u7684\u6784\u9020\u51fd\u6570. \u5bf9\u4e8e\u66f4\u591a\u65b9\u6cd5\u4ee5\u53ca\u8fd9\u90e8\u5206\u6570\u636e\u8be5\u5982\u4f55\u81ea\u5b9a\u4e49\u6211\u4eec\u4f1a\u5728\u672c\u8282\u540e\u534a\u90e8\u5206\u8bf4\u660e. <code>Vector2 offset</code> \u8868\u793a\u8fd9\u4e00\u9762\u7684\u6700\u5de6\u4e0a\u89d2\u7684\u4e16\u754c\u5750\u6807, <code>EntityData</code> \u7684 <code>Position</code> \u662f\u7269\u4f53\u76f8\u5bf9\u4e8e\u8fd9\u4e00\u9762\u6700\u5de6\u4e0a\u89d2\u7684\u5750\u6807, \u6240\u4ee5\u6211\u4eec\u9700\u8981\u628a\u5b83\u76f8\u52a0\u6765\u5f97\u5230\u4e16\u754c\u5750\u6807.(\u56e0\u4e3a <code>Entity.Position</code> \u6c38\u8fdc\u53ea\u63a5\u53d7\u4e16\u754c\u5750\u6807!)</p> <p>Info</p> <p>\u8fd9\u4e2a\u6784\u9020\u51fd\u6570\u7684\u53c2\u6570\u5217\u8868\u4e5f\u80fd\u4e3a\u5176\u4ed6\u7684\u6837\u5b50, \u4f46\u662f\u6211\u4eec\u6700\u6700\u6700\u5e38\u7528\u7684\u4e00\u4e2a\u7248\u672c\u5c31\u662f\u4e0a\u9762\u8fd9\u4e2a</p>"},{"location":"begin/simple_entity/#everest","title":"\u8ba9 Everest \u627e\u5230\u5b83","text":"<p>\u73b0\u5728\u6211\u4eec\u53ea\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7c7b Everest \u90a3\u8fb9\u662f\u5565\u4e5f\u4e0d\u77e5\u9053\u7684, \u6240\u4ee5\u6211\u4eec\u5f97\u544a\u8bc9\u5b83, \u800c\u8fd9\u4e2a\u8fc7\u7a0b\u6211\u4eec\u4e00\u822c\u5c31\u53eb <code>\u6ce8\u518c</code>. \u8981\u6ce8\u518c\u4e00\u4e2a\u81ea\u5b9a\u4e49\u5b9e\u4f53\u975e\u5e38\u7b80\u5355, \u6211\u4eec\u53ea\u9700\u8981\u5c06 <code>CustomEntity</code> (\u5728\u547d\u540d\u7a7a\u95f4 <code>Celeste.Mod.Entities</code> \u4e2d) \u88c5\u9970\u5230\u6211\u4eec\u7684\u7c7b\u4e0a\u5e76\u4f20\u5165\u6211\u4eec\u5b9e\u4f53\u7684 \"\u540d\u79f0 ID\". \u5c31\u50cf: PassByRefill.cs<pre><code>[CustomEntity(\"MyCelesteMod/PassByRefill\")]\npublic class PassByRefill : Entity\n{\n......\n</code></pre> \u5728\u8fd9\u91cc \"\u540d\u79f0 ID\" \u6211\u4eec\u4e00\u822c\u63a8\u8350\u4ee5 \"{Mod\u540d}/\u8be5\u5b9e\u4f53\u7c7b\u540d\" \u8fdb\u884c\u547d\u540d, \u5c31\u50cf\u8fd9\u91cc\u4e00\u6837, Mod \u540d\u4e3a <code>MyCelesteMod</code>, \u7c7b\u540d\u4e3a <code>PassByRefill</code>, \u5b9e\u4f53 \"\u540d\u79f0 ID\" \u5c31\u662f <code>MyCelesteMod/PassByRefill</code>. \u8fd9\u91cc\u6211\u5efa\u8bae\u4f60\u8bb0\u4f4f\u5b83, \u5f85\u4f1a\u6211\u4eec\u4f1a\u5728\u4f5c\u56fe\u8f6f\u4ef6\u914d\u7f6e\u7684\u65f6\u5019\u7528\u5230.</p>"},{"location":"begin/simple_entity/#loenn","title":"Loenn","text":"<p>\u4f5c\u56fe\u8f6f\u4ef6</p> <p>\u851a\u84dd\u7684\u4f5c\u56fe\u8f6f\u4ef6\u6700\u6d41\u884c\u7684\u76ee\u524d\u6709 <code>ahorn</code> \u4e0e <code>loenn</code>, \u4e0d\u8fc7\u6211\u66f4\u63a8\u8350 <code>loenn</code>, \u56e0\u4e3a <code>ahorn</code> \u5b9e\u5728\u662f \u592a!!\u5361!!\u4e86!!</p>"},{"location":"begin/simple_entity/#_5","title":"\u57fa\u7840\u4f7f\u7528","text":"<p>Loenn \u662f\u4e00\u4e2a\u851a\u84dd\u7684\u4f5c\u56fe\u8f6f\u4ef6, \u5f53\u7136\u8fd9\u91cc\u6211\u4eec\u4f7f\u7528\u5b83\u4e0d\u662f\u5236\u4f5c\u51fa\u7cbe\u7f8e\u7684\u5730\u56fe, \u800c\u662f\u4ec5\u4ec5\u653e\u7f6e\u4e00\u4e0b\u6211\u4eec\u7684\u81ea\u5b9a\u4e49\u5b9e\u4f53! _(:\u0437\u300d\u2220)_, \u8fd9\u91cc\u6211\u4e0d\u600e\u4e48\u60f3\u91cd\u590d\u5b83\u7684\u57fa\u7840\u4f7f\u7528, \u6240\u4ee5\u6211\u63a8\u8350\u4f60\u53bb\u4ee5\u4e0b\u51e0\u4e2a\u89c6\u9891\u4e2d\u4e86\u89e3:</p> <ul> <li>Bilibili \u3010Celeste\u851a\u84dd\u3011\u7535\u7bb1\u4f5c\u56fe\u6559\u7a0b\u91cd\u7f6e\u7248 0-1 Loenn\u7684\u5b89\u88c5</li> <li>Bilibili \u3010Celeste\u851a\u84dd\u3011\u7535\u7bb1\u4f5c\u56fe\u6559\u7a0b\u91cd\u7f6e\u7248 1-1 Loenn\u7684\u4f7f\u7528</li> </ul> <p>\u7248\u672c</p> <p>\u5982\u679c\u4f60\u4e4b\u524d\u5df2\u7ecf\u4e0b\u8f7d\u4e86 Loenn, \u6211\u5efa\u8bae\u4f60\u786e\u4fdd\u5b83\u5347\u7ea7\u5230\u6700\u65b0\u7248\u4e86, \u56e0\u4e3a\u63a5\u4e0b\u6765\u7684\u67d0\u4e9b\u4e1c\u897f\u6211\u53ef\u80fd\u4e0d\u592a\u8bb0\u5f97\u662f\u54ea\u4e2a\u7248\u672c\u5f15\u5165\u7684\u4e86.</p>"},{"location":"begin/simple_entity/#loenn_1","title":"\u8ba9 Loenn \u627e\u5230\u6211\u4eec\u7684\u5b9e\u4f53","text":"<p>\u76f8\u4fe1\u4f60\u73b0\u5728\u5df2\u7ecf\u61c2\u7684 Loenn \u57fa\u672c\u7684\u4f7f\u7528\u7528\u6cd5\u4e86, \u90a3\u4e48\u73b0\u5728, \u6211\u4eec\u8981\u7ed9 Loenn \u5199\u4e00\u4e9b\u4e1c\u897f\u8ba9\u5b83\u77e5\u9053\u6211\u4eec\u8fd9\u4e2a\u5b9e\u4f53 mapper \u4eec\u80fd\u7528\u4e86. \u9996\u5148\u6211\u4eec\u5728 ModFolder \u4e0b\u65b0\u5efa\u4e00\u4e2a\u53eb <code>Loenn</code> \u7684\u6587\u4ef6\u5939, \u518d\u5728\u91cc\u9762\u65b0\u5efa\u4e00\u4e2a\u53eb <code>entities</code> \u7684\u6587\u4ef6\u5939, \u518d\u5728\u91cc\u9762\u65b0\u5efa\u4e00\u4e2a\u53eb <code>PassByRefill.lua</code> (\u4e5f\u5c31\u662f<code>{\u5b9e\u4f53\u7c7b\u540d}.lua</code>) \u7684\u6587\u672c\u6587\u4ef6. \u73b0\u5728\u4f60\u7684\u76ee\u5f55\u7ed3\u6784\u5e94\u8be5\u662f\u8fd9\u6837\u7684:</p> <ul> <li>ModFolder<ul> <li>Loenn<ul> <li>entities<ul> <li>PassByRefill.lua</li> </ul> </li> </ul> </li> </ul> </li> </ul> <p>ok, \u7136\u540e\u6211\u4eec\u6253\u5f00 <code>PassByRefill.lua</code>, \u8fd9\u662f\u4e00\u4e2a <code>lua</code> \u8bed\u8a00\u7684\u6e90\u6587\u4ef6, \u8fd9\u91cc\u6211\u4eec\u4e0d\u9700\u8981\u5f88\u591a <code>lua</code> \u77e5\u8bc6, \u76f4\u63a5\u7167\u7740\u6284\u5c31\u597d\u4e86:</p> PassByRefill.lua<pre><code>local entity = {}\n\nentity.name = \"MyCelesteMod/PassByRefill\"\nentity.placements = {\n    name = \"normal\",\n    data = {\n        width = 16,\n        height = 16,\n        dashes = 1\n    }\n}\n\nreturn entity\n</code></pre> <p>\u8fd8\u8bb0\u5f97\u6211\u4eec\u4e4b\u524d\u8bb0\u4f4f\u7684\u5b9e\u4f53 \"\u540d\u79f0 ID\" \u5417? \u5728\u8fd9\u91cc\u4f60\u5c31\u9700\u8981\u5c06\u5176\u8d4b\u503c\u7ed9 <code>entity.name</code>.  </p> <ul> <li>\u7136\u540e\u662f <code>entity</code> \u7684 <code>placements</code>, \u5b83\u8868\u793a\u8fd9\u4e2a\u5b9e\u4f53\u7684\u653e\u7f6e\u9009\u9879, \u5728\u8fd9\u91cc\u6211\u4eec\u5148\u4e0d\u7ba1, \u4f60\u5c31\u7406\u89e3\u4e3a\u4f60\u5e0c\u671b Loenn \u600e\u4e48\u628a\u4f60\u8fd9\u4e2a\u5b9e\u4f53\u62c6\u5206\u4e3a\u591a\u4e2a\u653e\u7f6e\u9009\u9879, \u8fd9\u91cc\u6211\u4eec\u7684\u5199\u6cd5\u8868\u793a\u4e0d\u5e0c\u671b Loenn \u62c6\u5206\u5b83, \u5982\u679c\u8fd9\u91cc\u7684 <code>placements</code> \u662f\u4e2a\u6570\u7ec4\u7684\u8bdd\u90a3\u4e48 Loenn \u5c31\u4f1a\u62c6\u5206\u5b83\u4e86.<ul> <li>\u7ee7\u7eed\u5230 <code>name</code> \u5c5e\u6027, \u5b83\u8868\u793a\u8fd9\u4e2a\u653e\u7f6e\u9009\u9879\u7684\u540d\u79f0, \u8fd9\u4e2a\u540d\u79f0\u662f\u4efb\u610f\u7684, \u5b83\u53ea\u88ab\u7528\u6765\u4f5c\u4e3a\u672c\u5730\u5316\u952e\u540d(\u672c\u5730\u5316\u5c31\u5305\u62ec\u6211\u4eec\u5e38\u8bf4\u7684\"\u6c49\u5316\").</li> <li>\u7136\u540e\u662f <code>data</code> \u5c5e\u6027, \u5b83\u8868\u793a\u8fd9\u4e2a\u5b9e\u4f53\u7684\u6570\u636e.<ul> <li>\u5728\u8fd9\u91cc\u6211\u4eec\u58f0\u660e\u4e86\u4e09\u4e2a\u6570\u5b57\u7c7b\u578b\u7684\u5c5e\u6027: <code>width</code>, <code>height</code>, <code>dashes</code>, \u524d\u4e24\u4e2a\u5c5e\u6027\u662f\u7279\u6b8a\u7684, \u5728\u4ee3\u7801\u4e2d\u63d0\u53d6\u53ea\u9700\u8981\u5bf9 <code>EntityData</code> \u83b7\u53d6 <code>Width</code>/<code>Height</code> \u5b57\u6bb5\u5373\u53ef.  </li> <li>\u7b2c\u4e09\u4e2a <code>dashes</code> \u5c5e\u6027\u5c31\u662f\u6211\u4eec\u7684\u81ea\u5b9a\u4e49\u5c5e\u6027</li> </ul> </li> </ul> </li> </ul> <p>\u5728 <code>data</code> \u5bf9\u8c61\u91cc\u7684\u5c5e\u6027, \u540e\u9762\u7684\u7b49\u53f7\u5c31\u8868\u793a\u5b83\u7684\u9ed8\u8ba4\u503c, \u6bd4\u5982 <code>width</code> \u9ed8\u8ba4\u4e3a 16, <code>dashes</code> \u9ed8\u8ba4\u4e3a 1.</p> <p>Note</p> <p>\u5982\u679c\u4f60\u4e0d\u58f0\u660e <code>width</code> \u548c <code>height</code> \u5c5e\u6027\u7684\u8bdd Loenn \u4f3c\u4e4e\u4f1a\u76f4\u63a5\u7981\u6b62\u4f60\u653e\u7f6e\u8fd9\u4e2a\u5b9e\u4f53.</p> <p>\u597d\u5427\u770b\u8d77\u6765\u4e0a\u9762\u8fd9\u4e00\u5768*\u975e\u5e38\u96be\u61c2*, \u4e0d\u8fc7\u6ca1\u5173\u7cfb, \u53ea\u8981\u4f60\u4f1a\u76f4\u63a5\u590d\u5236\u4e0a\u9762\u7684\u4e1c\u897f, \u6539\u4e00\u4e0b <code>entity.name</code>, \u5411 <code>data</code> \u91cc\u52a0\u4e00\u4e9b\u5c5e\u6027\u5c31\u884c\u4e86. \u5b9e\u9645\u4e0a\u6211\u4e5f\u662f\u8fd9\u4e48\u505a\u7684.  </p> <p>\u90a3\u4e48, \u91cd\u65b0\u7f16\u8bd1\u6211\u4eec\u7684\u9879\u76ee, \u8ba9 <code>msbuild</code> \u628a\u6211\u4eec\u7684\u4e1c\u897f\u590d\u5236\u8fc7\u53bb, \u8fd9\u65f6\u6253\u5f00\u6211\u4eec\u7684 Loenn (\u6216\u8005\u91cd\u542f Loenn), \u641c\u7d22\u4e00\u4e0b <code>@MyCelesteMod</code>. \u90a3\u4e48\u5217\u8868\u4e0a\u5e94\u8be5\u53ea\u4f1a\u51fa\u73b0\u4e00\u4e2a\u540d\u5b57\u5f88\u5947\u602a\u7684\u9009\u9879(\u56e0\u4e3a\u6211\u4eec\u8fd8\u6ca1\u914d\u7f6e\u672c\u5730\u5316\u76f8\u5173\u7684\u4e1c\u897f!), \u73b0\u5728\u628a\u5b83\u653e\u5230\u4efb\u4f55\u4f60\u559c\u6b22\u7684\u5730\u65b9, \u6253\u5f00\u5b83\u7684\u5c5e\u6027\u6846, \u6211\u4eec\u5c31\u80fd\u770b\u5230\u4e00\u4e2a\u5927\u5927\u7684 <code>dashes</code> \u5c5e\u6027\u5728\u4e0a\u9762\u5141\u8bb8\u6211\u4eec\u6539\u5566. \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u5b83\u662f\u5168\u767d\u7684! \u56e0\u4e3a\u6211\u4eec\u8fd8\u6ca1\u544a\u8bc9 Loenn \u5b83\u957f\u4ec0\u4e48\u6837! \u4e0d\u8fc7\u8fd9\u4e2a\u7b49\u4ee5\u540e\u6211\u4eec\u518d\u6765\u641e.</p>"},{"location":"begin/simple_entity/#_6","title":"\u56de\u5230\u4ee3\u7801","text":"<p>\u73b0\u5728\u5728\u6e38\u620f\u4e2d\u8fdb\u5165\u653e\u4e86\u6211\u4eec\u90a3\u4e2a\u5b9e\u4f53\u7684\u90a3\u5f20\u56fe, \u7136\u540e\u5230\u4e4b\u524d\u4f60\u559c\u6b22\u7684\u90a3\u4e2a\u5730\u65b9, \u7136\u540e... \u662f\u7684, \u4f60\u5565\u4e5f\u4e0d\u4f1a\u770b\u89c1, \u56e0\u4e3a\u6211\u4eec\u4e5f\u6ca1\u544a\u8bc9\u6e38\u620f\u5b83\u957f\u4ec0\u4e48\u6837! \u540c\u65f6\u4f60\u8d70\u5230\u5b83\u9644\u8fd1, \u4e5f\u4e0d\u4f1a\u53d1\u751f\u4efb\u4f55\u4e8b, \u56e0\u4e3a\u6211\u4eec\u4e5f\u6ca1\u544a\u8bc9\u6e38\u620f\u8fd9\u4e2a\u5b9e\u4f53\u5e94\u8be5\u5e72\u4ec0\u4e48!</p>"},{"location":"begin/simple_entity/#_7","title":"\u544a\u8bc9\u6e38\u620f\u5b83\u8be5\u505a\u4ec0\u4e48","text":"<p>\u90a3\u4e48, \u5c31\u50cf\u524d\u9762\u63cf\u8ff0\u7684\u4e00\u6837, \"\u73a9\u5bb6\u4e0e\u5176\u78b0\u649e\u65f6\u4f1a\u9501\u5b9a\u4e3a\u67d0\u4e2a\u51b2\u523a\u6570\", \u90a3\u4e48\u6211\u4eec\u9700\u8981\u505a\u4e00\u4e9b\u78b0\u649e. \u5728 <code>Monocle</code> \u91cc\u8fd9\u9879\u5de5\u4f5c\u5f88\u7b80\u5355, \u6211\u4eec\u9996\u5148\u5728\u6784\u9020\u51fd\u6570\u91cc\u53bb <code>new</code> \u4e00\u4e2a\u957f\u65b9\u5f62\u7684\u78b0\u649e\u7bb1: PassByRefill.PassByRefill<pre><code>public PassByRefill(Vector2 position, Vector2 size, int dashes)\n{\n    Hitbox hitbox = new(size.X, size.Y);\n}\n</code></pre></p> <p>Info</p> <p>\u6211\u4eec\u5728\u8fd9\u91cc\u7528\u5230\u4e86\u4e4b\u524d\u7684 <code>size</code> \u53c2\u6570</p> <p><code>Hitbox</code> \u5c31\u662f\u6211\u4eec\u60f3\u8981\u7684\u957f\u65b9\u5f62\u78b0\u649e\u7bb1, \u5b83\u7684\u552f\u4e00\u7684\u6784\u9020\u5668\u63a5\u6536\u56db\u4e2a\u53c2\u6570, \u524d\u4e24\u4e2a\u53c2\u6570\u4e3a\u5b83\u7684\u5bbd\u9ad8, \u540e\u4e24\u4e2a\u53c2\u6570\u4e3a\u8fd9\u4e2a\u78b0\u649e\u7bb1\u7684\u504f\u79fb(\u56e0\u4e3a\u78b0\u649e\u7bb1\u6211\u4eec\u8981\u9644\u52a0\u5230 <code>Entity</code> \u8eab\u4e0a, \u6240\u4ee5\u4f1a\u6709\u504f\u79fb\u8fd9\u4e2a\u4e1c\u897f), \u8fd9\u4e24\u4e2a\u53c2\u6570\u9ed8\u8ba4\u90fd\u4e3a 0. \u7136\u540e\u8bbe\u7f6e\u5230 <code>Entity</code> \u8eab\u4e0a: PassByRefill.PassByRefill<pre><code>Collider = hitbox;\n</code></pre> <code>Collider</code> \u662f <code>Entity</code> \u7684\u4e00\u4e2a\u5c5e\u6027, \u5b83\u8868\u793a\u8fd9\u4e2a <code>Entity</code> \u81ea\u8eab\u7684\u78b0\u649e\u7bb1. <code>Collider</code> \u5c5e\u6027\u662f <code>Collider</code> \u7c7b\u578b\u7684, \u5b83\u662f\u4e00\u4e2a\u62bd\u8c61\u7c7b\u8868\u793a\u4e00\u4e2a\u78b0\u649e\u4f53, \u8fd9\u91cc\u6211\u4eec\u7684 <code>Hitbox</code> \u5c31\u662f\u5b83\u7684\u4e00\u4e2a\u5b9e\u73b0, \u4e5f\u5c31\u662f\u4e00\u79cd\u957f\u65b9\u5f62\u7684\u5b9e\u73b0.  </p> <p>\u78b0\u649e\u7bb1\u8bbe\u7f6e\u5b8c\u540e, \u6211\u4eec\u5c31\u8be5\u5728 <code>Update()</code> \u68c0\u6d4b\u78b0\u649e\u4e86, \u8fd9\u5f88\u7b80\u5355~ PassByRefill.Update()<pre><code>public override void Update()\n{\n    base.Update();\n    // \u83b7\u53d6 Player \u5b9e\u4f8b (\u522b\u5bb3\u6015!)\n    var player = Scene.Tracker.GetEntity&lt;Player&gt;();\n\n    // \u68c0\u6d4b\u662f\u5426\u4e0e\u73a9\u5bb6\u78b0\u649e\n    if (player is not null &amp;&amp; this.CollideCheck(player))\n    {\n        // \u5982\u679c\u78b0\u649e\u4e86, \u90a3\u4e48\u8bbe\u7f6e\u5b83\u7684\u51b2\u523a\u6570\n        player.Dashes = this.Dashes;\n    }\n}\n</code></pre></p> <p>\u76f8\u4fe1\u4f60\u770b\u5230\u7b2c\u4e94\u884c\u4e00\u5b9a\u4f1a\u88ab\u5413\u4e00\u8df3! \u76f8\u4fe1\u90a3\u4e00\u4e32\u4e1c\u897f\u5bf9\u4e8e\u65b0\u4eba\u6765\u8bf4\u4e00\u5b9a\u5f88\u590d\u6742, \u4e0d\u8fc7\u6ca1\u5173\u7cfb, \u4f60\u53ea\u9700\u8981\u77e5\u9053\u90a3\u4e00\u4e32\u4f1a\u8fd4\u56de\u5728\u573a\u7684\u90a3\u4e2a\u73a9\u5bb6\u5c31\u884c(\u4e0d\u5728\u573a\u65f6\u4e3a null). \u7136\u540e\u6211\u4eec\u7528 <code>Entity</code> \u7684 <code>CollideCheck</code> \u68c0\u67e5\u6211\u4eec\u6709\u6ca1\u6709\u4e0e\u73a9\u5bb6\u53d1\u751f\u78b0\u649e, \u5982\u679c\u6709\u5219\u5f3a\u5236\u8bbe\u7f6e\u5b83\u7684\u51b2\u523a\u6570. \u7531\u4e8e\u6211\u4eec\u6bcf\u4e00\u5e27\u90fd\u5728\u68c0\u67e5, \u90fd\u5728\u8bbe\u7f6e, \u6240\u4ee5\u6700\u7ec8\u7684\u6548\u679c\u5c31\u662f\u73a9\u5bb6\u4e00\u65e6\u8fdb\u5165\u8fd9\u4e2a\u533a\u57df, \u51b2\u523a\u6570\u88ab\u9501\u5b9a\u4e3a <code>Dashes</code>.</p> <p>Info</p> <p>\u5b9e\u9645\u4e0a\u8fd9\u91cc\u6709\u66f4\u597d\u7684\u65b9\u6cd5\u6765\u5355\u72ec\u68c0\u6d4b\u4e0e\u73a9\u5bb6\u7684\u78b0\u649e, \u4e3a\u4e86\u7b80\u5355\u8d77\u89c1\u8fd9\u91cc\u6ca1\u6709\u91c7\u7528. \u4e0d\u8fc7\u6211\u4eec\u4f9d\u7136\u4f1a\u5728\u540e\u9762\u63d0\u5230(\"\u5e38\u89c1 Celeste, Monocle \u7c7b\"\u8282). \u7b2c\u4e00\u884c\u7684 <code>base.Update()</code> \u4f1a\u904d\u5386\u8c03\u7528\u8be5 <code>Entity</code> \u7684\u6240\u6709 <code>Component</code> \u7684 <code>Update()</code>, \u901a\u5e38\u6211\u4eec\u9700\u8981\u5728\u5f00\u5934\u5c31\u8c03\u7528\u5b83. \u540e\u9762\u7684 <code>Render()</code> \u4e5f\u662f.</p> <p>Info</p> <p>\u5728\u73a9\u5bb6\u6b7b\u4ea1\u540e\u7684\"\u70df\u82b1\"\u5e76\u4e0d\u662f <code>Player</code> \u5b9e\u4f8b, \u6240\u4ee5\u6b64\u65f6\u6211\u4eec\u4f1a\u5f97\u5230\u4e00\u4e2a <code>null</code> \u7684\u7ed3\u679c, \u5982\u679c\u4f60\u4e0d\u60f3\u8ba9\u4f60\u7684\u6e38\u620f\u5d29\u6e83\u7684\u8bdd\u8bb0\u5f97\u68c0\u67e5\u5b83\u662f\u5426\u4e3a <code>null</code>.</p>"},{"location":"begin/simple_entity/#_8","title":"\u544a\u8bc9\u6e38\u620f\u5b83\u957f\u4ec0\u4e48\u6837","text":"<p>\u90a3\u4e48, \u529f\u80fd\u505a\u597d\u540e, \u7684\u8ba9\u73a9\u5bb6\u770b\u89c1, \u4e3a\u4e86\u7b80\u5355\u8d77\u89c1\u8fd9\u91cc\u6211\u4eec\u4e0d\u6253\u7b97\u4f7f\u7528\u56fe\u7247, \u53ea\u662f\u50cf\u524d\u9762\u63cf\u8ff0\u7684\u4e00\u6837, \u5b83\u662f\u4e2a\"\u900f\u660e\u7684\u7ea2\u8272\u7269\u4f53\", \u5728\u8fd9\u91cc\u6211\u4eec\u9700\u8981\u91cd\u5199 <code>Entity</code> \u7684 <code>Render()</code> \u65b9\u6cd5\u6765\u7ed8\u5236\u4e00\u4e2a\u7eaf\u8272\u957f\u65b9\u5f62, \u5b83\u4f1a\u5728\u6e38\u620f\u4e2d\u6bcf\u5e27\u90fd\u4f1a\u88ab\u8c03\u7528, \u5c31\u50cf <code>Update()</code> \u4e00\u6837, \u4e0d\u8fc7\u5207\u8bb0\u4e0d\u8981\u5728\u8fd9\u4e24\u4e2a\u65b9\u6cd5\u91cc\u5e72\u4e0d\u76f8\u5173\u7684\u4e8b! \u4f60\u5e94\u8be5\u5728 <code>Update()</code> \u91cc\u53ea\u66f4\u65b0\u4f60\u7684\u903b\u8f91, \u800c\u5728 <code>Render()</code> \u91cc\u53ea\u505a\u7ed8\u5236. \u8fd9\u91cc\u6211\u4eec\u9009\u62e9\u7ed8\u5236\u4e00\u4e2a\u900f\u660e\u7684\u7ea2\u8272\u957f\u65b9\u5f62, \u6211\u4eec\u9700\u8981\u501f\u52a9\u8fd9\u4e2a\u51fd\u6570: Monocle.Draw.Rect<pre><code>Draw.Rect(Vector2 position, float width, float height, Color color)\n</code></pre> - \u7b2c\u4e00\u4e2a\u53c2\u6570\u662f\u6211\u4eec\u5e0c\u671b\u7ed8\u5236\u7684\u4f4d\u7f6e(\u4e16\u754c\u5750\u6807) - \u7b2c\u4e8c\u4e2a\u53c2\u6570\u662f\u6211\u4eec\u5e0c\u671b\u7ed8\u5236\u7684\u5bbd\u5ea6  - \u7b2c\u4e09\u4e2a\u53c2\u6570\u662f\u6211\u4eec\u5e0c\u671b\u7ed8\u5236\u7684\u9ad8\u5ea6 - \u7b2c\u56db\u4e2a\u53c2\u6570\u662f\u6211\u4eec\u5e0c\u671b\u7ed8\u5236\u7684\u989c\u8272</p> <p>\u6211\u4eec\u5728\u8fd9\u91cc\u4f1a\u8fd9\u6837\u7528\u5b83:</p> PassByRefill.Render()<pre><code>base.Render();\nColor c = Color.Red;\nc.A = 127;\nDraw.Rect(Position, Width, Height, c);\n</code></pre> <p>\u9996\u5148\u6211\u4eec\u83b7\u53d6\u4e00\u4e2a\u7ea2\u8272\u7684 <code>Color</code>, \u7136\u540e\u8bbe\u7f6e\u900f\u660e\u5ea6\u4e3a <code>127</code>, \u7136\u540e\u8c03\u7528\u8fd9\u4e2a\u65b9\u6cd5\u7ed8\u5236. \u4f60\u53ef\u80fd\u6ce8\u610f\u5230 <code>Width</code> \u548c <code>Height</code> \u8fd9\u4e24\u4e2a\u4e1c\u897f, \u5b83\u662f <code>Entity</code> \u7684\u4e24\u4e2a\u5c5e\u6027, \u9ed8\u8ba4\u5b83\u4eec\u90fd\u662f 0, \u5728\u4f60\u52a0\u5165\u78b0\u649e\u7bb1\u7684\u77ac\u95f4\u4ed6\u4eec\u4f1a\u53d8\u6210\u78b0\u649e\u7bb1\u7684\u5bbd\u548c\u9ad8, \u5728\u8fd9\u91cc\u5b83\u4eec\u7684\u503c\u5c31\u662f\u6211\u4eec\u4e4b\u524d\u8bbe\u7f6e\u7684 <code>Hitbox</code> \u7684\u5bbd\u9ad8.</p>"},{"location":"begin/simple_entity/#_9","title":"\u51c6\u5907\u5c31\u7eea","text":"<p>\u90a3\u4e48, \u4e00\u5207\u5c31\u7eea, \u7f16\u8bd1\u4f60\u7684\u9879\u76ee, \u5230\u90a3\u4e2a\u5730\u65b9, \u5728\u534a\u900f\u660e\u7ea2\u8272\u7684\u533a\u57df\u91cc\u4eab\u53d7\u9501\u5b9a\u51b2\u523a\u6570\u7684\u5feb\u4e50\u5427!</p> <p></p> <p>\u5982\u679c\u4f60\u9047\u5230\u4e86\u56f0\u96be, \u4f60\u53ef\u4ee5\u5bf9\u6bd4\u4e00\u4e0b\u6700\u7ec8\u7684\u4ee3\u7801: PassByRefill.cs<pre><code>using Celeste.Mod.Entities;\n\nnamespace MyCelesteMod;\n\n[CustomEntity(\"MyCelesteMod/PassByRefill\")]\npublic class PassByRefill : Entity\n{\n    public int Dashes = 0;\n\n    public PassByRefill(Vector2 position, Vector2 size, int dashes)\n    {\n        Dashes = dashes;\n        Position = position;\n        Hitbox hitbox = new(size.X, size.Y);\n        Collider = hitbox;\n    }\n\n    public PassByRefill(EntityData data, Vector2 offset)\n        : this(data.Position + offset, new Vector2(data.Width, data.Height), data.Int(\"dashes\"))\n    { }\n\n    public override void Update()\n    {\n        base.Update();\n        var player = Scene.Tracker.GetEntity&lt;Player&gt;();\n        if (player is not null &amp;&amp; this.CollideCheck(player))\n        {\n            player.Dashes = this.Dashes;\n        }\n    }\n\n    public override void Render()\n    {\n        base.Render();\n        Color c = Color.Red;\n        c.A = 127;\n        Draw.Rect(Position, Width, Height, c);\n    }\n}\n</code></pre></p>"},{"location":"begin/simple_entity/#_10","title":"\u66f4\u591a","text":""},{"location":"begin/simple_entity/#loenn-dashes","title":"\u5728 Loenn \u4e2d\u7981\u6b62\u8bbe\u7f6e dashes \u4e3a\u5c0f\u6570","text":"<p>\u5728 Loenn \u4e2d\u5982\u679c\u4f60\u6ca1\u6709\u663e\u5f0f\u6307\u5b9a\u67d0\u4e2a\u6570\u5b57 data \u7684\u7c7b\u578b\u7684\u8bdd\u5b83\u9ed8\u8ba4\u4f1a\u662f\u6d6e\u70b9\u6570, \u4e5f\u5c31\u662f\u4f60\u80fd\u8f93\u5165\u5c0f\u6570, \u4e0d\u8fc7\u8fd9\u4e0d\u4f1a\u5f88\u5f71\u54cd(\u8fd8\u662f\u6709\u7684!)\u4ee3\u7801\u90a3\u8fb9, \u6240\u4ee5\u6211\u4eec\u5f97\u8ddf Loenn \u8bf4\u4e00\u4e0b\u5b83\u662f\u4e2a\u6574\u6570! \u90a3\u4e48\u6211\u4eec\u5728\u4ee3\u7801\u7684 return \u4e4b\u524d\u8fd9\u6837\u8bbe\u7f6e\u4e00\u4e0b: PassByRefill.lua<pre><code>entity.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n</code></pre> \u5728\u8fd9\u91cc\u6211\u4eec\u8bbe\u7f6e\u4e86\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027 <code>fieldInformation</code>, \u7136\u540e\u5728\u91cc\u9762\u544a\u8bc9 Loenn \u6211\u4eec\u7684 <code>dashes</code> \u8fd9\u4e2a\u5c5e\u6027\u7684 <code>fieldType</code> \u662f <code>integer</code>, \u4e5f\u5c31\u662f\u6574\u6570. \u90a3\u4e48\u73b0\u5728\u518d\u91cd\u65b0\u7f16\u8bd1, \u91cd\u542f Loenn, \u4f60\u5e94\u8be5\u4f1a\u770b\u5230 Loenn \u53ea\u5141\u8bb8\u4f60\u8f93\u5165\u6574\u6570\u4e86.</p>"},{"location":"begin/simple_entity/#loenn_2","title":"\u4e3a Loenn \u4fa7\u914d\u7f6e\u672c\u5730\u5316","text":"<p>\u73b0\u5728\u6211\u4eec\u5728 Loenn \u4fa7\u6211\u4eec\u7684\u5b9e\u4f53\u653e\u7f6e\u9009\u62e9\u7684\u540d\u79f0\u975e\u5e38\u5947\u602a! \u8fd9\u80af\u5b9a\u4e0d\u662f\u4f60\u60f3\u8981\u7684\u7ed3\u679c, \u6240\u4ee5\u8fd9\u91cc\u6211\u4eec\u5c06\u4e3a\u5176\u914d\u7f6e\u672c\u5730\u5316. \u90a3\u4e48, \u5e38\u89c4\u5730, \u6211\u4eec\u9700\u8981\u5728 <code>ModFolder/Loenn</code> \u8fd9\u4e2a\u6587\u4ef6\u5939\u4e0b\u518d\u65b0\u5efa\u4e00\u4e2a\u53eb <code>lang</code> \u6587\u4ef6\u5939, \u7136\u540e\u5728\u91cc\u9762\u521b\u5efa\u4e00\u4e2a\u53eb <code>en_gb.lang</code> \u7684\u7a7a\u6587\u4ef6,  \u5b83\u662f Loenn \u9ed8\u8ba4\u8bfb\u53d6\u7684\u672c\u5730\u5316\u6587\u4ef6. \u73b0\u5728\u4f60\u7684\u76ee\u5f55\u7ed3\u6784\u5e94\u8be5\u50cf:</p> <ul> <li>ModFolder<ul> <li>Loenn<ul> <li>entities<ul> <li>PassByRefill.lua</li> </ul> </li> <li>lang<ul> <li>en_gb.lang</li> </ul> </li> </ul> </li> </ul> </li> </ul> <p>\u5728 <code>en_gb.lang</code> \u6587\u4ef6\u91cc, \u6211\u4eec\u5199\u4e0b:</p> <pre><code>entities.MyCelesteMod/PassByRefill.placements.name.normal=PassByRefill\n</code></pre> <p>\u554a, \u8fd9\u4e00\u4e32\u53ef\u80fd\u6709\u4ebf\u70b9\u957f, \u6211\u4eec\u6162\u6162\u6765\u89e3\u91ca\u4e00\u4e0b: \u9996\u5148\u8fd9\u662f\u4e00\u4e2a\u5b9e\u4f53, \u6240\u4ee5\u4ee5 <code>entities</code> \u5f00\u5934, \u7136\u540e\u6211\u4eec\u9700\u8981\u952e\u5165\u5b9e\u4f53\u7684\"\u540d\u79f0 ID\", \u7136\u540e\u518d\u4f9d\u6b21\u952e\u5165 <code>placements</code> \u548c <code>name</code>, \u8fd9\u8868\u793a\u6211\u4eec\u60f3\u672c\u5730\u5316\u7684\u5185\u5bb9\u662f\u90a3\u4e2a\u5b9e\u4f53\u7684\u653e\u7f6e\u9009\u9879\u7684\u540d\u79f0, \u6700\u540e\u952e\u5165\u653e\u7f6e\u9009\u9879\u7684\u540d\u5b57 \"normal\"(\u5b83\u5e94\u8be5\u4f1a\u5728\u4f60\u7684 lua \u7684\u7b2c\u4e94\u884c\u9644\u8fd1). ok \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6307\u5b9a\u4e86\u6211\u4eec\u60f3\u672c\u5730\u5316\u4ec0\u4e48\u4e1c\u897f\u4e86, \u90a3\u4e48\u63a5\u4e0b\u6765\u7b80\u5355\u7684 <code>={\u5185\u5bb9}</code>, \u5728\u8fd9\u91cc\u662f <code>PassByRefill</code>. \u6700\u540e, \u7f16\u8bd1\u590d\u5236, \u91cd\u542f Loenn, \u4f60\u5e94\u8be5\u5c31\u4f1a\u770b\u5230\u6211\u4eec\u7684\u5b9e\u4f53\u7ec8\u4e8e\u6709\u4e2a\u6b63\u5e38\u540d\u5b57\u4e86:</p> <p></p> <p>Info</p> <p>\u5bf9\u4e8e\u5b83\u7684\u8d34\u56fe\u6211\u4eec\u4e4b\u540e\u518d\u8bf4, \u6211\u77e5\u9053\u4f60\u5f88\u6025\u4f46\u662f\u4f60\u5148\u522b\u6025.</p>"},{"location":"begin/simple_texturing/","title":"\u7b80\u5355\u8d34\u56fe","text":"<p>\u55ef... \u90a3\u4e48\u5230\u8fd9\u4e00\u7ae0\u6211\u4eec\u8be5\u7ed9\u6211\u4eec\u5b9e\u4f53\u4e0a\u70b9\u8d34\u56fe\u4e86, \u4ee5\u53ca\u8fd8\u6709 Loenn \u4fa7\u7684\u8d34\u56fe, \u90a3\u4e48\u7ed3\u675f\u8fd9\u4e00\u7ae0\u540e\u4f60\u5e94\u8be5\u4f1a\u89c9\u5f97\u6211\u4eec\u7684\u5b9e\u4f53\u662f\u4e2a\"\u50cf\u6837\"\u7684\u5b9e\u4f53\u4e86. \u8fd9\u91cc\u6211\u4eec\u4f1a\u4f7f\u7528\u8fd9\u4e2a 64x64 \u7684\u8d85\u7ea7\u4e11\u964b\u7684\u8d34\u56fe(\u753b\u753b\u4e00\u70b9\u4e0d\u4f1aqwq):  </p> <p> </p> \u554a\u5b83\u771f\u7684\u592a\u4e11\u964b\u4e86 <p>\u4f60\u53ef\u4ee5\u5728\u8fd9\u91cc\u4e0b\u8f7d\u5b83: fucking_ugly_texture.png</p>"},{"location":"begin/simple_texturing/#_2","title":"\u7981\u6b62\u6211\u4eec\u7684\u5b9e\u4f53\u7f29\u653e","text":"<p>\u5728\u8fd9\u91cc\u6211\u4eec\u7684\u8d34\u56fe\u662f\u6b63\u65b9\u5f62\u7684, \u6240\u4ee5\u8fd9\u91cc\u4e3a\u4e86\u65b9\u4fbf\u8d77\u89c1\u6682\u65f6\u8ba9\u6211\u4eec\u7684\u5b9e\u4f53\u4e0d\u80fd\u7f29\u653e, \u90a3\u4e48\u5728\u4ee3\u7801\u8fd9\u8fb9\u7684\u8868\u73b0\u5c31\u662f\u76f4\u63a5\u5220\u53bb\u4e0e Size \u6709\u5173\u7684\u4e1c\u897f\u5e76\u5c06\u78b0\u649e\u7bb1\u786c\u7f16\u7801\u6210 64x64 \u5927\u5c0f:</p> AfterBefore PassByRefill.cs<pre><code>public PassByRefill(Vector2 position, int dashes)\n{\n    Dashes = dashes;\n    Position = position;\n    Hitbox hitbox = new(64, 64);\n    Collider = hitbox;\n}\n\npublic PassByRefill(EntityData data, Vector2 offset)\n    : this(data.Position + offset, data.Int(\"dashes\"))\n{ }\n</code></pre> PassByRefill.cs<pre><code>public PassByRefill(Vector2 position, Vector2 size, int dashes)\n{\n    Dashes = dashes;\n    Position = position;\n    Hitbox hitbox = new(size.X, size.Y);\n    Collider = hitbox;\n}\n\npublic PassByRefill(EntityData data, Vector2 offset)\n    : this(data.Position + offset, new Vector2(data.Width, data.Height), data.Int(\"dashes\"))\n{ }\n</code></pre> <p>Info</p> <p>\u5728 Loenn \u90a3\u8fb9\u6211\u4eec\u5f85\u4f1a\u518d\u8bf4, \u5982\u679c\u4f60\u73b0\u5728\u5c31\u5220\u9664 width \u548c height \u5c5e\u6027\u7684\u8bdd\u4f60\u4f1a\u53d1\u73b0\u4f60\u653e\u7f6e\u4e0d\u4e86\u8fd9\u4e2a\u5b9e\u4f53</p>"},{"location":"begin/simple_texturing/#monocleimage","title":"\u8d34\u56fe\u4ee5\u53ca Monocle.Image","text":""},{"location":"begin/simple_texturing/#_3","title":"\u851a\u84dd\u4fa7","text":"<p>ok \u90a3\u4e48\u73b0\u5728\u6211\u4eec\u8be5\u5728\u4ee3\u7801\u8fd9\u8fb9\u6765\u70b9\u8d34\u56fe\u4e86, \u8fd9\u91cc\u6211\u4eec\u4f1a\u7528\u5230\u4e4b\u524d\u63d0\u5230\u7684 <code>Component</code> \u7684\u6982\u5ff5\u53ca\u5bf9\u5e94\u7684\u4e00\u4e2a\u65b0\u7684\u7c7b <code>Monocle.Image</code>, \u5b83\u7684\u4f5c\u7528\u5c31\u662f\u7ed8\u5236\u8d34\u56fe. \u9996\u5148\u6211\u4eec\u5f97\u8ba9\u6e38\u620f\u627e\u5230\u5e76\u52a0\u8f7d\u5230\u6211\u4eec\u7684\u8d34\u56fe, \u8fd9\u4e00\u6b65\u5f88\u7b80\u5355\u5e76\u7c7b\u4f3c, \u53ea\u9700\u8981\u5957\u51e0\u5c42\u6587\u4ef6\u5939:</p> <ul> <li>ModFolder<ul> <li>Atlases<ul> <li>Graphics<ul> <li>Gameplay<ul> <li><code>MyCelesteMod</code><ul> <li>pass_by_refill.png</li> </ul> </li> </ul> </li> </ul> </li> </ul> </li> </ul> </li> </ul> <p><code>pass_by_refill.png</code> \u5373\u6211\u4eec\u7684\u8d34\u56fe, \u5982\u679c\u4f60\u540c\u65f6\u4e5f\u662f\u4e00\u4f4d mapper \u7684\u8bdd\u4f60\u4e00\u5b9a\u5f88\u719f\u6089\u8fd9\u4e2a\u6587\u4ef6\u5939\u5957\u5957\u4e50! \u5728\u4ee3\u7801\u8fd9\u8fb9, \u6211\u4eec\u4f7f\u7528 <code>GFX.Game[\"MyCelesteMod/pass_by_refill\"]</code> \u6765\u83b7\u53d6\u8fd9\u4e2a\u8d34\u56fe, \u5b83\u662f\u4e00\u4e2a <code>MTexture</code> \u7c7b\u578b\u7684\u5b9e\u4f8b, \u5728\u83b7\u53d6\u5230\u8fd9\u4e2a\u8d34\u56fe\u540e, \u6211\u4eec <code>new</code> \u4e00\u4e2a <code>Monocle.Image</code>, \u7136\u540e\u5728\u6784\u9020\u51fd\u6570\u4e2d\u4f20\u5165\u5b83, \u7136\u540e\u4f7f\u7528 <code>this.Add</code> \u51fd\u6570\u6302\u8f7d\u5230\u6211\u4eec\u7684\u8fd9\u4e2a\u5b9e\u4f53\u4e0a, \u603b\u7684\u4ee3\u7801\u5e94\u8be5\u662f\u8fd9\u6837\u7684: PassByRefill.cs<pre><code>public PassByRefill(Vector2 position, int dashes)\n{\n    Dashes = dashes;\n    Position = position;\n    Hitbox hitbox = new(64, 64);\n    Collider = hitbox;\n\n    MTexture tex = GFX.Game[\"MyCelesteMod/pass_by_refill\"];\n    Image image = new(tex);\n    this.Add(image);\n}\n</code></pre></p> <p>Info</p> <p><code>GFX</code> \u662f\u851a\u84dd\u4e2d\u7684\u4e00\u4e2a\u7ba1\u7406\u8d34\u56fe\u7684\u7c7b, \u6211\u4eec\u7528\u5b83\u83b7\u53d6\u5230\u4e00\u4e2a\u8d34\u56fe\u7ec4 <code>Game</code>, \u7136\u540e\u5411\u5b83\u68c0\u7d22\u4e00\u4e2a\u540d\u4e3a <code>MyCelesteMod/pass_by_refill</code> \u7684\u8d34\u56fe, \u4f60\u53ef\u80fd\u4f1a\u7591\u60d1\u4e3a\u4ec0\u4e48\u8fd9\u91cc\u7684\u8def\u5f84\u53ea\u9700\u8981\u540e\u534a\u90e8\u5206, \u8fd9\u662f\u56e0\u4e3a <code>GFX.Game</code> \u53ea\u4f1a\u68c0\u7d22 <code>Atlases/Graphics/Gameplay</code> \u4e2d\u7684\u5185\u5bb9. \u540c\u6837\u7684, <code>GFX.Portraits</code> \u53ea\u4f1a\u68c0\u7d22 <code>Atlases/Graphics/Portraits</code> \u4e2d\u7684\u5185\u5bb9.</p> <p>\u987a\u4fbf\u8bb0\u5f97\u5220\u6389\u6211\u4eec\u91cd\u5199\u7684 <code>Render</code> \u51fd\u6570, \u6211\u4eec\u4e0d\u518d\u9700\u8981\u5b83\u4e86. \u603b\u7684\u7c7b\u5e94\u8be5\u662f\u8fd9\u6837\u7684: PassByRefill.cs<pre><code>[CustomEntity(\"MyCelesteMod/PassByRefill\")]\n[Tracked]\npublic class PassByRefill : Entity\n{\n    public int Dashes = 0;\n\n    public PassByRefill(Vector2 position, int dashes)\n    {\n        Dashes = dashes;\n        Position = position;\n        Hitbox hitbox = new(64, 64);\n        Collider = hitbox;\n\n        MTexture tex = GFX.Game[\"MyCelesteMod/pass_by_refill\"];\n        Image image = new(tex);\n        this.Add(image);\n    }\n\n    public PassByRefill(EntityData data, Vector2 offset)\n        : this(data.Position + offset, data.Int(\"dashes\"))\n    { }\n\n    public override void Update()\n    {\n        base.Update();\n        var player = Scene.Tracker.GetEntity&lt;Player&gt;();\n        if (this.CollideCheck(player))\n        {\n            player.Dashes = this.Dashes;\n        }\n    }\n}\n</code></pre></p>"},{"location":"begin/simple_texturing/#loenn","title":"Loenn \u4fa7","text":"<p>\u5728 Loenn \u4fa7\u8fd9\u8fb9\u4e5f\u975e\u5e38\u7b80\u5355, \u9996\u5148\u6211\u4eec\u5148\u5927\u80c6\u7684\u5220\u6389 width \u548c height \u5c5e\u6027:</p> AfterBefore PassByRefill.lua<pre><code>local entity = {}\n\nentity.name = \"MyCelesteMod/PassByRefill\"\nentity.placements = {\n    name = \"normal\",\n    data = {\n        dashes = 2\n    }\n}\n\nentity.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n\nreturn entity\n</code></pre> PassByRefill.lua<pre><code>local entity = {}\n\nentity.name = \"MyCelesteMod/PassByRefill\"\nentity.placements = {\n    name = \"normal\",\n    data = {\n        width = 16,\n        height = 16,\n        dashes = 2\n    }\n}\n\nentity.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n\nreturn entity\n</code></pre> <p>\u7136\u540e\u8bbe\u7f6e entity \u7684 <code>texture</code> \u5c5e\u6027, \u8fd9\u4f1a\u8ba9 Loenn \u4e3a\u5176\u8bbe\u7f6e\u8d34\u56fe: <pre><code>entity.texture = \"MyCelesteMod/pass_by_refill\"\n</code></pre> \u8fd9\u91cc\u7684\u8def\u5f84\u4e0e\u6211\u4eec\u4e4b\u524d\u5728\u4ee3\u7801\u4e2d\u7684\u7c7b\u4f3c. \u90a3\u4e48\u73b0\u5728\u603b\u4f53\u4e0a\u770b\u4e0a\u53bb\u5e94\u8be5\u662f\u8fd9\u6837\u7684: <pre><code>local entity = {}\n\nentity.name = \"MyCelesteMod/PassByRefill\"\nentity.placements = {\n    name = \"normal\",\n    data = {\n        dashes = 2\n    }\n}\n\nentity.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n\nentity.texture = \"MyCelesteMod/pass_by_refill\"\n\nreturn entity\n</code></pre></p>"},{"location":"begin/simple_texturing/#_4","title":"\u6700\u540e","text":"<p>\u6700\u540e\u7f16\u8bd1\u6211\u4eec\u7684\u9879\u76ee, \u6253\u5f00\u6216\u8005\u91cd\u542f Loenn, \u4f60\u5c31\u4f1a\u770b\u5230\u6211\u4eec\u7684\u5b9e\u4f53\u6709\u7740\u4e00\u4e2a\u4e0d\u600e\u4e48\u597d\u770b\u7684\u8d34\u56fe\u4e86! \u73b0\u5728\u8fdb\u5165\u5230\u6e38\u620f\u4e2d\u4f60\u4e5f\u4f1a\u770b\u5230\u8fd9\u4e2a\u4e0d\u600e\u4e48\u597d\u770b\u7684\u8d34\u56fe\u4e86!</p>"},{"location":"begin/simple_trigger/","title":"\u7b80\u5355\u81ea\u5b9a\u4e49 Trigger","text":"<p>\u5982\u679c\u4f60\u662f\u4e00\u4f4d Mapper \u7684\u8bdd\u90a3\u4f60\u4e00\u5b9a\u77e5\u9053 Trigger \u662f\u591a\u4e48\u91cd\u8981\u7684\u5b58\u5728. \u5728\u8fd9\u91cc\u53ef\u80fd\u4e0d\u662f\u5f88\u80fd\u5728\u77ed\u7bc7\u5e45\u5185\u8bf4\u660e Trigger \u7684\u91cd\u8981\u6027, \u8fd9\u91cc\u53ea\u7b80\u5355\u4e3e\u51e0\u4e2a\u4f8b\u5b50:</p> <ul> <li>\u7edd\u5927\u90e8\u5206\u955c\u5934\u7684\u79fb\u52a8\u4e0e\u504f\u79fb</li> <li>\u5267\u60c5\u7684\u89e6\u53d1, \u65e0\u5355\u53cc\u51b2\u7684\u5207\u6362</li> <li>\u98ce\u7684\u6539\u53d8</li> <li>\u91cd\u751f\u70b9\u7684\u8bbe\u7f6e</li> <li>\u97f3\u4e50\u53c2\u6570\u7684\u8bbe\u7f6e</li> <li>\u80cc\u666f\u7684\u6e10\u53d8, \u524d\u666f\u7684\u5404\u79cd\u53d8\u6362</li> </ul> <p>\u4ee5\u4e0a\u51e0\u4e2a\u4f8b\u5b50\u4e0d\u8bf4\u7edd\u5927\u90e8\u5206, \u4e5f\u6709\u5f88\u5927\u7684\u5360\u6bd4\u90fd\u662f\u7531 Trigger \u5b8c\u6210\u7684. Trigger \u662f Entity \u7684\u5b50\u7c7b, \u5b83\u5e26\u6709\u4e00\u4e2a\u957f\u65b9\u5f62\u7684\u78b0\u649e\u7bb1, \u901a\u5e38\u5b83\u662f\u5bf9\u73a9\u5bb6\u4e0d\u53ef\u89c1\u7684, \u5f53\u73a9\u5bb6 <code>\u8fdb\u5165(OnEnter)</code>, <code>\u4fdd\u6301(OnStay)</code>, <code>\u79bb\u5f00(OnLeave)</code> \u4f1a\u5206\u522b\u6267\u884c\u4e0d\u540c\u7684\u52a8\u4f5c, \u6bd4\u5982\u8bf4\u5f53\u73a9\u5bb6 <code>\u8fdb\u5165</code> \u6539\u53d8\u98ce\u7684 Trigger \u65f6\u4f1a\u6539\u53d8\u573a\u4e0a\u7684\u98ce\u7684\u60c5\u51b5, \u5f53\u73a9\u5bb6 <code>\u4fdd\u6301</code> \u5728\u955c\u5934\u504f\u79fb\u6539\u53d8 Trigger \u91cc\u65f6\u4f1a\u4fdd\u6301\u955c\u5934\u76f8\u5bf9\u4e8e\u73a9\u5bb6\u7684\u504f\u79fb\u4e8e\u4e00\u4e2a\u503c.</p> <p>Info</p> <p>\u5728\u5b98\u56fe\u7b2c\u4e5d\u7ae0\u5047\u5fc3\u9644\u8fd1\u7684 Trigger \u770b\u4e0a\u53bb\u5c31\u50cf:  \u5728\u8fd9\u91cc, \u5de6\u8fb9\u6709\u4e2a\u8bbe\u7f6e\u91cd\u751f\u70b9\u7684 Trigger, \u4e2d\u95f4\u6709\u4e2a\u4fdd\u6301\u955c\u5934\u4f4d\u7f6e\u7684 Trigger, \u800c\u5728\u53f3\u8fb9\u6709\u4e2a\u66f4\u6539\u80cc\u666f\u7684 Trigger.</p> <p>\u90a3\u4e48, \u662f\u65f6\u5019\u5236\u4f5c\u4e00\u4e2a\u5c5e\u4e8e\u6211\u4eec\u81ea\u5df1\u7684 Trigger \u4e86, \u7b80\u5355\u8d77\u89c1\u8fd9\u91cc\u6211\u4eec\u53ea\u505a\u51e0\u4e2a\u6700\u7b80\u5355\u7684\u529f\u80fd:</p> <ul> <li>\u5b83\u53eb <code>SetPassByRefillDashesTrigger</code></li> <li>\u73a9\u5bb6\u8fdb\u5165\u540e\u4fee\u6539\u573a\u4e0a\u6240\u6709\u6211\u4eec\u4e4b\u524d\u7684 <code>PassByRefill</code> \u5b9e\u4f53\u7684\u51b2\u523a\u6570</li> <li>\u6ca1\u4e86, \u662f\u7684, \u5c31\u662f\u8fd9\u4e48\u7b80\u5355!</li> </ul>"},{"location":"begin/simple_trigger/#entity","title":"\u50cf\u5bf9 Entity \u4e00\u6837\u5730\u505a\u51c6\u5907\u5de5\u4f5c","text":"<p>\u9996\u5148\u5728\u4ee3\u7801\u4e2d\u51c6\u5907\u6211\u4eec\u7684\u7c7b, \u4e0d\u8fc7\u8fd9\u6b21\u6211\u4eec\u7ee7\u627f\u7684\u662f <code>Trigger</code>. \u54e6\u5bf9\u4e86, \u5b83\u8fd8\u4f1a\u8981\u6c42\u58f0\u660e\u4e00\u4e2a\u5e26\u53c2\u7684\u6784\u9020\u51fd\u6570, \u56e0\u4e3a <code>Trigger</code> \u57fa\u7c7b\u6ca1\u6709\u65e0\u53c2\u6784\u9020\u5668, \u6240\u4ee5\u4f60\u53ef\u80fd\u9700\u8981\u50cf\u5982\u4e0b\u4e00\u6837\u58f0\u660e\u4e00\u4e0b: SetPassByRefillDashesTrigger.cs<pre><code>[CustomEntity(\"MyCelesteMod/SetPassByRefillDashesTrigger\")]\npublic class SetPassByRefillDashesTrigger : Trigger\n{\n    public SetPassByRefillDashesTrigger(EntityData data, Vector2 offset)\n        : base(data, offset)\n    {\n\n    }\n}\n</code></pre> \u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5176\u5b9e\u5b83\u8981\u6c42\u7684\u5c31\u662f Everest \u8981\u6c42\u6211\u4eec\u5b9a\u4e49\u7684\u90a3\u4e2a! \u90a3\u521a\u597d\u6211\u4eec\u5c31\u4e0d\u7528\u518d\u989d\u5916\u5b9a\u4e49\u4e00\u4e2a\u4e86. \u7136\u540e\u6211\u4eec\u7a0d\u4f5c\u66f4\u6539, \u4ee5\u8ba9\u5b83\u4e5f\u80fd\u63d0\u53d6\u5230\u4e00\u4e2a\u53eb <code>dashes</code> \u7684\u6570\u636e: SetPassByRefillDashesTrigger.cs<pre><code>public int Dashes;\n\npublic SetPassByRefillDashesTrigger(EntityData data, Vector2 offset)\n    : base(data, offset)\n{\n    Dashes = data.Int(\"dashes\");\n}\n</code></pre></p> <p>\u6784\u9020\u51fd\u6570\u94fe</p> <p>\u5f62\u5982 <code>: base(data, offset)</code> <code>: this(position)</code> \u7684\u8fd9\u79cd\u8bed\u6cd5\u53eb\u505a\u6784\u9020\u51fd\u6570\u94fe, \u8fd9\u4e00\u90e8\u5206\u4f3c\u4e4e\u5f88\u591a C# \u6559\u7a0b\u6ca1\u6709\u7279\u522b\u63d0\u53ca, \u5982\u679c\u4f60\u5bf9\u6b64\u4e0d\u662f\u5f88\u4e86\u89e3\u7684\u8bdd\u6211\u63a8\u8350\u4f60\u53bb\u67e5\u9605\u4e86\u89e3\u8be5\u8bed\u6cd5.</p> <p>\u4f60\u53ef\u80fd\u6ce8\u610f\u5230 Trigger \u4e00\u822c\u90fd\u662f\u6709\u5bbd\u5ea6\u548c\u9ad8\u5ea6\u7684, \u5728\u8fd9\u91cc\u6211\u4eec\u5e76\u6ca1\u6709\u7528 <code>EntityData data</code> \u53bb\u83b7\u53d6, \u800c\u4e14\u6211\u4eec\u4e5f\u6ca1\u8bbe\u7f6e\u5b83\u7684 <code>Position</code>! \u5b9e\u9645\u4e0a\u5f53\u4f60 <code>: base(data, offset)</code> \u65f6\u8fd9\u4e9b\u4e8b\u60c5\u5df2\u7ecf\u7531\u7236\u7c7b Trigger \u7684\u6784\u9020\u51fd\u6570\u505a\u4e86, \u5982\u679c\u4f60\u597d\u5947\u53ef\u4ee5\u7ffb\u9605 <code>Trigger</code> \u6784\u9020\u51fd\u6570\u9644\u8fd1\u7684\u4ee3\u7801.</p> Trigger.Trigger(EntityData data, Vector2 offset) <pre><code>/// .......\npublic Trigger(EntityData data, Vector2 offset)\n    : base(data.Position + offset)\n{\n    base.Collider = new Hitbox(data.Width, data.Height);\n    Visible = false;\n}\n/// .......\n</code></pre>"},{"location":"begin/simple_trigger/#trigger_1","title":"Trigger \u7684\u5b9e\u9645\u529f\u80fd","text":"<p>ok \u73b0\u5728\u8ba9\u6211\u4eec\u60f3\u60f3\u6211\u4eec\u7684 Trigger \u7684\u529f\u80fd\u5982\u4f55\u5b9e\u73b0. \u5b83\u5927\u6982\u5c31\u662f:</p> <ul> <li>\u68c0\u6d4b\u73a9\u5bb6\u662f\u5426\u8fdb\u5165<ul> <li>\u8bbe\u7f6e\u573a\u4e0a\u6240\u6709 <code>PassByRefill</code> \u7684 <code>Dashes</code> \u5b57\u6bb5</li> </ul> </li> <li>\u6ca1\u4e86</li> </ul> <p>\u5728\u8fd9\u91cc\u6211\u4eec\u4f1a\u4f7f\u7528 Trigger \u7684 <code>OnEnter</code> \u865a\u51fd\u6570, \u5b83\u4f1a\u5728\u73a9\u5bb6\u9996\u6b21\u8fdb\u5165\u76841\u5e27\u88ab\u8c03\u75281\u6b21. SetPassByRefillDashesTrigger.cs<pre><code>public override void OnEnter(Player player)\n{\n    base.OnEnter(player);\n}\n</code></pre></p> <p>Note</p> <p>\u851a\u84dd\u5185\u90e8\u5927\u90e8\u5206\u865a\u51fd\u6570\u91cd\u5199\u65f6\u6700\u597d\u5728\u5f00\u5934\u8c03\u7528\u4e00\u904d\u57fa\u7c7b\u7684\u5b9e\u73b0, \u9664\u975e\u4f60\u771f\u7684\u77e5\u9053\u5b83\u505a\u4e86\u4ec0\u4e48\u5e76\u4e14\u4f60\u771f\u7684\u4e0d\u9700\u8981\u5b83.</p> <p>\u7136\u540e\u662f\u83b7\u53d6\u573a\u4e0a\u6240\u6709\u7684 <code>PassByRefill</code>, \u4ee5\u4fbf\u6211\u4eec\u80fd\u8bbe\u7f6e\u5b83\u4eec\u7684 <code>Dashes</code>. \u8fd9\u91cc\u6211\u4eec\u4f1a\u642c\u51fa\u4e00\u4e2a\u4f60\u53ef\u80fd\u773c\u719f\u7684\u4e00\u4e32: SetPassByRefillDashesTrigger.OnEnter(Player player)<pre><code>// \u83b7\u53d6\u6240\u6709\u7684 PassByRefill\nvar refills = Scene.Tracker.GetEntities&lt;PassByRefill&gt;();\n</code></pre></p> <p>\u5728\u8fd9\u91cc\u6216\u8bb8\u8be5\u4ecb\u7ecd\u4ecb\u7ecd\u8fd9\u4e00\u4e32\u662f\u4ec0\u4e48\u4e86, \u9996\u5148\u6211\u4eec\u901a\u8fc7 <code>Scene</code> \u5c5e\u6027\u83b7\u53d6\u81ea\u8eab\u6240\u5728\u7684\u573a\u666f, \u7136\u540e\u83b7\u53d6\u5b83\u7684 <code>Tracker</code>. Tracker \u662f\u851a\u84dd\u573a\u666f\u5185\u7684\u4e00\u4e2a\u8f85\u52a9\u7c7b, \u5b83\u53ef\u4ee5\u5f88\u5feb\u7684\u5e2e\u4f60\u7b5b\u9009\u51fa\u573a\u4e0a\u7684\u5b9e\u4f53, \u5728\u8fd9\u91cc\u6211\u4eec\u4f7f\u7528\u5b83\u7684 <code>GetEntities&lt;T&gt;</code> \u6765\u7b5b\u9009\u51fa\u6240\u6709\u7c7b\u578b\u4e3a <code>T</code>, \u4e5f\u5c31\u662f <code>PassByRefill</code> \u7684\u5b9e\u4f53. \u90e8\u5206\u5b9e\u4f53\u5728\u573a\u4e0a\u53ef\u80fd\u6c38\u8fdc\u53ea\u6709\u4e00\u4e2a\u5b9e\u4f8b\u65f6, \u6bd4\u5982\u8bf4\u6211\u4eec\u7684 <code>Player</code>, \u9664\u975e\u4f60\u5b89\u88c5\u4e86\u5947\u5947\u602a\u602a\u7684 mod, \u5426\u5219\u5b83\u6c38\u8fdc\u53ea\u6709\u4e00\u4e2a\u5b9e\u4f8b, \u8fd9\u79cd\u60c5\u51b5\u4e0b\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 <code>GetEntity</code>, \u5b83\u53ea\u4f1a\u8fd4\u56de\u4e00\u4e2a\u5b9e\u4f8b. \u90a3\u4e48\u4f60\u73b0\u5728\u5e94\u8be5\u61c2\u5f97\u4e4b\u524d\u6211\u4eec\u5199\u4e0b\u7684 <code>Scene.Tracker.GetEntity&lt;Player&gt;()</code> \u662f\u4ec0\u4e48\u610f\u601d\u4e86: \"\u4f7f\u7528\u573a\u666f\u7684 Tracker \u83b7\u53d6\u573a\u4e0a\u552f\u4e00\u7684\u90a3\u4e2a Player \u5b9e\u4f8b\".  </p> <p>\u54e6\u5bf9\u4e86, \u6211\u4eec\u8fd8\u5f97\u5728\u6211\u4eec\u60f3\u8981 Tracker \u83b7\u53d6\u7684\u5b9e\u4f53\u7684\u7c7b\u4e0a\u52a0\u4e00\u4e2a <code>Tracked</code> \u7279\u6027, \u5c31\u50cf: PassByRefill.cs<pre><code>[CustomEntity(\"MyCelesteMod/PassByRefill\")]\n[Tracked]\npublic class PassByRefill : Entity\n{\n</code></pre> \u8fd9\u4e00\u6b65\u5176\u5b9e\u5f88\u5bb9\u6613\u88ab\u5fd8\u8bb0, \u5c31\u50cf\u6211\u5199\u5b8c\u521d\u7a3f\u5e76\u505a\u5230\u6700\u540e\u4e00\u6b65\u6e38\u620f\u5d29\u6e83\u65f6\u624d\u60f3\u8d77\u6765(\u4e50).</p> <p>\u597d\u7684\u7136\u540e\u6211\u4eec\u8be5\u8bbe\u7f6e <code>PassByRefill</code> \u4eec\u7684 <code>Dashes</code>... \u989d\u7b49\u7b49! \u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u8fd9\u91cc\u7684 <code>refills</code> \u5c40\u90e8\u53d8\u91cf\u5176\u5b9e\u662f\u4e2a <code>List&lt;Entity&gt;</code> \u7c7b\u578b, \u8fd9\u4e2a\u6211\u4e0d\u592a\u6e05\u695a\u4e3a\u4ec0\u4e48, \u4f30\u8ba1\u662f\u4e00\u4e2a <code>Monocle</code> \u5728\u5b9e\u73b0\u4e2d\u7684\u4e00\u4e2a\u5c0f\u9519\u8bef, \u4e3a\u4e86\u7ea0\u6b63\u5b83\u8fd9\u91cc\u6211\u4f1a\u4f7f\u7528 <code>Linq</code> \u7684 <code>Cast</code> \u6765\u8f6c\u6362\u4e00\u4e0b\u7c7b\u578b:</p> SetPassByRefillDashesTrigger.OnEnter(Player player)<pre><code>var refills = Scene.Tracker.GetEntities&lt;PassByRefill&gt;().Cast&lt;PassByRefill&gt;();\n</code></pre> <p>ok, \u73b0\u5728\u6211\u4eec\u5c31\u53ef\u4ee5\u5f00\u59cb\u904d\u5386\u5e76\u8bbe\u7f6e\u4e86: SetPassByRefillDashesTrigger.OnEnter(Player player)<pre><code>foreach(var refill in refills)\n{\n    refill.Dashes = this.Dashes;\n}\n</code></pre></p> <p>\u6700\u540e, \u4f60\u7684\u4ee3\u7801\u5e94\u8be5\u603b\u4f53\u4e0a\u662f\u8fd9\u4e2a\u6837\u5b50: SetPassByRefillDashesTrigger.cs<pre><code>using Celeste.Mod.Entities;\n\nnamespace MyCelesteMod;\n\n[CustomEntity(\"MyCelesteMod/SetPassByRefillDashesTrigger\")]\npublic class SetPassByRefillDashesTrigger : Trigger\n{\n    public int Dashes;\n\n    public SetPassByRefillDashesTrigger(EntityData data, Vector2 offset)\n        : base(data, offset)\n    {\n        Dashes = data.Int(\"dashes\");\n    }\n\n    public override void OnEnter(Player player)\n    {\n        base.OnEnter(player);\n        var refills = Scene.Tracker.GetEntities&lt;PassByRefill&gt;().Cast&lt;PassByRefill&gt;();\n        foreach(var refill in refills)\n        {\n            refill.Dashes = this.Dashes;\n        }\n    }\n}\n</code></pre></p>"},{"location":"begin/simple_trigger/#loenn","title":"Loenn \u914d\u7f6e","text":"<p>ok \u6211\u4eec\u7684 Trigger \u7684\u4ee3\u7801\u5df2\u7ecf\u5199\u597d\u4e86, \u63a5\u4e0b\u6765\u5199\u4e00\u4e2a Loenn \u914d\u7f6e\u5c31\u597d\u4e86, \u8fd9\u4e00\u6b65\u4e0e Entity \u7684\u5f88\u50cf, \u4e0d\u8fc7\u4f60\u9700\u8981\u628a\u5b83\u653e\u5230 triggers \u6587\u4ef6\u5939\u5185:</p> <ul> <li>ModFolder<ul> <li>Loenn<ul> <li>entities<ul> <li>PassByRefill.lua</li> </ul> </li> <li>triggers<ul> <li>SetPassByRefillDashesTrigger.lua</li> </ul> </li> </ul> </li> </ul> </li> </ul> <p>\u5185\u5bb9\u5927\u540c\u5c0f\u5f02:</p> SetPassByRefillDashesTrigger.lua<pre><code>local trigger = {}\n\ntrigger.name = \"MyCelesteMod/SetPassByRefillDashesTrigger\"\ntrigger.placements = {\n    name = \"normal\",\n    data = {\n        width = 16,\n        height = 16,\n        dashes = 2\n    }\n}\n\ntrigger.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n\nreturn trigger\n</code></pre> <p>\u6700\u540e\u8bb0\u5f97\u5199\u4e2a\u672c\u5730\u5316\u4fe1\u606f, \u4e0d\u7136\u5b83\u7684\u540d\u5b57\u80af\u5b9a\u4f1a\u5f88\u4e11! \u8fd9\u4e00\u6b65\u4e5f\u662f\u5f88\u7c7b\u4f3c\u7684: <pre><code>entities.MyCelesteMod/PassByRefill.placements.name.normal=PassByRefill\ntriggers.MyCelesteMod/SetPassByRefillDashesTrigger.placements.name.normal=SetPassByRefillDashesTrigger\n</code></pre></p> <p>Note</p> <p>\u522b\u5fd8\u4e86\u7f16\u8bd1, \u4e0d\u8981\u50cf\u6211\u4e00\u6837\u5bf9\u7740 Loenn \u7591\u60d1\u6211\u7684 trigger/\u5b9e\u4f53 \u600e\u4e48\u4e0d\u89c1\u4e86(</p>"},{"location":"begin/simple_trigger/#_1","title":"\u6548\u679c","text":"<p>\u73b0\u5728\u5728\u4f60\u7684\u5730\u56fe\u4e0a\u6446\u653e\u8fd9\u4e2a trigger \u4ee5\u53ca\u51e0\u4e2a <code>PassByRefill</code>. \u6211\u5728\u8fd9\u91cc\u4f1a\u6446\u51e0\u4e2a\u80cc\u666f\u7816\u6765\u5e2e\u6211\u4eec\u8fa8\u8bc6\u8fd9\u4e2a trigger \u5728\u54ea, \u56e0\u4e3a trigger \u901a\u5e38\u90fd\u662f\u4e0d\u53ef\u89c1\u7684.  \u90a3\u4e48\u89c1\u8bc1\u4f60\u7684\u6770\u4f5c\u5427! </p> <p>\u8fdb\u5165 trigger \u524d (PassByRefill \u7684 Dashes \u8bbe\u7f6e\u4e3a 2): \u8fdb\u5165 trigger \u540e (\u88ab\u8bbe\u7f6e\u4e3a 1 \u4e86): </p>"},{"location":"other/xml-speedrun/","title":"XML \u7b80\u5355\u4ecb\u7ecd","text":"<p>\u8fd9\u91cc\u4e3a\u4e86\u65b9\u4fbf\u67d0\u4e9b\u6ca1\u542c\u8bf4\u8fc7 XML \u7684\u4eba\u5feb\u901f\u4e86\u89e3 XML \u7684\u5927\u81f4\u8bed\u6cd5\u662f\u4ec0\u4e48, \u6240\u4ee5\u5f88\u591a\u7ec6\u8282\u65b9\u9762\u7684\u95ee\u9898\u6211\u4f1a\u76f4\u63a5\u5ffd\u7565, \u90a3\u4e48, \u5c31\u6b64\u5f00\u59cb\u5427:</p>"},{"location":"other/xml-speedrun/#_1","title":"\u5b9a\u4e49","text":"<p>\u8fd9\u91cc\u6458\u6284\u4e00\u4e0b:</p> <p>XML \u6307\u53ef\u6269\u5c55\u6807\u8bb0\u8bed\u8a00(eXtensible Markup Language). XML \u88ab\u8bbe\u8ba1\u7528\u6765\u4f20\u8f93\u548c\u5b58\u50a8\u6570\u636e, \u4e0d\u7528\u4e8e\u8868\u73b0\u548c\u5c55\u793a\u6570\u636e, HTML \u5219\u7528\u6765\u8868\u73b0\u6570\u636e.</p> <p>XML \u662f\u4e00\u79cd\u4ee5\u683c\u5f0f\u5316\u50a8\u5b58\u6570\u636e\u7684\u8bed\u8a00, \u5728 <code>msbuild</code> \u4e2d\u5b83\u5c31\u88ab\u7528\u6765\u4ee5\u683c\u5f0f\u5316\u7684\u65b9\u5f0f\u63cf\u8ff0\u6574\u4e2a\u9879\u76ee\u7684\u4fe1\u606f.</p>"},{"location":"other/xml-speedrun/#_2","title":"\u8282\u70b9, \u7279\u6027","text":"<p>\u4e00\u6bb5\u5f88\u57fa\u7840\u7684 XML \u53ef\u80fd\u662f\u8fd9\u4e2a\u6837\u5b50\u7684:</p> <pre><code>&lt;books&gt;\n    &lt;book id=\"123\"&gt;\u8fd9\u662f\u7b2c\u4e00\u672c\u4e66&lt;/book&gt;\n    &lt;book id=\"456\"&gt;\u8fd9\u662f\u7b2c\u4e8c\u672c\u4e66&lt;/book&gt;\n    &lt;book id=\"114\"&gt;\u8fd9\u662f\u7b2c\u4e09\u672c\u4e66&lt;/book&gt;\n    &lt;book id=\"514\"&gt;\u8fd9\u662f\u4e0d\u77e5\u9053\u7b2c\u51e0\u672c\u4e66&lt;/book&gt;\n&lt;/books&gt;\n</code></pre> <p>\u8fd9\u6bb5 XML \u7528\u4e2d\u6587\u89e3\u91ca\u8d77\u6765\u662f\u8fd9\u6837\u7684:</p> <p>\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u4e86\u4e00\u4e2a\u8282\u70b9, \u5b83\u7684\u540d\u5b57\u53eb\u505a \"books\", \u5b83\u6709\u5f88\u591a\u5b50\u8282\u70b9, \u5206\u522b\u662f:</p> <ul> <li>\u4e00\u4e2a \"book\" \u8282\u70b9, \u5b83\u7684 id \u7279\u6027\u662f 123, \u5b83\u7684\u5185\u5bb9\u662f \"\u8fd9\u662f\u7b2c\u4e00\u672c\u4e66\"</li> <li>\u4e00\u4e2a \"book\" \u8282\u70b9, \u5b83\u7684 id \u7279\u6027\u662f 456, \u5b83\u7684\u5185\u5bb9\u662f \"\u8fd9\u662f\u7b2c\u4e8c\u672c\u4e66\"</li> <li>\u4e00\u4e2a \"book\" \u8282\u70b9, \u5b83\u7684 id \u7279\u6027\u662f 114, \u5b83\u7684\u5185\u5bb9\u662f \"\u8fd9\u662f\u7b2c\u4e09\u672c\u4e66\"</li> <li>\u4e00\u4e2a \"book\" \u8282\u70b9, \u5b83\u7684 id \u7279\u6027\u662f 514, \u5b83\u7684\u5185\u5bb9\u662f \"\u8fd9\u662f\u4e0d\u77e5\u9053\u7b2c\u51e0\u672c\u4e66\"</li> </ul> <p>\u5728\u8fd9\u91cc, \u6700\u5916\u5c42\u7684 \"books\" \u4ee5\u53ca\u91cc\u9762\u7684 \"book\" \u90fd\u79f0\u4e3a\u8282\u70b9, \u5176\u4e2d \"books\" \u8282\u70b9\u5185\u90e8\u6709\u5f88\u591a \"book\" \u8282\u70b9, \u800c \"book\" \u8282\u70b9\u5185\u90e8\u53ea\u6709\u4e00\u4e32\u6587\u672c. \u6bcf\u4e2a \"book\" \u8282\u70b9\u90fd\u6709\u4e00\u4e2a\u53eb\u505a id \u7684\u7279\u6027(\u6709\u65f6\u4e5f\u53eb\u505a\u5c5e\u6027, \u4e0d\u8fc7\u6ce8\u610f\u522b\u4e0e C# \u7684\u5c5e\u6027/\u7279\u6027\u76f8\u6df7\u6dc6).  </p> <p>\u5728\u8bed\u6cd5\u5c42\u9762\u4e0a, \u4e00\u4e2a\u8282\u70b9\u4ee5 &lt;\u540d\u5b57&gt; \u5f00\u59cb\u58f0\u660e, \u5728\u53d9\u8ff0\u5b8c\u5b83\u7684\u5185\u5bb9\u540e\u4ee5 &lt;/\u540d\u5b57&gt; \u7ed3\u675f. \u5c5e\u6027\u5219\u5728\u8282\u70b9\u540d\u79f0\u4e4b\u540e\u4ee5\u7a7a\u683c\u5206\u9694\u6392\u5217: &lt;\u540d\u5b57 \u5c5e\u60271=\"\u503c1\" \u5c5e\u60272=\"\u503c2\"&gt;, \u5c5e\u6027\u7684\u503c\u9700\u8981\u7531 <code>\"</code> \u5305\u88f9. \u5bf9\u4e8e\u4e00\u4e9b\u6ca1\u6709\u5185\u90e8\u5185\u5bb9\u7684\u8282\u70b9, \u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u81ea\u7ed3\u675f\u8bed\u6cd5: <pre><code>&lt;columns&gt;\n    &lt;column id=\"xxx\"/&gt;\n    &lt;column qwq=\"6\" awa=\"4\"/&gt;\n    &lt;column/&gt;\n    &lt;column/&gt;\n    &lt;column/&gt;\n&lt;/columns&gt;\n</code></pre></p> <p>XML \u5141\u8bb8\u4ee5\u4efb\u610f\u6df1\u5ea6\u6765\u5d4c\u5957, \u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u6765\u7ec4\u88c5\u4e00\u4e2a\u5f88\u590d\u6742\u7684 XML:</p> <pre><code>&lt;books&gt;\n    &lt;book id=\"123\"&gt;\n        &lt;bookmarks page=\"1\"&gt;114514&lt;/bookmarks&gt;\n        &lt;bookmarks page=\"2\"&gt;2333&lt;/bookmarks&gt;\n        &lt;bookmarks page=\"123\"&gt;838&lt;/bookmarks&gt;\n    &lt;/book&gt;\n    &lt;book id=\"456\"&gt;\n        &lt;bookmarks page=\"1\"&gt;\n            &lt;picture src=\"http://example.com\"&gt;\n                this is alt\n            &lt;/picture&gt;\n            &lt;text content=\"text here!\"/&gt;\n        &lt;/bookmarks&gt;\n        &lt;bookmarks page=\"2\"&gt;2333&lt;/bookmarks&gt;\n    &lt;/book&gt;\n&lt;/books&gt;\n</code></pre>"},{"location":"trans/adv_hooks/","title":"IL \u94a9\u5b50\u4e0e\u968f\u610f\u94a9\u53d6","text":""},{"location":"trans/adv_hooks/#il_1","title":"IL \u94a9\u5b50","text":""},{"location":"trans/adv_hooks/#il_2","title":"\u63d2\u5165 IL","text":"<p>\u73b0\u5728, \u4f60\u5df2\u7ecf\u4e86\u89e3\u4e86\u57fa\u672c\u7684 IL \u77e5\u8bc6, \u7a0d\u5fae\u4f1a\u4f7f\u7528 <code>System.Reflection.Emit</code> \u5e93\u4e86, \u90a3\u4e48\u6211\u4eec\u5c31\u53ef\u4ee5\u5f00\u59cb\u4f7f\u7528 IL \u94a9\u5b50\u4e86. IL \u94a9\u5b50\u5141\u8bb8\u4f60\u4fee\u6539\u851a\u84dd\u7684\u4ee3\u7801, \u8fd9\u662f\u4e00\u4e2a\u5f88\u5f3a\u5927\u7684\u529f\u80fd, \u90a3\u4e48\u81ea\u7136\u800c\u7136, \u5b83\u7684\u4f7f\u7528\u4e5f\u4f1a\u53d8\u5f97\u66f4\u52a0\u590d\u6742.  </p> <p>IL \u94a9\u5b50\u4e0e On \u94a9\u5b50\u7684\u4e8b\u4ef6\u8ba2\u9605\u65b9\u5f0f\u5f88\u76f8\u50cf, \u53ea\u4e0d\u8fc7\u662f\u6362\u6210\u4e86 IL \u547d\u540d\u7a7a\u95f4, \u4e0d\u8fc7\u8981\u6ce8\u610f\u7684\u662f, \u65b9\u6cd5\u7684\u53c2\u6570\u4e0d\u518d\u662f\u539f\u51fd\u6570\u59d4\u6258\u52a0\u4e0a\u5176\u5bf9\u5e94\u53c2\u6570\u4e86, \u800c\u662f\u4e00\u4e2a <code>ILContext</code> \u7c7b\u578b\u7684\u503c, \u540c\u65f6, \u65b9\u6cd5\u4e5f\u4e0d\u662f\u6bcf\u6b21\u8c03\u7528\u88ab\u94a9\u65b9\u6cd5\u65f6\u8c03\u7528, \u800c\u662f\u4ec5\u5728\u6e38\u620f\u542f\u52a8\u65f6\u8c03\u7528. \u4f8b\u5982, \u94a9\u53d6\u73a9\u5bb6\u7684 <code>SuperWallJump</code> \u65b9\u6cd5(\u5728\u73a9\u5bb6\u505a\u51fa\u4e86\u4e00\u4e2a\u8e6d\u5899\u65f6\u8c03\u7528):</p> <pre><code>public override void Load()\n{\n    IL.Celeste.Player.SuperWallJump += Player_SuperWallJump;\n}\n\nprivate void Player_SuperWallJump(ILContext il)\n{\n\n}\n\npublic override void Unload()\n{\n    IL.Celeste.Player.SuperWallJump -= Player_SuperWallJump;\n}\n</code></pre> <p>\u73b0\u5728, \u6211\u4eec\u83b7\u53d6\u5230\u4e86\u4e00\u4e2a <code>ILContext</code>, \u5b83\u8868\u793a\u8fd9\u4e2a\u65b9\u6cd5\u7684 <code>IL</code> \u4e0a\u4e0b\u6587, \u4e0d\u8fc7\u5728\u8fd9\u91cc\u4f60\u4e0d\u9700\u8981\u77e5\u9053\u8fd9\u662f\u4ec0\u4e48, \u6211\u4eec\u901a\u5e38\u8981\u7684\u53ea\u662f\u4f7f\u7528\u5176\u521b\u5efa\u4e00\u4e2a <code>ILCursor</code>:</p> <pre><code>ILCursor cur = new(il);\n</code></pre> <p>\u987e\u540d\u601d\u4e49, \u8fd9\u662f\u4e00\u4e2a \"IL \u6307\u9488\", \u5b83 \"\u6307\u5411\" \u8fd9\u4e2a\u65b9\u6cd5\u7684 IL \u4ee3\u7801\u7684\u67d0\u4e00\u884c, \u5b83\u62e5\u6709\u5f88\u591a\u65b9\u6cd5\u4ee5\u5141\u8bb8\u6211\u4eec\u5728\u5b83\u6307\u5411\u7684\u4f4d\u7f6e\u4e0b\u6dfb\u52a0, \u4fee\u6539, \u5220\u9664 IL, \u81ea\u7136, \u5b83\u4e5f\u5e26\u6709\u5f88\u591a\u65b9\u6cd5\u6765\u79fb\u52a8\u5b83\u7684\u6307\u5411, \u6700\u5e38\u7528\u7684\u65b9\u6cd5\u4e4b\u4e00\u662f <code>TryGotoNext</code>, \u5b83\u7684\u53c2\u6570\u5217\u8868\u5305\u542b\u4e00\u7cfb\u5217\u7684 <code>predicates</code>(\u8fd9\u8bcd\u4f3c\u4e4e\u6ca1\u4e2a\u7edf\u4e00\u7684\u7ffb\u8bd1, \u4e0d\u8fc7\u7406\u89e3\u5b83\u5f88\u7b80\u5355).  </p> <p>\u73b0\u5728, \u5047\u8bbe\u6211\u4eec\u7684\u76ee\u7684\u662f\u4fee\u6539\u73a9\u5bb6\u8e6d\u5899\u8df3\u65f6\u7684\u7ad6\u76f4\u901f\u5ea6\u4e3a 2 \u500d, \u90a3\u4e48\u6211\u4eec\u627e\u5230 <code>SuperWallJump</code> \u65b9\u6cd5, \u6ce8\u610f\u5230\u7ad6\u76f4\u901f\u5ea6\u662f\u5728\u8fd9\u91cc\u8bbe\u7f6e\u7684:</p> Celeste.Player.SuperWallJump()<pre><code>...\nthis.wallSlideTimer = 1.2f;\nthis.wallBoostTimer = 0f;\nthis.Speed.X = 170f * (float)dir;\nthis.Speed.Y = -160f;\nthis.Speed += this.LiftBoost;\nthis.varJumpSpeed = this.Speed.Y;\nthis.launched = true;\n...\n</code></pre> <p>\u90a3\u4e48\u6211\u4eec\u67e5\u770b\u5b83\u9644\u8fd1 IL, \u7136\u540e\u67e5\u627e\u8fd9\u90e8\u5206 IL \u7684\u4e00\u4e2a\u7279\u5f81\u4ee5\u65b9\u4fbf\u6211\u4eec\u8fdb\u884c\u5b9a\u4f4d:</p> Celeste.Player.SuperWallJump()<pre><code>IL_0075: ldarg.1\nIL_0076: conv.r4\nIL_0077: mul\nIL_0078: stfld     float32 [FNA]Microsoft.Xna.Framework.Vector2::X\nIL_007D: ldarg.0\nIL_007E: ldflda    valuetype [FNA]Microsoft.Xna.Framework.Vector2 Celeste.Player::Speed\nIL_0083: ldc.r4    -160\nIL_0088: stfld     float32 [FNA]Microsoft.Xna.Framework.Vector2::Y\nIL_008D: ldarg.0\nIL_008E: ldarg.0\n</code></pre> <p>\u6211\u4eec\u53d1\u73b0\u8fd9\u91cc\u6709\u4e00\u4e2a\u5f88\u7279\u6b8a\u7684 -160 \u6d6e\u70b9\u6570\u7684\u538b\u5165, \u5e76\u4e14\u7d27\u968f\u5176\u540e\u7684\u662f\u4e00\u4e2a <code>Vector2::Y</code> \u5b57\u6bb5\u7684\u5b58\u5165, \u90a3\u4e48\u8fd9\u6837\u6211\u4eec\u5c31\u53ef\u4ee5\u4f7f\u7528\u8fd9\u4e2a\u7279\u5f81\u5c06 IL \u6307\u9488\u6307\u5411\u8fd9\u91cc:</p> <pre><code>if (cur.TryGotoNext(ins =&gt; ins.MatchLdcR4(-160f), ins =&gt; ins.MatchStfld&lt;Vector2&gt;(\"Y\")))\n{\n    // \u6307\u9488\u4f4d\u4e8e ldc.r4 \u6307\u4ee4\u4e86\n}\n</code></pre> <p>\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u6211\u4eec\u8981\u6c42 IL \u6307\u9488\u5411\u4e0b\u67e5\u627e, \u76f4\u5230\u627e\u5230\u4e00\u4e2a\u4f4d\u7f6e\u4f7f\u5f97 IL \u662f <code>ldc.r4 -160f</code> \u5e76\u4e14\u4e0b\u4e00\u884c\u662f\u50a8\u5b58\u5230 <code>Vector2</code> <code>Y</code> \u5b57\u6bb5. \u5982\u679c\u6ca1\u627e\u5230\u5219\u8fd4\u56de <code>false</code>. \u73b0\u5728, \u6211\u4eec\u7684\u6307\u9488\u5df2\u7ecf\u6307\u5411 <code>ldc.r4</code> \u4e86, \u4f46\u662f\u6b64\u65f6\u5728\u8fd9\u4e2a\u4f4d\u7f6e\u52a0\u5165 IL \u4ee3\u7801\u5b9e\u9645\u4e0a\u4f1a\u52a0\u5230\u8fd9\u4e00\u884c\u4e0a\u9762\u53bb, \u6240\u6709\u6211\u4eec\u5f97\u5148\u8ba9\u5b83\u518d\u5411\u4e0b\u79fb\u52a8\u4e00\u884c, \u7136\u540e\u4f7f\u7528\u6211\u4eec\u7684 IL \u77e5\u8bc6, \u5c06\u5b83\u4e58\u4ee5\u4e2a 2: <pre><code>if (cur.TryGotoNext(ins =&gt; ins.MatchLdcR4(-160f), ins =&gt; ins.MatchStfld&lt;Vector2&gt;(\"Y\")))\n{\n    cur.Index++;\n    cur.Emit(OpCodes.Ldc_R4, 2.0f);\n    cur.Emit(OpCodes.Mul);\n}\n</code></pre></p> <p>Warning</p> <p>\u6ce8\u610f OpCodes \u4f4d\u4e8e <code>Mono.Cecil.Cil</code> \u800c\u4e0d\u662f <code>System.Reflection.Emit</code> \u547d\u540d\u7a7a\u95f4\u4e0b.</p> <p>\u73b0\u5728\u7f16\u8bd1\u8fd0\u884c, \u4f60\u5e94\u8be5\u80fd\u89c2\u5bdf\u5230\u8e6d\u5899\u8df3\u7684\u7ad6\u76f4\u901f\u5ea6\u53d8\u7684\u5f88\u5927!  </p> <p>\u6ce8\u610f\u7684\u662f, IL \u94a9\u5b50\u5f88\u5f3a\u5927, \u4f46\u4f7f\u7528\u5b83\u7684\u98ce\u9669\u4e5f\u5f88\u5927, \u7a0d\u6709\u4e0d\u614e\u5c31\u4f1a\u4f7f\u6574\u4e2a\u6e38\u620f\u76f4\u63a5\u5d29\u6e83. \u4f8b\u5982, \u5728\u4e0a\u9762\u7684\u4ee3\u7801\u4e2d, \u5982\u679c\u4f60\u5fd8\u8bb0\u4e86\u5411\u4e0b\u79fb\u52a8\u4e00\u884c, \u6211\u4eec\u5e0c\u671b\u63d2\u5165\u7684 IL \u4ee3\u7801\u5c31\u4f1a\u9519\u8bef\u5730\u88ab\u63d2\u5165\u81f3 ldc.r4 \u7684\u4e0a\u4e00\u884c, \u901a\u5e38\u8fd9\u4f1a\u5bfc\u81f4\u975e\u6cd5\u7684 IL \u4ee5\u5bfc\u81f4 JIT \u7f16\u8bd1\u5f02\u5e38, \u6216\u8005\u5176\u4ed6\u4e0d\u53ef\u9884\u77e5\u7684\u884c\u4e3a, \u4e0d\u8fc7\u5728\u8fd9\u91cc\u5b83\u4f1a\u5bfc\u81f4\u4e00\u4e2a\u66f4\u52a0\u4e25\u91cd\u7684\u95ee\u9898, \u5b83\u4f1a\u76f4\u63a5\u5d29\u6e83\u6389\u4f60\u7684\u6e38\u620f\u5e76\u4e14\u4e0d\u52a0\u4efb\u4f55 log.txt \u7684\u8f93\u51fa\u548c error_log.txt \u7684\u5f39\u51fa! \u4f60\u53ef\u4ee5\u81ea\u5df1\u5c1d\u8bd5\u4e00\u4e0b\u6765\u611f\u53d7\u5982\u679c IL \u94a9\u5b50\u4f7f\u7528\u5931\u8bef\u7684\u60c5\u51b5.  </p> <p>\u901a\u5e38\u66f4\u5e38\u89c1\u5730, \u6211\u4eec\u5e0c\u671b\u8fd9\u4e2a\u7cfb\u6570\u662f\u53ef\u4ee5\u968f\u65f6\u4fee\u6539\u7684, \u76f8\u4fe1\u4f60\u5f88\u5feb\u5c31\u80fd\u60f3\u5230\u6bd4\u5982\u50a8\u5b58\u5230\u5b57\u6bb5\u91cc, \u7136\u540e\u63d2\u5165\u4e00\u4e9b\u590d\u6742\u7684\u5b57\u6bb5\u8bfb\u53d6\u4ee3\u7801\u6216\u8005\u590d\u6742\u7684\u65b9\u6cd5\u8c03\u7528\u4ee3\u7801, \u4e0d\u8fc7 MonoMod \u4e3a\u6211\u4eec\u63d0\u4f9b\u4e86\u4e00\u4e2a\u66f4\u7b80\u5355\u7684\u65b9\u6cd5: <code>EmitDelegate</code>, \u5b83\u80fd\u4e00\u952e\u751f\u6210\u8fd9\u4e9b\u590d\u6742\u7684\u65b9\u6cd5\u83b7\u53d6\u548c\u8c03\u7528.  </p> <p>\u4f8b\u5982\u4f60\u6709\u4e00\u4e2a\u9759\u6001\u65b9\u6cd5 <code>GetFactorOfWallJumpYSpeed</code>, \u5b83\u4f1a\u6839\u636e\u4e00\u4e9b\u60c5\u51b5\u8fd4\u56de\u4e0d\u540c\u7684\u503c, \u4f8b\u5982\u5728\u8fd9\u91cc\u68c0\u6d4b\u6309\u8df3\u65f6\u662f\u5426\u540c\u65f6\u6309\u4e0b\u6293\u952e, \u662f\u5219\u7ffb\u500d\u7ad6\u76f4\u901f\u5ea6, \u5426\u5219\u4e0d\u53d8:</p> <pre><code>public static float GetFactorOfWallJumpYSpeed()\n{\n    if (Input.Grab.Pressed)\n        return 2.0f;\n    else\n        return 1.0f;\n}\n</code></pre> <p>\u4e0a\u9762\u5bf9\u5e94\u7684\u4ee3\u7801:</p> <pre><code>if (cur.TryGotoNext(ins =&gt; ins.MatchLdcR4(-160f), ins =&gt; ins.MatchStfld&lt;Vector2&gt;(\"Y\")))\n{\n    cur.Index++;\n    // as easy as pi!\n    cur.EmitDelegate(GetFactorOfWallJumpYSpeed);\n    cur.Emit(OpCodes.Mul);\n}\n</code></pre>"},{"location":"trans/adv_hooks/#il_3","title":"\u79fb\u9664 IL","text":"<p>\u901a\u5e38\u9664\u4e86\u63d2\u5165, \u6211\u4eec\u8fd8\u9700\u8981\u79fb\u9664 IL, \u5bf9\u4e8e\u4fee\u6539 IL \u7684\u60c5\u51b5\u6211\u4eec\u53ea\u9700\u8981\u5148\u79fb\u9664\u518d\u63d2\u5165\u5373\u53ef. \u8981\u79fb\u9664\u4e00\u884c IL, \u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 <code>Remove</code> \u65b9\u6cd5, <code>Remove</code> \u65b9\u6cd5\u4f1a\u79fb\u9664\u6307\u9488\u6240\u6307\u7684 IL \u884c, \u4f8b\u5982\u6211\u4eec\u4f9d\u7136\u4fee\u6539\u73a9\u5bb6\u7684\u8e6d\u5899\u8df3\u7ad6\u76f4\u901f\u5ea6, \u4f46\u662f\u5728\u8fd9\u91cc\u6211\u4eec\u76f4\u63a5\u8986\u76d6\u6211\u4eec\u7684\u65b0\u503c:</p> <pre><code>if (cur.TryGotoNext(ins =&gt; ins.MatchLdcR4(-160f), ins =&gt; ins.MatchStfld&lt;Vector2&gt;(\"Y\")))\n{\n    // \u6ce8\u610f\u6ca1\u6709cur.Index++;\u4e86, \u8bb0\u4f4f Emit \u65f6\u65b0\u4ee3\u7801\u88ab\u6dfb\u52a0\u5230\u4e0a\u4e00\u884c, \u800c Remove \u65f6\u5219\u79fb\u9664\u5f53\u524d\u884c\n    cur.Remove();\n    // \u5f53\u524d\u4e00\u884c\u7684 IL \u5df2\u7ecf\u88ab\u79fb\u9664\u4e86, \u73b0\u5728\u6307\u9488\u5b9e\u9645\u4e0a\u6307\u5411\u4e4b\u524d\u7684\u4e0b\u4e00\u884c, \u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u76f4\u63a5 Emit\n    cur.Emit(OpCodes.Ldc_R4, -300.0f);\n}\n</code></pre> <p>Note</p> <p>\u5728\u63d2\u5165 IL, \u4fee\u6539 IL, \u66f4\u6539 IL \u6307\u9488\u6307\u5411\u65f6\u52a1\u5fc5\u6e05\u695a\u63d2\u5165\u4f4d\u7f6e, \u5220\u9664\u76ee\u6807, \u4ee5\u53ca\u64cd\u4f5c\u5b8c\u6210\u540e\u7684\u6307\u9488\u6307\u5411.</p>"},{"location":"trans/adv_hooks/#_1","title":"\u4efb\u610f\u94a9\u53d6","text":"<p>\u76f8\u4fe1\u4f60\u5df2\u7ecf\u53d1\u73b0\u4e86, \u6709\u4e9b\u65b9\u6cd5\u6bd4\u5982\u53eb\u505a <code>orig_xxx</code> \u7684\u65b9\u6cd5, \u4ee5\u53ca\u5c5e\u6027\u7684 getter \u548c setter \u4f60\u90fd\u65e0\u6cd5\u5728 On. \u548c IL. \u8fd9\u4e24\u4e2a\u547d\u540d\u7a7a\u95f4\u4e2d\u627e\u5230, \u540c\u65f6, \u94a9\u53d6\u522b\u7684 helper \u7684\u65b9\u6cd5\u4f3c\u4e4e\u4e5f\u65e0\u6cd5\u5b8c\u6210.  </p> <p>\u8fd9\u91cc\u6211\u4eec\u5f15\u5165\u4e24\u4e2a\u65b0\u7c7b: <code>Hook</code> \u4e0e <code>ILHook</code>, \u524d\u8005\u8868\u793a\u4e00\u4e2a On \u94a9\u5b50, \u540e\u8005\u8868\u793a\u4e00\u4e2a IL \u94a9\u5b50.</p> <p>Info</p> <p><code>Hook</code> \u4e0e <code>ILHook</code> \u4f4d\u4e8e <code>MonoMod.RuntimeDetour</code> \u7a0b\u5e8f\u96c6\u4e2d, \u5728\u65e7\u6a21\u677f\u91cc\u5b83\u6ca1\u6709\u88ab\u9ed8\u8ba4\u5f15\u7528\u8fdb\u6765, \u8fd9\u662f\u4e00\u4e2a\u6211\u4e2a\u4eba\u7684\u5931\u8bef, \u5982\u679c\u4f60\u786e\u5b9e\u65e0\u6cd5\u5f15\u7528\u8fd9\u4e24\u4e2a\u7c7b\u7684\u8bdd\u4f60\u53ef\u4ee5\u5728 <code>CelesteMod.props</code> \u91cc\u7684\u6700\u5e95\u4e0b\u7684\u90a3\u4e2a <code>ItemGroup</code> \u4e2d\u52a0\u5165\u8fd9\u4e00\u6761: <pre><code>&lt;Reference Include=\"MonoMod.RuntimeDetour\"&gt;\n    &lt;HintPath&gt;$(CelesteAssemblyPath)/MonoMod.RuntimeDetour.dll&lt;/HintPath&gt;\n    &lt;Private&gt;False&lt;/Private&gt;\n&lt;/Reference&gt;\n</code></pre></p> <p><code>Hook</code> \u7684\u6784\u9020\u51fd\u6570\u62e5\u6709\u975e\u5e38\u591a\u91cd\u8f7d, \u5728\u8fd9\u91cc\u6211\u4eec\u53ea\u9700\u8981\u90a3\u4e2a <code>(MethodBase method, Delegate to)</code> \u7684\u91cd\u8f7d, \u5b83\u8868\u793a\u6211\u4eec\u5e0c\u671b\u94a9\u53d6\u7b2c\u4e00\u4e2a\u53c2\u6570\u6307\u5b9a\u7684\u65b9\u6cd5, \u94a9\u5b50\u65b9\u6cd5\u662f\u7b2c\u4e8c\u4e2a\u53c2\u6570\u6307\u5b9a\u7684\u59d4\u6258.  </p> <p>\u4f8b\u5982, \u6211\u4eec\u5e0c\u671b\u94a9\u53d6 <code>Player.Inventory</code> \u8fd9\u4e2a\u5c5e\u6027\u7684 <code>get</code> \u65b9\u6cd5, \u4f7f\u5176\u603b\u662f\u8fd4\u56de <code>PlayerInventory.TheSummit</code>, \u4e5f\u5c31\u662f\u603b\u662f\u5177\u6709\u80cc\u5305, \u53cc\u51b2\u7b49:</p> <pre><code>// \u50a8\u5b58\u6211\u4eec\u7684 hook, \u4ee5\u4fbf\u6211\u4eec\u5728 Unload \u4e2d\u91ca\u653e\u5b83\nprivate Hook playerInventory_get_hook;\n\npublic override void Load()\n{\n    // \u5148\u4f7f\u7528\u53cd\u5c04\u627e\u5230 Player.Inventory \u5c5e\u6027\u7684 getter\n    var playerInventory_get = typeof(Player).GetProperty(\"Inventory\").GetGetMethod();\n    // \u4f7f\u7528\u5176\u521b\u5efa\u4e00\u4e2a On \u94a9\u5b50\n    playerInventory_get_hook = new(playerInventory_get, PlayerInventoryHook);\n}\n\n// \u6211\u4eec\u9700\u8981\u624b\u52a8\u58f0\u660e orig \u65b9\u6cd5\u7684\u59d4\u6258, \u56e0\u4e3a\u8fd9\u91cc\u4e0d\u518d\u662f\u65b9\u4fbf\u7684\u4e8b\u4ef6\u8ba2\u9605\u4e86\npublic delegate PlayerInventory PlayerInventory_get_orig(Player self);\npublic static PlayerInventory PlayerInventoryHook(PlayerInventory_get_orig orig, Player self)\n{\n    // \u76f4\u63a5\u5ffd\u7565 orig \u65b9\u6cd5\u7684\u8c03\u7528, \u5f3a\u5236\u8fd4\u56de 7a/b/c \u7684 Inventory\n    return PlayerInventory.TheSummit;\n}\n\npublic override void Unload()\n{\n    // \u8bb0\u5f97\u9500\u6bc1\u94a9\u5b50\n    playerInventory_get_hook.Dispose();\n}\n</code></pre> <p>\u56e0\u4e3a\u4e0d\u518d\u662f\u4e4b\u524d\u65b9\u4fbf\u7684\u4e8b\u4ef6\u8ba2\u9605, \u6240\u4ee5\u94a9\u5b50\u7684 orig \u53c2\u6570\u7684\u59d4\u6258\u539f\u578b\u4f60\u5fc5\u987b\u5f97\u81ea\u5df1\u58f0\u660e, \u6ce8\u610f\u94a9\u5b50\u65b9\u6cd5\u548c\u94a9\u5b50 orig \u53c2\u6570\u7684\u53c2\u6570\u5217\u8868\u4e00\u5b9a\u8981\u5c0f\u5fc3\u51c6\u786e\u7684\u586b\u5199, \u5426\u5219\u4f1a\u76f4\u63a5\u9020\u6210\u6e38\u620f\u5d29\u6e83. \u4e0a\u8ff0\u4ee3\u7801\u7684\u6548\u679c\u5e94\u8be5\u662f\u4f60\u65e0\u8bba\u5982\u4f55\u90fd\u4f1a\u62e5\u6709 7a/b/c \u7684 Inventory, \u4e5f\u5927\u6982\u5373\u53cc\u51b2, \u5e26\u80cc\u5305.  </p> <p>\u73b0\u5728, \u62e5\u6709\u4e86\u94a9\u5b50\u51fd\u6570, \u4f60\u53ef\u4ee5\u505a\u4efb\u4f55\u4f60\u4e4b\u524d\u4f7f\u7528\u8ba2\u9605\u4e8b\u4ef6\u6765\u521b\u5efa\u94a9\u5b50\u4e00\u6837\u7684\u4e8b. \u987a\u4fbf, \u4f7f\u7528\u8fd9\u79cd\u65b9\u6cd5\u4e5f\u5141\u8bb8\u4f60\u94a9\u53d6\u522b\u7684 helper \u7684\u65b9\u6cd5, \u751a\u81f3\u662f\u94a9\u53d6\u522b\u7684 helper \u7684\u94a9\u5b50\u65b9\u6cd5. \u4e0d\u8fc7\u5728\u6b64\u4e4b\u524d\u4f60\u9700\u8981\u4e3a\u4f60\u7684 mod \u58f0\u660e\u4f9d\u8d56\u6216\u8005\u53ef\u9009\u4f9d\u8d56, \u58f0\u660e\u53ef\u9009\u4f9d\u8d56\u540e\u53c8\u9700\u8981\u68c0\u6d4b\u5bf9\u5e94 mod \u662f\u5426\u52a0\u8f7d\u7b49\u7b49, \u8fd9\u90e8\u5206\u5185\u5bb9\u6211\u4eec\u4e4b\u540e\u518d\u8bf4.  </p> <p>\u540c\u6837\u5730, IL \u94a9\u5b50\u7684\u521b\u5efa\u4e5f\u4e0e On \u94a9\u5b50\u76f8\u540c:</p> <pre><code>private ILHook playerInventory_get_ilhook;\n\npublic override void Load()\n{\n    var playerInventory_get = typeof(Player).GetProperty(\"Inventory\").GetGetMethod();\n    playerInventory_get_ilhook = new(playerInventory_get, PlayerInventoryILHook);\n}\n\npublic static void PlayerInventoryILHook(ILContext context)\n{\n    // \u50cf\u4e4b\u524d\u4e00\u6837\u505a\u4f60\u5728 IL \u94a9\u5b50\u4e2d\u505a\u7684\u4e8b...\n}\n\npublic override void Unload()\n{\n    playerInventory_get_ilhook.Dispose();\n}\n</code></pre> <p>\u4e0d\u8fc7\u4e0d\u518d\u9700\u8981\u624b\u52a8\u58f0\u660e orig \u59d4\u6258, \u56e0\u4e3a IL \u94a9\u5b50\u7684\u94a9\u5b50\u65b9\u6cd5\u53c2\u6570\u5217\u8868\u662f\u56fa\u5b9a\u7684.</p> <p>Note</p> <p>\u5173\u4e8e\u534f\u7a0b\u51fd\u6570\u7684\u94a9\u53d6\u4e0e\u4e0a\u8ff0\u6b65\u9aa4\u622a\u7136\u4e0d\u540c, \u8fd9\u4e00\u70b9\u6211\u4eec\u4f1a\u5728\u4e0b\u4e00\u8282\u63a2\u8ba8.</p>"},{"location":"trans/common1/","title":"Alarm, Tween, Coroutine","text":""},{"location":"trans/common1/#tween","title":"Tween","text":"<p>Tween \u662f\u4e00\u4e2a\u5728 Monocle \u4e2d\u7528\u6765\u5b9e\u73b0\u7f13\u52a8\u7684 <code>Component</code>, \u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u8fdb\u884c\u6240\u6709 easings.net \u4e0a\u7684\u7f13\u52a8, \u5b83\u7684\u4f7f\u7528\u65b9\u6cd5\u5f88\u7b80\u5355: \u4f7f\u7528 Tween<pre><code>// \u9996\u5148\u4f7f\u7528\u9759\u6001\u65b9\u6cd5 Tween.Create \u6765\u521b\u5efa\nTween tw = Tween.Create(Tween.TweenMode.Oneshot, Ease.BackIn, 1f, false);\n</code></pre></p> <p>\u8fd9\u91cc\u53c2\u6570\u53ef\u80fd\u76f8\u5bf9\u8f83\u591a:</p> <ul> <li>\u7b2c\u4e00\u4e2a\u53c2\u6570 <code>mode</code>: \u5b83\u8868\u793a\u7f13\u52a8\u7684\u7c7b\u578b, \u53ef\u7528\u7684\u6709:<ul> <li><code>Persist</code>: \u7f13\u52a8\u7ed3\u675f\u540e\u8be5\u7ec4\u4ef6\u4f1a\u5931\u6d3b, \u76f4\u5230\u518d\u6b21\u88ab\u8c03\u7528 <code>Start</code></li> <li><code>Oneshot</code>: \u7f13\u52a8\u7ed3\u675f\u540e\u8be5\u7ec4\u4ef6\u4f1a\u79fb\u9664\u81ea\u8eab</li> <li><code>Looping</code>: \u7f13\u52a8\u7ed3\u675f\u4e00\u6b21\u540e\u4f1a\u7acb\u523b\u518d\u6b21\u5f00\u59cb\u540c\u4e00\u4e2a\u7f13\u52a8, \u5e76\u5faa\u73af</li> <li><code>YoyoOneshot</code>: \u7f13\u52a8\u7ed3\u675f\u540e\u4f1a\u7acb\u523b\u8fdb\u884c\u4e00\u6b21\u53cd\u5411\u7684\u7f13\u52a8, \u7ed3\u675f\u540e\u79fb\u9664\u81ea\u8eab</li> <li><code>YoyoLooping</code>: \u540c <code>YoyoOneshot</code>, \u4f46\u662f\u4f1a\u5faa\u73af\u800c\u4e0d\u662f\u79fb\u9664\u81ea\u8eab</li> </ul> </li> <li>\u7b2c\u4e8c\u4e2a\u53c2\u6570 <code>easer</code>: \u5b83\u8868\u793a\u8be5\u7f13\u52a8\u7684 <code>Easer</code>, \u901a\u5e38\u6211\u4eec\u4f7f\u7528 <code>Ease</code> \u7c7b\u4e2d\u7684\u5df2\u6709\u9759\u6001\u5b57\u6bb5\u4e2d\u63d0\u4f9b\u7684\u5c31\u884c\u4e86,  \u540c\u6837\u5730\u4f60\u53ef\u4ee5\u5728 easings.net \u611f\u53d7\u5e76\u68c0\u7d22\u4f60\u6240\u9700\u8981\u7684\u7f13\u52a8\u7c7b\u578b.</li> <li>\u7b2c\u4e09\u4e2a\u53c2\u6570 <code>duration</code>: \u8868\u793a\u8be5\u7f13\u52a8\u8fdb\u884c\u7684\u65f6\u95f4(\u5355\u4f4d\u79d2), \u5bf9\u4e8e\u7279\u6b8a\u7684\u7f13\u52a8\u7c7b\u578b\u6765\u8bf4\u5b83\u6307\u4e00\u6b21\u6b63\u5411\u7f13\u52a8\u6216\u8005\u4e00\u6b21\u53cd\u5411\u7f13\u52a8\u6240\u9700\u65f6\u95f4.</li> <li>\u7b2c\u56db\u4e2a\u53c2\u6570 <code>start</code>: \u662f\u5426\u7acb\u5373\u5f00\u59cb\u8fd9\u4e2a <code>Tween</code>, \u5426\u5219\u6211\u4eec\u5f97\u9700\u8981\u624b\u52a8\u8c03\u7528 <code>Start</code> \u65b9\u6cd5</li> </ul> <p>\u5728\u521b\u5efa\u5b8c\u6211\u4eec\u7684 <code>tw</code> \u5b9e\u4f8b\u540e, \u6211\u4eec\u5148\u5236\u70b9\u5c0f\u76ee\u6807:</p> <ul> <li>\u5728\u7f13\u52a8\u5f00\u59cb\u65f6\u8f93\u51fa \"Tween start!\"</li> <li>\u5728\u7f13\u52a8\u8fc7\u7a0b\u65f6\u8f93\u51fa \"Tweening... Eased: &lt;\u6b64\u65f6\u7684\u7f13\u52a8\u503c&gt;, Percent: &lt;\u7f13\u52a8\u5df2\u8fdb\u884c\u7684\u65f6\u95f4\u5360\u6bd4&gt;\"</li> <li>\u5728\u7f13\u52a8\u7ed3\u675f\u540e\u8f93\u51fa \"Tween complete!\"</li> </ul> <p>\u5bf9\u4e8e\u5f00\u59cb\u548c\u7ed3\u675f\u5f88\u7b80\u5355, \u6211\u4eec\u53ea\u9700\u8981\u8d4b\u503c\u4e00\u4e9b\u5b57\u6bb5:</p> \u8d4b\u503c Tween \u7684\u4e00\u4e9b\u5b57\u6bb5<pre><code>tw.OnStart = t =&gt; Logger.Log(LogLevel.Info, \"test\", \"Tween start!\");\ntw.OnComplete = t =&gt; Logger.Log(LogLevel.Info, \"test\", \"Tween complete!\");\n</code></pre> <p>\u5728\u8fd9\u91cc\u6211\u4eec\u4f7f\u7528 lambda \u8868\u8fbe\u5f0f\u4e3a\u5176\u8d4b\u503c, \u5176\u4e2d\u8be5 lambda \u88ab\u4f20\u5165\u7684\u53c2\u6570\u5c31\u662f\u8fd9\u4e2a <code>Tween</code> \u5b9e\u4f8b, \u8fd9\u53ef\u4ee5\u5e2e\u52a9\u6211\u4eec\u907f\u514d lambda \u6355\u83b7\u4ee5\u53ca\u590d\u7528\u6211\u4eec\u7684 <code>Tween</code> \u5904\u7406\u51fd\u6570.</p> <p>\u5bf9\u4e8e\u7f13\u52a8\u8fc7\u7a0b, \u6211\u4eec\u9996\u5148\u4ecb\u7ecd\u4e24\u4e2a\u5c5e\u6027:</p> <ul> <li><code>Eased</code>: \u8868\u793a\u8be5\u7f13\u52a8\u5f53\u524d\u7684 \"\u7f13\u52a8\u503c\"</li> <li><code>Percent</code>: \u8868\u793a\u8be5\u7f13\u52a8\u5df2\u8fdb\u884c\u65f6\u95f4\u5360\u6bd4, \u5373 \u5df2\u8fdb\u884c\u65f6\u95f4/\u603b\u65f6\u95f4</li> </ul> <p>\u4e00\u4e2a\u66f4\u6e05\u695a\u7684\u4f8b\u5b50\u662f\u89c2\u5bdf easings.net \u7684\u56fe\u50cf, <code>Eased</code> \u5373\u7eb5\u5750\u6807\u503c, <code>Percent</code> \u5373\u6a2a\u5750\u6807\u503c.</p> <p>\u90a3\u4e48\u8fd9\u91cc\u5c31\u5f88\u7b80\u5355\u5b9e\u73b0\u4e86: <pre><code>tw.OnUpdate = t =&gt; Logger.Log(LogLevel.Info, \"test\", $\"Tweening... Eased: {t.Eased}, Percent: {t.Percent}\");\n</code></pre></p> <p>\u6700\u540e\u8bb0\u5f97 <code>Start</code> \u5b83\u5e76\u4e14\u8bb0\u5f97\u628a\u5b83\u6302\u8f7d\u5230\u5b9e\u4f53\u4e0a, \u56e0\u4e3a\u5b83\u7684\u66f4\u65b0\u662f\u4f9d\u8d56\u5b9e\u4f53\u7684:</p> \u5f00\u59cb\u5e76\u6302\u8f7d<pre><code>// \u5982\u679c\u4f60\u5bf9 `start` \u53c2\u6570\u4f20\u5165 `true` \u90a3\u4e48\u4f60\u53ef\u4ee5\u4e0d\u7528\u505a\u8fd9\u4e00\u6b65\ntw.Start();\n// \u8fd9\u91cc\u5047\u8bbe\u6211\u4eec\u7684\u6240\u6709\u4ee3\u7801\u90fd\u8fdb\u884c\u5728\u4e00\u4e2a\u5b9e\u4f53\u5185\u90e8\nthis.Add(tw);\n</code></pre> <p>\u6216\u8005, \u6211\u4eec\u4f7f\u7528 <code>Tween.Set</code> \u65b9\u6cd5, \u5b83\u662f\u4e00\u4e2a\u5de5\u5177\u65b9\u6cd5\u5141\u8bb8\u6211\u4eec\u7b80\u5316\u5bf9 Tween \u7684\u4f7f\u7528, \u4e0a\u9762\u7684\u4f8b\u5b50\u7528\u8fd9\u4e2a\u65b9\u6cd5\u53ef\u4ee5\u5199\u6210\u8fd9\u6837: <pre><code>Tween tw = Tween.Set(this, Tween.TweenMode.Oneshot, 1f, Ease.BackIn,\n    t =&gt; Logger.Log(LogLevel.Info, \"test\", $\"Tweening... Eased: {t.Eased}, Percent: {t.Percent}\"),\n    t =&gt; Logger.Log(LogLevel.Info, \"test\", \"Tween complete!\"));\n// OnStart \u8fd8\u5f97\u624b\u52a8\u8bbe\u7f6e\u5450\ntw.OnStart = t =&gt; Logger.Log(LogLevel.Info, \"test\", \"Tween start!\");\ntw.Start();\n</code></pre></p> <p>\u5b83\u4f1a\u81ea\u52a8\u5e2e\u6211\u4eec\u6302\u8f7d\u5230\u5b9e\u4f53\u4e0a, \u4e0d\u8fc7\u4f9d\u7136\u9700\u8981\u6211\u4eec\u624b\u52a8 <code>Start</code>, \u8fd9\u91cc\u65b9\u4fbf\u4e4b\u5904\u5c31\u5728\u4e8e\u4f60\u53ef\u4ee5\u76f4\u63a5\u628a\u4e00\u4e2a\u7b80\u5355\u7684\u51fd\u6570\u76f4\u63a5\u5728\u53c2\u6570\u4e2d\u4f20\u5165, \u800c\u4e0d\u662f <code>Create</code> \u540e\u518d\u8bbe\u7f6e\u5b57\u6bb5. \u4e0d\u8fc7\u8fd9\u91cc\u53c2\u6570\u5217\u8868\u4e2d\u5e76\u6ca1\u6709 <code>Start</code> \u76f8\u5173\u7684\u53c2\u6570, \u5982\u679c\u4f60\u8fd8\u9700\u8981\u8bbe\u7f6e <code>Start</code> \u7684\u56de\u8c03\u7684\u8bdd\u4f60\u53ef\u4ee5\u56de\u9000\u5230\u4e0a\u9762\u7684\u4f8b\u5b50\u4e2d\u7684\u65b9\u6cd5, \u5c31\u50cf\u4e0a\u9762\u7684\u4ee3\u7801\u4e00\u6837\u624b\u52a8\u8bbe\u7f6e <code>OnStart</code>.</p>"},{"location":"trans/common1/#alarm","title":"Alarm","text":"<p>\u987e\u540d\u601d\u4e49, \u5b83\u5c31\u662f\u4e2a'\u95f9\u949f', \u5b83\u5141\u8bb8\u4f60\u8bbe\u5b9a\u4e00\u4e2a\u65f6\u95f4\u5e76\u5728\u65f6\u95f4\u7ed3\u675f\u540e\u505a\u4e00\u4e9b\u4e8b\u60c5, \u5176\u4f7f\u7528\u8d77\u6765\u5f88\u7b80\u5355: <pre><code>Alarm alarm = Alarm.Create(Alarm.AlarmMode.Oneshot, OnAlarm, 2f, false);\nAdd(alarm);\nalarm.Start();\n\nstatic void OnAlarm()\n{\n    Logger.Log(LogLevel.Info, \"Test\", \"123\");\n}\n</code></pre></p> <ul> <li>\u7b2c\u4e00\u4e2a\u53c2\u6570 <code>AlarmMode</code> \u4e0e <code>Tween.TweenMode</code> \u7684\u57fa\u672c\u4e00\u81f4, \u8fd9\u91cc\u5c31\u4e0d\u8d58\u8ff0\u4e86</li> <li>\u7b2c\u4e8c\u4e2a\u53c2\u6570\u8868\u793a\u65f6\u95f4\u5230\u540e\u7684\u56de\u8c03\u51fd\u6570</li> <li>\u7b2c\u4e09\u4e2a\u53c2\u6570\u8868\u793a\u65f6\u95f4\u6709\u591a\u957f</li> <li>\u7b2c\u56db\u4e2a\u53c2\u6570\u4e5f\u4e0e tween \u7c7b\u4f3c, \u8868\u793a\u662f\u5426\u5e0c\u671b\u81ea\u52a8\u8c03\u7528 <code>Start</code> \u65b9\u6cd5</li> </ul> <p>\u9664\u4e86\u5728\u7b2c\u4e09\u4e2a\u53c2\u6570\u5904\u8bbe\u7f6e\u65f6\u95f4\u957f\u5ea6\u5916, <code>Start</code> \u65b9\u6cd5\u4e5f\u5141\u8bb8\u6211\u4eec\u4f20\u5165\u4e00\u4e2a\u65f6\u95f4\u957f\u5ea6, \u8fd9\u4f1a\u5728\u4f60\u9700\u8981\u4e00\u4e2a\u4e0d\u5b9a\u957f\u7684\u95f9\u949f\u7684\u65f6\u5019\u5f88\u6709\u7528. \u9664\u6b64\u4e4b\u5916, <code>Alarm</code> \u4e5f\u6709\u7c7b\u4f3c\u4e8e <code>Tween.Set</code> \u7684\u65b9\u6cd5\u76f4\u63a5\u4f5c\u7528\u4e0e <code>Entity</code> \u4e0a, \u53c2\u6570\u4e5f\u4e0e\u5176\u6784\u9020\u51fd\u6570\u76f8\u540c: <pre><code>// \u4e0d\u8fc7\u8fd9\u91cc AlarmMode \u53cd\u800c\u88ab matt \u653e\u5230\u6700\u540e\u53bb\u4e86\nAlarm.Set(this, 2f, OnAlarm, Alarm.AlarmMode.Oneshot).Start();\n</code></pre></p>"},{"location":"trans/common1/#coroutine","title":"Coroutine","text":"<p><code>Coroutine</code> \u5e38\u89c1\u7684\u4e2d\u6587\u7ffb\u8bd1\u53eb\u505a '\u534f\u7a0b', \u5b83\u662f\u4e00\u4e2a\u975e\u5e38\u5f3a\u5927\u7684\u4e1c\u897f, async/await \u5f02\u6b65\u5141\u8bb8\u6211\u4eec\u50cf\u5199\u540c\u6b65\u4ee3\u7801\u4e00\u6837\u5199\u5f02\u6b65\u4ee3\u7801, \u5927\u6982\u7c7b\u4f3c\u5730, \u534f\u7a0b\u5c31\u5141\u8bb8\u6211\u4eec\u50cf\u5199\u4e00\u4e2a\u5728\u540c\u4e00\u5e27\u5185\u5141\u8bb8\u7684\u4ee3\u7801\u4e00\u6837\u5199\u5728\u4e0d\u540c\u5e27\u5185\u8fd0\u884c\u7684\u4ee3\u7801. \u597d\u5427\u4e0a\u9762\u8fd9\u53e5\u8bdd\u6709\u70b9\u4e71, \u4e0d\u8fc7\u6211\u4eec\u770b\u4e00\u4e0b\u4f8b\u5b50\u5c31\u4f1a\u7406\u89e3\u4e86: <pre><code>var coroutine = new Coroutine(MakeRoutine());\nAdd(coroutine);\n\nstatic IEnumerator MakeRoutine()\n{\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5f00\u59cb!\");\n    yield return 1f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u8fc7\u4e861s!\");\n    yield return 2f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u53c8\u8fc7\u4e862s!\");\n    yield break;\n}\n</code></pre></p> <p>Info</p> <p>\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u7684 <code>yield return</code> \u7b49\u8bed\u6cd5\u5c5e\u4e8e \"\u8fed\u4ee3\u5668\u51fd\u6570\", \u5982\u679c\u4f60\u4e0d\u4e86\u89e3\u5b83\u7684\u8bdd\u4f60\u53ef\u4ee5\u5230 msdn \u4e0a\u6216\u8005 bing \u641c\u7d22 \u4e0a\u67e5\u627e\u5b83.</p> <p>\u4e0a\u8ff0\u4ee3\u7801\u4f1a\u7acb\u523b\u6253\u5370\u4e00\u53e5 \"\u5f00\u59cb!\" \u7136\u540e\u7b49\u5f851s, \u7136\u540e\u6253\u5370 \"\u8fc7\u4e861s!\", \u518d\u8fc7\u4e862s\u540e\u518d\u6b21\u6253\u5370\"\u53c8\u8fc7\u4e862s!\". \u4e5f\u5c31\u662f\u8bf4\u4f60\u6bcf <code>yield return</code> \u4e00\u4e2a\u6d6e\u70b9\u6570, \u6e38\u620f\u4f1a\u7b49\u5f85\u8be5\u79d2\u6570, \u7136\u540e\u7ee7\u7eed\u6267\u884c\u4e0b\u9762\u7684\u4ee3\u7801. \u4f60\u53ef\u80fd\u89c9\u5f97\u8fd9\u4e0d\u5c31\u662f\u4e2a\u9ad8\u7ea7\u70b9\u7684 <code>Alarm</code> \u5417, \u786e\u5b9e, \u4f60\u4ecd\u7136\u53ef\u4ee5\u7528 <code>Alarm</code> \u6765\u91cd\u5199\u8fd9\u90e8\u5206\u529f\u80fd, \u4e0d\u8fc7\u5f88\u5feb\u4f60\u5c31\u4f1a\u9677\u5165\u56de\u8c03\u5730\u72f1\u5e76\u4e14\u4ee3\u7801\u4e5f\u53d8\u7684\u5341\u5206\u96be\u8bfb: <pre><code>Logger.Log(LogLevel.Info, \"tag\", \"\u5f00\u59cb!\");\nAlarm.Set(this, 1f, () =&gt;\n{\n    Logger.Log(LogLevel.Info, \"tag\", \"\u8fc7\u4e861s!\");\n    Alarm.Set(this, 2f, () =&gt;\n    {\n        Logger.Log(LogLevel.Info, \"tag\", \"\u53c8\u8fc7\u4e862s!\");\n\n    }, Alarm.AlarmMode.Oneshot);\n\n}, Alarm.AlarmMode.Oneshot);\n</code></pre></p> <p>\u9664\u4e86\u8fd4\u56de\u4e00\u4e9b\u6d6e\u70b9\u6570, \u6211\u4eec\u8fd8\u53ef\u4ee5\u8fd4\u56de\u4e00\u4e2a <code>null</code>, \u8fd9\u6837\u4f1a\u8ba9\u6e38\u620f\u4ec5\u7b49\u5f85\u4e00\u5e27, \u4e5f\u5c31\u662f\u5728\u8fd9\u6b21\u8fd4\u56de\u540e, \u6e38\u620f\u5728\u4e0b\u4e00\u5e27\u7acb\u523b\u7ee7\u7eed\u6267\u884c\u800c\u4e0d\u662f\u7b49\u5f85\u79d2\u6570. \u6bd4\u5982\u5728\u5b98\u56fe\u4e2d <code>FallingBlock</code> \u5bf9\u5176\u7684\u4e00\u4e2a\u5e94\u7528(\u5df2\u7b80\u5316, \u5220\u9664\u4e86 BadelineBoss \u76f8\u5173\u7684\u4ee3\u7801): Celeste.FallingBlock.Sequence()<pre><code>// \u6301\u7eed\u68c0\u6d4b\u662f\u5426\u73a9\u5bb6\u5728\u4e0a\u9762\u6293/\u7ad9\u7740\nwhile (!PlayerFallCheck())\n    yield return null;\n// \u73a9\u5bb6\u6293/\u7ad9\u7740, \u8fdb\u5165\u6389\u843d\u72b6\u6001\nHasStartedFalling = true;\nwhile (true)\n{\n    // \u5728\u771f\u6b63\u8fdb\u884c\u5411\u4e0b\u79fb\u52a8\u65f6\u5148\u7b49\u5f85 0.2s \n    yield return 0.2f;\n\n    // \u7136\u540e\u7b49\u5f85 0.4s, \u4f46\u662f\u73a9\u5bb6\u79bb\u5f00\u6389\u843d\u5757\u540e\u4f1a\u53d6\u6d88\u8fd9\u4e2a\u7b49\u5f85\n    float waitTimer = 0.4f;\n    while (waitTimer &gt; 0f &amp;&amp; PlayerWaitCheck())\n    {\n        yield return null;\n        waitTimer -= Engine.DeltaTime;\n    }\n\n    // ......, \u6267\u884c\u6301\u7eed\u6389\u843d\u7684\u903b\u8f91, \u76f4\u5230\u78b0\u5230\u4e86\u5e73\u53f0(\u6cdb\u6307\u6240\u6709\u4e0a\u9762\u80fd\u7ad9\u7684\u4e1c\u897f, \u975e\u6307\u6728\u5e73\u53f0, \u4e0b\u540c)\u7136\u540e\u505c\u4e0b\n\n    // \u6bcf\u9694 0.1s \u68c0\u6d4b\u662f\u5426\u5e95\u4e0b\u4f9d\u7136\u8fd8\u5b58\u5728\u5e73\u53f0, \u5426\u5219\u8fdb\u5165\u4e0b\u4e00\u6b21 while \u5faa\u73af\n    while (CollideCheck&lt;Platform&gt;(Position + new Vector2(0f, 1f)))\n        yield return 0.1f;\n}\n......\n</code></pre> \u73b0\u5728\u56de\u5fc6\u4e00\u4e0b\u5b98\u56fe\u7684\u6389\u843d\u5757\u7684\u903b\u8f91, \u662f\u4e0d\u662f\u548c\u4e0a\u9762\u4ee3\u7801\u63cf\u8ff0\u7684\u4e00\u81f4? \u5982\u679c\u6ca1\u6709\u4e86\u534f\u7a0b, \u6211\u4eec\u5c31\u5f97\u7528\u4e00\u4e2a\u72b6\u6001\u53d8\u91cf\u6765\u50a8\u5b58\u6389\u843d\u5757\u8fdb\u884c\u5230\u54ea\u4e00\u6b65, \u5e76\u4e14\u65f6\u65f6\u523b\u523b\u7ef4\u62a4\u8fd9\u4e2a\u53d8\u91cf, \u65e5\u76ca\u53d8\u7684\u8d8a\u6765\u8d8a\u9ebb\u70e6.</p> <p>\u534f\u7a0b\u8fd8\u80fd\u8fd4\u56de\u53e6\u4e00\u4e2a\u534f\u7a0b, \u53ea\u9700\u8981\u8fd4\u56de\u4e00\u4e2a <code>IEnumerator</code>: <pre><code>var coroutine = new Coroutine(MakeRoutine());\nAdd(coroutine);\n\nstatic IEnumerator MakeRoutine()\n{\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5f00\u59cb!\");\n    yield return 1f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u8fc7\u4e861s!\");\n    yield return MakeRoutineInner();\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5185\u90e8\u7684\u534f\u7a0b\u7ed3\u675f\u4e86!\");\n    yield return MakeRoutineInner();\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5185\u90e8\u7684\u534f\u7a0b\u53c8\u4e00\u6b21\u7ed3\u675f\u4e86!\");\n    yield break;\n}\n\nstatic IEnumerator MakeRoutineInner()\n{\n    yield return 1f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5185\u90e8\u7b49\u4e861s!\");\n    yield return 1f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5185\u90e8\u53c8\u7b49\u4e861s!\");\n    yield break;\n}\n</code></pre> \u5b83\u7684\u8f93\u51fa\u4f1a\u50cf\u662f: <pre><code>(09/30/2023 13:39:28) [Everest] [Info] [tag] \u5f00\u59cb!\n(09/30/2023 13:39:29) [Everest] [Info] [tag] \u8fc7\u4e861s!\n(09/30/2023 13:39:30) [Everest] [Info] [tag] \u5185\u90e8\u7b49\u4e861s!\n(09/30/2023 13:39:31) [Everest] [Info] [tag] \u5185\u90e8\u53c8\u7b49\u4e861s!\n(09/30/2023 13:39:31) [Everest] [Info] [tag] \u5185\u90e8\u7684\u534f\u7a0b\u7ed3\u675f\u4e86!\n(09/30/2023 13:39:32) [Everest] [Info] [tag] \u5185\u90e8\u7b49\u4e861s!\n(09/30/2023 13:39:33) [Everest] [Info] [tag] \u5185\u90e8\u53c8\u7b49\u4e861s!\n(09/30/2023 13:39:33) [Everest] [Info] [tag] \u5185\u90e8\u7684\u534f\u7a0b\u53c8\u4e00\u6b21\u7ed3\u675f\u4e86!\n</code></pre></p> <p>\u4f7f\u7528\u534f\u7a0b, \u6211\u4eec\u53ef\u4ee5\u5f88\u8f7b\u677e\u7684\u5c31\u50cf\u81ea\u7136\u63cf\u8ff0\u4e00\u4e2a\u8fc7\u7a0b\u4e00\u6837 \"\u81ea\u7136\" \u5730\u5199\u5b9e\u73b0\u7684\u4ee3\u7801, \u5b98\u56fe\u4e2d\u5267\u60c5\u7684\u5b9e\u73b0\u5c31\u662f\u4e00\u4e2a\u5f88\u597d\u7684\u4f8b\u5b50(\u6b64\u5904\u4e3a\u5e8f\u7ae0\u9e1f\u6559\u51b2\u523a\u7684\u5267\u60c5, \u5df2\u5927\u91cf\u7b80\u5316): Celeste.CS00_Ending<pre><code>private IEnumerator Cutscene(Level level)\n{\n    // \u6162\u6162\u51cf\u6162\u6e38\u620f\u901f\u5ea6\u76f4\u5230 0.0x, \u5e76\u4e14\u5728\u51cf\u6162\u5230 0.5x \u65f6\u505c\u6b62\u6865\u5d29\u584c\u97f3\u4e50\n    while (Engine.TimeRate &gt; 0f)\n    {\n        yield return null;\n        if (Engine.TimeRate &lt; 0.5f &amp;&amp; bridge != null)\n            bridge.StopCollapseLoop();\n        level.StopShake();\n        Engine.TimeRate -= Engine.RawDeltaTime * 2f;\n    }\n    // \u6b64\u65f6\u6e38\u620f\u901f\u5ea6\u4f1a\u88ab\u8bef\u51cf\u5230\u8d1f\u6570, \u8bbe\u7f6e\u56de 0 \u9632\u6b62\u6e38\u620f\u884c\u4e3a\u5f02\u5e38\n    Engine.TimeRate = 0f;\n    // \u5207\u6362\u73a9\u5bb6\u72b6\u6001\u5230 StDummy, \u5373\u7981\u6b62\u6240\u6709\u8f93\u5165\u548c\u4ea4\u4e92\n    player.StateMachine.State = Player.StDummy;\n    // \u9501\u5b9a\u73a9\u5bb6\u671d\u5411\u4e3a\u53f3\n    player.Facing = Facings.Right;\n    // \u65e0\u89c6\u6e38\u620f\u901f\u5ea6\u5730\u7b49\u5f85 1s, \u9ed8\u8ba4\u8fd4\u56de\u6d6e\u70b9\u6570\u7684\u7b49\u5f85\u4f1a\u53d7\u6e38\u620f\u901f\u5ea6\u5f71\u54cd,\n    // \u8fd9\u91cc\u5982\u679c\u7528\u8fd4\u56de\u6d6e\u70b9\u6570\u7684\u7b49\u5f85\u4f1a\u9020\u6210\u534f\u7a0b\u505c\u6b62, \u56e0\u4e3a\u6e38\u620f\u901f\u5ea6\u4e3a 0x, \u5373\u7b49\u5f85\u6c38\u8fdc\u4e0d\u4f1a\u7ed3\u675f\n    yield return WaitFor(1f);\n    // \u64ad\u653e\u9e1f\u98de\u5165\u7684\u58f0\u97f3\n    Audio.Play(\"event:/game/general/bird_in\", bird.Position);\n    // \u8bbe\u7f6e\u9e1f\u7684\u671d\u5411\u548c\u52a8\u753b\n    bird.Facing = Facings.Left;\n    bird.Sprite.Play(\"fall\", false, false);\n    // \u7f13\u52a8\u9e1f\u7684\u4f4d\u7f6e, \u5e76\u5728\u9e1f\u98de\u5230\u4e00\u534a\u65f6\u64ad\u653e\u98de\u884c\u7684\u52a8\u753b\n    float percent = 0f;\n    Vector2 from = bird.Position;\n    Vector2 to = bird.StartPosition;\n    while (percent &lt; 1f)\n    {\n        bird.Position = from + (to - from) * Ease.QuadOut(percent);\n        if (percent &gt; 0.5f)\n            bird.Sprite.Play(\"fly\", false, false);\n        percent += Engine.RawDeltaTime * 0.5f;\n        yield return null;\n    }\n    bird.Position = to;\n    from = default(Vector2);\n    to = default(Vector2);\n    // \u64ad\u653e\u9e1f\u78b0\u5730\u7684\u97f3\u6548\n    Audio.Play(\"event:/game/general/bird_land_dirt\", bird.Position);\n    // \u5411\u5de6\u91ca\u653e\u5c18\u57c3\u7c92\u5b50\u6548\u679c\n    Dust.Burst(bird.Position, - MathHelper.PI / 2, 12);\n    // \u64ad\u653e\u95f2\u7f6e\u52a8\u753b, \u7136\u540e\u7b49\u5f85 0.5s \u540e\u518d\u6b21\u64ad\u653e\u5544\u5730\u7684\u52a8\u753b\n    bird.Sprite.Play(\"idle\", false, false);\n    yield return WaitFor(0.5f);\n    bird.Sprite.Play(\"peck\", false, false);\n    // \u7b49\u5f85 1.1s, \u4e5f\u5c31\u662f\u5dee\u4e0d\u591a\u5544\u5730\u52a8\u753b\u7684\u957f\u5ea6\n    yield return WaitFor(1.1f);\n    // \u64ad\u653e\u51b2\u523a\u6559\u5b66\n    yield return bird.ShowTutorial(new BirdTutorialGui(\n        bird, new Vector2(0f, -16f), Dialog.Clean(\"tutorial_dash\", null), \n        new Vector2(1f, -1f), \"+\", BirdTutorialGui.ButtonPrompt.Dash\n        ), caw: true);\n\n    // \u6301\u7eed\u7b49\u5f85, \u76f4\u5230\u73a9\u5bb6\u6309\u4e0b\u4e86\u53f3\u4e0a\u51b2\n    for (;;)\n    {\n        Vector2 aimVector = Input.GetAimVector(Facings.Right);\n        if (aimVector.X &gt; 0f &amp;&amp; aimVector.Y &lt; 0f &amp;&amp; Input.Dash.Pressed)\n            break;\n        yield return null;\n    }\n    // \u8bbe\u7f6e\u73a9\u5bb6\u7684\u72b6\u6001\u4e3a \"\u9e1f\u51b2\u523a\u6559\u7a0b\" \u72b6\u6001, \u8fd9\u4e2a\u72b6\u6001\u5373\u51b2\u523a\u5f00\u59cb\u5230\u4e0a\u5cb8\u5e76\u5f3a\u5236\u79fb\u52a8\u5230\u53f3\u4fa7\u7684\u72b6\u6001\n    player.StateMachine.State = Player.StBirdDashTutorial;\n    player.Dashes = 0;\n    level.Session.Inventory.Dashes = 1;\n    // \u6062\u590d\u6e38\u620f\u901f\u7387\n    Engine.TimeRate = 1f;\n    // \u6536\u56de\u9e1f\u7684\u6559\u7a0b\u6846\u6846\n    bird.Add(new Coroutine(bird.HideTutorial()));\n    // \u7b49\u5f85 0.25s\n    yield return 0.25f;\n    // \u64ad\u653e\u9e1f\u88ab\u73a9\u5bb6\u5413\u8d70\u98de\u8d70\u7684\u52a8\u753b (\u6b64\u65f6\u5927\u7ea6\u662f\u73a9\u5bb6\u51b2\u523a\u7ed3\u675f\u7684\u65f6\u95f4)\n    bird.Add(new Coroutine(bird.StartleAndFlyAway()));\n    // \u7b49\u5f85\u76f4\u5230\u73a9\u5bb6\u843d\u5730, \u6216\u8005\u76f4\u5230\u73a9\u5bb6\u5bc4\u4e86\n    while (!player.Dead &amp;&amp; !player.OnGround(1))\n        yield return null;\n    // \u7b49\u5f85 2s\n    yield return 2f;\n    // \u64ad\u653e title_ping \u97f3\u6548, \u5982\u679c\u4f60\u60f3\u4e0d\u8d77\u6765\u7684\u8bdd\u4f60\u53ef\u4ee5\u53bb\u4ed4\u7ec6\u542c\u542c\n    // \u5728\u851a\u84dd\u6e90 fmod \u5de5\u7a0b\u6587\u4ef6\u91cc\u5b83\u7684\u97f3\u9891\u6587\u4ef6\u4f4d\u4e8e music/kuraine/mus_lvl0_titleping_oneshot.ogg\n    Audio.SetMusic(\"event:/music/lvl0/title_ping\");\n    // \u7ee7\u7eed\u7b49\u5f85 2s\n    yield return 2f;\n    // \u5411\u573a\u666f\u4e2d\u52a0\u5165\u663e\u793a \"\u4f60\u80fd\u505a\u5230\u3002\" \u8fd9\u53e5\u8bdd\u7684\u5b9e\u4f53\n    endingText = new PrologueEndingText(false);\n    Scene.Add(endingText);\n\n    // \u83b7\u53d6\u5173\u5361\u4e2d\u63a7\u5236\u524d\u666f\u96ea\u548c\u80cc\u666f\u96ea\u7684\u5b9e\u4f53\n    Snow bgSnow = level.Background.Get&lt;Snow&gt;();\n    Snow fgSnow = level.Foreground.Get&lt;Snow&gt;();\n    // \u987a\u4fbf\u52a0\u5165\u9ad8\u5206\u8fa8\u7387\u7684\u96ea, \u4e5f\u5373 ui \u5c42\u4e0a\u7684\u96ea (HiresSnow = High resolution snow)\n    level.Add(level.HiresSnow = new HiresSnow(0.45f));\n    // \u4f46\u662f\u5148\u628a\u900f\u660e\u5ea6\u8c03\u6210 0, \u7528\u6765\u7b49\u4f1a\u6e10\u53d8\n    level.HiresSnow.Alpha = 0f;\n\n    // \u5f00\u59cb\u6e10\u53d8\u4e09\u5c42\u96ea\u7684\u900f\u660e\u5ea6\n    float ease = 0f;\n    while (ease &lt; 1f)\n    {\n        ease += Engine.DeltaTime * 0.25f;\n        float eased = Ease.CubeInOut(ease);\n        if (fgSnow != null)\n            fgSnow.Alpha -= Engine.DeltaTime * 0.5f;\n        if (bgSnow != null)\n            bgSnow.Alpha -= Engine.DeltaTime * 0.5f;\n        level.HiresSnow.Alpha = Calc.Approach(level.HiresSnow.Alpha, 1f, Engine.DeltaTime * 0.5f);\n        // \u4e8e\u6b64\u540c\u65f6 \"\u4f60\u80fd\u505a\u5230\u3002\" \u8fd9\u53e5\u8bdd\u4e5f\u6162\u6162\u964d\u4e0b\u6765\n        endingText.Position = new Vector2(960f, 540f - 1080f * (1f - eased));\n        // \u6444\u50cf\u673a\u4e5f\u6162\u6162\u5411\u4e0a\u79fb\u52a8\n        level.Camera.Y = level.Bounds.Top - 3900f * eased;\n        yield return null;\n    }\n    // \u7ed3\u675f\u8fd9\u4e2a\u5267\u60c5\n    EndCutscene(level);\n    yield break;\n}\n</code></pre></p>"},{"location":"trans/ec_common/","title":"\u66f4\u591a EC","text":"<p>\u90a3\u4e48\u7ecf\u8fc7\u524d\u9762\u7684\u9605\u8bfb, \u76f8\u4fe1\u4f60\u5df2\u7ecf\u4e86\u89e3\u5230\u4e86\u4e00\u4e9b\u5f88\u5f88\u5f88\u57fa\u672c\u7684\u77e5\u8bc6, \u90a3\u4e48\u4ece\u8fd9\u4e00\u7ae0\u5f00\u59cb\u5c31\u662f\u4e00\u4e9b\u96f6\u788e\u4e14\u6742\u4e71\u7684\u4e1c\u897f\u4e86. \u987a\u4fbf\u6240\u4ee5, \u6211\u8fd8\u662f\u5f88\u5efa\u8bae\u4f60\u53bb\u591a\u9605\u8bfb\u4e00\u4e0b\u539f\u7248\u7684\u4ee3\u7801\u4ee5\u53ca\u4e00\u4e9b\u5e38\u89c1\u7b80\u5355Helper\u7684\u6e90\u7801, \u6bd5\u7adf\u6211\u81ea\u5df1\u90fd\u4e0d\u77e5\u9053\u6211\u9700\u8981\u5728\u8fd9\u91cc\u8bf4\u4e9b\u4ec0\u4e48(</p> <p>_(:\u0437\u300d\u2220)_</p> <p>_(:\u0437\u300d\u2220)_ \u6446\u70c2\u4e86\u8fd9\u8282\u53ef\u80fd\u4f1a\u5f88\u4e0d\u660e\u6240\u4ee5(</p>"},{"location":"trans/ec_common/#_1","title":"\u751f\u547d\u5468\u671f","text":"<p>\u5728\u524d\u9762\u6211\u4eec\u5df2\u7ecf\u4e86\u89e3\u5230\u4e86 <code>Update</code> \u51fd\u6570\u548c <code>Render</code> \u51fd\u6570, <code>Update</code> \u4e0e <code>Render</code> \u6bcf\u5e27\u90fd\u4f1a\u88ab\u8c03\u7528, \u5bf9\u4e8e\u903b\u8f91\u7684\u66f4\u65b0\u6211\u4eec\u5e94\u5728 <code>Update</code> \u4e2d\u505a, \u800c\u6709\u5173\u7ed8\u5236\u7684\u4efb\u52a1\u6211\u4eec\u5e94\u8be5\u5728 <code>Render</code> \u4e2d\u505a, \u8fd9\u662f\u56e0\u4e3a\u5373\u4f7f\u4f60\u5728 <code>Update</code> \u4e2d\u8fdb\u884c\u4e86\u7ed8\u5236\u7684\u8c03\u7528, \u5728 <code>Render</code> \u5f00\u59cb\u4e4b\u524d\u4e5f\u4f1a\u88ab\u851a\u84dd\u6e05\u7a7a. \u7c7b\u4f3c\u5730, \u6e38\u620f\u4e2d\u7684\u6682\u505c\u7684\u5b9e\u73b0\u539f\u7406\u662f\u505c\u6b62\u6bcf\u5e27 <code>Update</code> \u7684\u8c03\u7528\u800c\u4fdd\u7559 <code>Render</code> \u7684\u8c03\u7528, \u90a3\u4e48\u81ea\u7136\u5982\u679c\u4f60\u5728 <code>Render</code> \u91cc\u8fdb\u884c\u903b\u8f91\u66f4\u65b0\u4f60\u4f1a\u7834\u574f\u6389\u6e38\u620f\u539f\u6709\u7684\u6682\u505c.  </p> <p>ok\u90a3\u4e48\u6211\u4eec balabala \u8bf4\u4e86\u4e00\u5927\u5806, \u63a5\u4e0b\u6765\u4ecb\u7ecd\u51e0\u4e2a\u4f1a\u88ab\u851a\u84dd\u8c03\u7528\u7684\u51fd\u6570, \u8fd9\u4e9b\u51fd\u6570\u4e5f\u53eb\u505a<code>\u751f\u547d\u5468\u671f</code>\u51fd\u6570.</p>"},{"location":"trans/ec_common/#entity","title":"\u5bf9\u4e8e Entity","text":"<ul> <li><code>Update</code></li> <li><code>Render</code></li> <li><code>DebugRender</code>: \u8be5\u51fd\u6570\u4f1a\u5728\u851a\u84dd\u8c03\u8bd5\u63a7\u5236\u53f0\u88ab\u6253\u5f00\u65f6\u88ab\u6bcf\u5e27\u88ab\u8c03\u7528\u4f5c\u4e3a debug \u6e32\u67d3, \u5373 everest \u9ed8\u8ba4 ~ \u952e\u6253\u5f00\u7684\u90a3\u4e2a, \u5b83\u7684\u9ed8\u8ba4\u884c\u4e3a\u662f\u7ed8\u5236\u8be5\u5b9e\u4f53\u7684\u78b0\u649e\u7bb1, \u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u505a\u4e00\u4e9b\u8c03\u8bd5\u7528\u7684\u6807\u8bc6\u7684\u7ed8\u5236, \u5c31\u6bd4\u5982\u8bf4\u4f60\u7684\u5b9e\u4f53\u7684\u4f5c\u7528\u8303\u56f4\u4ec0\u4e48\u7684.</li> <li><code>Added</code>: \u5f53\u8be5\u5b9e\u4f53\u88ab\u4ee5 <code>Scene.Add</code> \u51fd\u6570\u8c03\u7528\u52a0\u5165\u5230\u573a\u666f\u4e0a\u65f6\u8c03\u7528, \u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u8bfb\u53d6\u573a\u666f\u7684\u4e00\u4e9b\u72b6\u6001\u6216\u8005 flag \u4e4b\u7c7b\u7684\u5e76\u66f4\u6539\u5b83\u7684\u884c\u4e3a.</li> <li><code>Awake</code>: \u8be5\u51fd\u6570\u4e0e <code>Added</code> \u884c\u4e3a\u76f8\u540c, \u4f46\u662f\u5f53\u4e00\u5e27\u4e4b\u5185\u6709\u591a\u4e2a\u5b9e\u4f53\u88ab\u52a0\u5165\u573a\u666f\u65f6\u5b83\u4eec\u7684 <code>Awake</code> \u4f1a\u5728\u8fd9\u4e9b\u5b9e\u4f53\u90fd\u88ab\u52a0\u5165\u540e\u518d\u6279\u91cf\u8c03\u7528, \u800c <code>Added</code> \u5219\u662f\u52a0\u5165\u4e00\u4e2a\u5c31\u8c03\u7528\u4e00\u4e2a. \u4e00\u4e2a\u5f88\u597d\u7684\u5728\u5b98\u56fe\u4e2d\u8fd0\u7528\u7684\u4f8b\u5b50\u662f\u6d6e\u52a8\u5757\u7684\u8fde\u63a5, \u8fd9\u662f\u5728\u573a\u666f\u5f00\u59cb\u65f6\u505a\u7684, \u4e3a\u4e86\u9632\u6b62\u9057\u6f0f\u67d0\u4e9b\u6d6e\u52a8\u5757\u95f4\u7684\u8fde\u63a5\u5c31\u9700\u8981\u5728\u5b9e\u4f53\u90fd\u88ab\u52a0\u5165\u540e\u518d\u8c03\u7528.</li> <li><code>Removed</code>: \u5f53\u8be5\u5b9e\u4f53\u88ab\u4ee5 <code>Scene.Remove</code> \u51fd\u6570\u8c03\u7528\u79fb\u9664\u573a\u666f\u65f6\u8c03\u7528, \u4f60\u53ef\u4ee5\u5728\u8fd9\u91cc\u53d6\u6d88\u4e00\u4e9b\u5b9e\u4f53\u5bf9\u573a\u666f\u7684\u4e00\u4e9b\u4f5c\u7528, \u6bd4\u5982\u8bf4\u80cc\u666f\u7684\u53d8\u5316.</li> <li><code>SceneBegin</code>: \u5f53\u573a\u666f\u88ab\u8c03\u7528 <code>Scene.Begin</code> \u7684\u540c\u65f6\u8c03\u7528</li> <li><code>SceneEnd</code>: \u5f53\u573a\u666f\u88ab\u8c03\u7528 <code>Scene.End</code> \u7684\u540c\u65f6\u8c03\u7528</li> </ul>"},{"location":"trans/ec_common/#component","title":"\u5bf9\u4e8e Component","text":"<p>\u5bf9\u4e8e Component \u6765\u8bf4\u5927\u90e8\u5206\u51fd\u6570\u4e0e Entity \u7684\u7c7b\u4f3c, \u53ea\u4e0d\u8fc7\u540d\u5b57\u524d\u52a0\u4e2a\u4e86 Entity. \u6bd4\u5982\u5b9e\u4f53\u7684 <code>Awake</code> \u5bf9\u5e94 Component \u7684 <code>EntityAwake</code>, \u901a\u5e38\u8fd9\u4e9b\u51fd\u6570\u88ab\u8c03\u7528\u7684\u5730\u65b9\u662f\u5bf9\u5e94\u7684 Entity \u7684\u751f\u547d\u5468\u671f\u51fd\u6570\u7684\u9ed8\u8ba4\u5b9e\u73b0, \u6240\u4ee5\u9664\u975e\u6709\u610f\u800c\u4e3a\u4e4b\u8bb0\u5f97\u5728\u5f00\u5934\u8c03\u7528\u57fa\u7c7b\u7684\u751f\u547d\u5468\u671f\u5b9e\u73b0: MyInterestingEntity.cs<pre><code>public override void Awake()\n{\n    // ensure `Awake`s of its components has been called\n    base.Awake();\n    // do other thing...\n}\n</code></pre></p>"},{"location":"trans/ec_common/#scene","title":"\u5bf9\u4e8e Scene","text":"<p>\u55ef... \u5bf9\u5e94 Scene \u7684\u4e00\u4e9b\u751f\u547d\u5468\u671f\u51fd\u6570\u6211\u4e2a\u4eba\u4e5f\u4e0d\u662f\u5f88\u4e86\u89e3\u6bd5\u7adf\u6211\u4eec\u5927\u90e8\u5206\u7684\u65f6\u95f4\u90fd\u5728 gameplay \u7684\u573a\u666f\u4e0a, \u6240\u4ee5\u8fd9\u8282\u5c31\u6682\u65f6\u5495\u4e86(\u3002_\u3002)</p>"},{"location":"trans/ec_common/#_2","title":"\u5e38\u89c1\u7684\u65b9\u6cd5\u4e0e\u5c5e\u6027","text":"<ul> <li><code>Scene.Add</code>: \u5c06\u4e00\u4e2a\u5b9e\u4f53\u52a0\u5165\u5230\u573a\u666f\u4e2d</li> <li><code>Entity.Add</code>: \u5c06\u4e00\u4e2a Component \u6302\u8f7d\u5230\u5b9e\u4f53\u4e0a</li> <li><code>Scene.Remove</code>: \u5c06\u4e00\u4e2a\u5b9e\u4f53\u79fb\u51fa\u573a\u666f</li> <li><code>Entity.Remove</code>: \u5c06\u4e00\u4e2a Component \u79fb\u51fa\u5b9e\u4f53</li> <li><code>Entity.RemoveSelf</code>: \u5c06 Entity \u81ea\u8eab\u79fb\u51fa\u81ea\u8eab\u6240\u5728\u573a\u666f</li> <li><code>Component.RemoveSelf</code>: \u5c06 Component \u81ea\u8eab\u79fb\u51fa\u6240\u5728\u5b9e\u4f53</li> <li><code>Scene.Entities</code>: \u83b7\u53d6\u5f53\u524d\u573a\u666f\u4e0a\u7684\u5b9e\u4f53\u5217\u8868</li> <li><code>Entity.Components</code>: \u83b7\u53d6\u5f53\u524d\u5b9e\u4f53\u7684 Component \u5217\u8868</li> </ul>"},{"location":"trans/ec_common/#entity_1","title":"Entity","text":"<p><code>Entity</code> \u672c\u8eab\u6709\u56db\u4e2a\u516c\u5f00\u7684\u5b57\u6bb5:</p> <ul> <li><code>Active</code>, \u8be5 <code>bool</code> \u5b57\u6bb5\u8868\u793a\u8be5 <code>Entity</code> \u662f\u5426 \"\u5b58\u6d3b\", \u5426\u5219\u4e3a \"\u5931\u6d3b\", \"\u5931\u6d3b\" \u7684 <code>Entity</code> \u5c06\u4e0d\u4f1a\u88ab\u8c03\u7528 <code>Update</code> \u65b9\u6cd5\u76f4\u5230 <code>Active</code> \u4e3a <code>true</code></li> <li><code>Collidable</code>, \u8be5 <code>bool</code> \u5b57\u6bb5\u8868\u793a\u8be5 <code>Entity</code> \u662f\u5426 \"\u53ef\u78b0\u649e\", \u4e0d\u53ef\u78b0\u649e\u7684\u5b9e\u4f53\u4e0e\u4efb\u4f55\u5b9e\u4f53\u8fdb\u884c\u78b0\u649e\u68c0\u6d4b\u65f6\u90fd\u4f1a\u8fd4\u56de <code>false</code>, \u6240\u4ee5\u4f60\u53ef\u4ee5\u4f7f\u7528\u8be5\u81ea\u52a8\u7981\u7528\u5b83\u7684\u78b0\u649e\u7bb1</li> <li><code>Visible</code>, \u8be5 <code>bool</code> \u5b57\u6bb5\u8868\u793a\u8be5 <code>Entity</code> \u662f\u5426 \"\u53ef\u89c1\", \u4e0d\u53ef\u89c1\u7684\u5b9e\u4f53\u4e0d\u4f1a\u88ab\u8c03\u7528 <code>Render</code> \u65b9\u6cd5, \u6ce8\u610f\u5373\u4f7f\u4e0d\u53ef\u89c1\u5b83\u7684\u78b0\u649e\u7bb1\u4f9d\u7136\u5b58\u5728.</li> <li><code>Position</code>, \u8be5 <code>Vector2</code> \u5b57\u6bb5\u8868\u793a\u8be5 <code>Entity</code> \u7684\u4f4d\u7f6e, \u6ce8\u610f\u8fd9\u4e2a\u4f4d\u7f6e\u76f8\u5bf9\u7684\u5750\u6807\u7cfb\u662f\u4e0d\u540c\u7684, \u5bf9\u4e8e HUD \u5b9e\u4f53\u6765\u8bf4\u5b83\u7684\u5750\u6807\u7cfb\u662f\u4e00\u4e2a 1922 x 1092 \u7684\u539f\u70b9\u5de6\u4e0a\u89d2\u7684\u5c4f\u5e55\u5750\u6807, \u5bf9\u4e8e gameplay \u5b9e\u4f53\u6765\u8bf4\u5b83\u662f\u76f8\u5bf9\u4e8e\u4e16\u754c\u539f\u70b9\u7684\u5206\u5ea6\u503c\u4e3a 1px \u7684\u5750\u6807. \u8fd9\u4e2a\u884c\u4e3a\u53ef\u4ee5\u901a\u8fc7\u540e\u9762\u6240\u8bf4\u7684 <code>Tag</code> \u6765\u914d\u7f6e.</li> </ul>"},{"location":"trans/ec_common/#tag","title":"Tag","text":"<p>:thinking: \u9664\u6b64\u4e4b\u5916\u5462\u8fd8\u6709\u4e00\u4e2a\u5c0f\u4e1c\u897f\u53eb <code>Tag</code>, \u8bed\u4e49\u4e0a\u6765\u8bf4\u5b83\u8868\u793a\u8fd9\u4e2a\u5b9e\u4f53\u7684\u4e00\u4e9b\u6807\u7b7e\u5c5e\u6027, \u4f60\u53ef\u4ee5\u901a\u8fc7 <code>Entity.Tag</code> \u5c5e\u6027\u6765\u8bbf\u95ee\u5b83, \u5b83\u662f\u4e00\u4e2a 32 \u4f4d\u6574\u6570, \u5b83\u7684\u6bcf\u4e00\u4f4d\u8868\u793a\u4e00\u4e2a\u8be5\u5b9e\u4f53\u7684\"\u5c5e\u6027\", \u6211\u4eec\u901a\u5e38\u4f1a\u4f7f\u7528 <code>AddTag</code> \u4ee5\u53ca <code>RemoveTag</code> \u6765\u64cd\u4f5c\u5b83. \u8981\u83b7\u53d6\u573a\u666f\u4e2d\u6240\u6709\u62e5\u6709\u67d0\u4e00 <code>Tag</code> \u7684\u5b9e\u4f53, \u6211\u4eec\u9700\u8981\u8bbf\u95ee <code>Scene</code> \u7684 <code>TagLists</code> \u800c\u4e0d\u662f <code>Tracker</code>, \u7136\u540e\u4f7f\u7528\u5b83\u7684\u7d22\u5f15\u5668(\u5f62\u5982 <code>tagList[yourtag]</code> \u7684\u8fd0\u7b97\u7b26)\u6765\u68c0\u7d22, \u6216\u8005\u4f60\u4e5f\u53ef\u4ee5\u4f7f\u7528\u7b80\u4fbf\u7684\u65b9\u6cd5---\u76f4\u63a5\u8bbf\u95ee <code>Scene</code> \u7684\u7d22\u5f15\u5668. \u4e00\u822c\u7684\u8bdd, \u6211\u5bf9\u4e8e <code>Tag</code> \u7684\u5e94\u7528\u5f88\u5c11, \u6700\u8fd1\u4e00\u6b21\u662f\u5c06\u4e00\u4e2a <code>Entity</code> \u6807\u8bb0\u4e3a ui \u5c42, \u5b83\u7684\u4ee3\u7801\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684: <pre><code>this.AddTag(Tags.HUD);\n</code></pre> \u5f53\u4f60\u7684\u5b9e\u4f53\u62e5\u6709\u8fd9\u4e2a Tag \u540e, \u851a\u84dd\u4f1a\u5c06\u4f60\u7684\u5b9e\u4f53\u7ed8\u5236\u5728 ui \u5c42, \u6bd4\u8f83\u5e38\u89c1\u7684\u4f8b\u5b50\u5c31\u662f\u5de6\u4e0a\u89d2\u7684\u8ba1\u65f6\u5668, \u5b83\u5728\u6784\u9020\u5668\u5185\u5c31\u7ed9\u81ea\u5df1\u6253\u4e0a\u4e86 <code>Tags.HUD</code> \u7684\u6807\u7b7e. \u4e5f\u5982\u4e0a\u9762\u6240\u8bf4\u7684, \u4e00\u4e9b\u851a\u84dd\u5e38\u89c1\u7684\u6240\u6709 Tag \u4f60\u90fd\u53ef\u4ee5\u5728 <code>Celeste.Tags</code> \u7c7b\u5185\u627e\u5230.</p> <p>\u4ee5\u4e0b\u662f\u4e00\u4e9b\u53ef\u80fd\u5730\u5e38\u89c1\u7684 Tag:</p> <ul> <li><code>PauseUpdate</code>: \u662f\u5426\u5728\u6682\u505c\u671f\u95f4\u4f9d\u7136\u88ab\u8c03\u7528 <code>Update</code>, \u901a\u5e38\u7528\u4e8e ui \u5c42\u7684\u5b9e\u4f53\u4e0a</li> <li><code>FrozenUpdate</code>: \u662f\u5426\u5728 <code>Frozen</code> \u72b6\u6001\u4e0b\u4f9d\u7136\u88ab\u8c03\u7528 <code>Update</code> (\u6bd4\u5982\u8349\u8393\u7c7d\u52a8\u753b\u8fc7\u7a0b, 1a\u84dd\u5fc3\u89e3\u5bc6\u6210\u529f\u8fc7\u7a0b, \u6ce8\u610f\u6b64\u72b6\u6001\u4e0e\u51bb\u7ed3\u5e27\u65e0\u5173)</li> <li><code>TransitionUpdate</code>: \u662f\u5426\u5728\u5173\u5361\u5207\u677f\u65f6\u4f9d\u7136\u88ab\u8c03\u7528 <code>Update</code>, \u901a\u5e38\u7528\u4e8e\u5728\u5207\u677f\u65f6\u66f4\u65b0\u4e00\u4e9b\u89c6\u89c9\u4e0a\u7684\u4e1c\u897f(\u6bd4\u5982\u7535\u7f51\u7684 \"\u653e\u7535\" \u52a8\u753b\u4e0d\u4f1a\u5728\u5207\u677f\u65f6\u9759\u6b62)</li> <li><code>HUD</code>: \u5373\u662f\u5426\u662f ui \u5c42, \u6b64\u9879\u5c31\u4f1a\u66f4\u6539 <code>Entity</code> \u7684 <code>Position</code> \u7684\u76f8\u5bf9\u5750\u6807\u7cfb</li> <li><code>Global</code>: \u8be5 Entity \u662f\u5426\u662f\u5168\u5c40\u7684, \u4e00\u4e2a\u975e\u5168\u5c40\u5b9e\u4f53\u5728\u5173\u5361\u91cd\u8bd5\u540e\u4f1a\u6d88\u5931, \u5168\u5c40 Tag \u53ef\u4ee5\u907f\u514d\u8fd9\u4ef6\u4e8b, \u901a\u5e38\u5168\u5c40 Tag \u6700\u5e38\u89c1\u7684\u7528\u6cd5\u662f\u548c HUD \u7ed3\u5408\u5728\u4e00\u8d77, \u8fd9\u6837\u4f60\u5c31\u62e5\u6709\u4e86\u4e00\u4e2a\u5728\u6e38\u620f\u5185\u6301\u4e45\u7684 ui \u90e8\u4ef6\u4e86.</li> </ul>"},{"location":"trans/il/","title":"IL","text":"<p>Info</p> <p>\u5982\u679c\u4f60\u5728\u4e4b\u524d\u5df2\u7ecf\u5b66\u4e60\u8fc7 <code>IL</code> \u5e76\u4e14\u4f7f\u7528\u8fc7\u7c7b <code>System.Reflection.Emit</code> \u8fd9\u4e9b api \u7684\u8bdd\u4f60\u53ef\u4ee5\u8df3\u8fc7\u8fd9\u4e00\u8282.</p>"},{"location":"trans/il/#_1","title":"\u7b80\u4ecb","text":"<p><code>IL</code> \u5168\u79f0 <code>Intermediate Language</code>, \u5373\u4e2d\u95f4\u8bed\u8a00, \u5728\u4e00\u4e9b\u8f83\u8001\u7684\u6587\u6863\u91cc\u9762\u5b83\u53ef\u80fd\u4e5f\u4f1a\u88ab\u53eb\u505a <code>MSIL</code>, \u5373 <code>Microsoft Intermediate Language</code>, \u5076\u5c14\u8fd8\u4f1a\u6709\u4e00\u4e9b\u5730\u65b9\u53eb\u505a <code>CIL</code>, \u5373 <code>Common Intermediate Language</code>, \u8fd9\u4e09\u79cd\u53eb\u6cd5\u901a\u5e38\u610f\u4e49\u4e0a\u90fd\u662f\u6307\u4e00\u4e2a\u4e1c\u897f. \u5728\u524d\u9762\u6211\u4eec\u5c31\u5df2\u7ecf\u63d0\u5230\u8fc7 <code>IL</code> \u4e86(\u9605\u8bfb\u4ee3\u78012), \u4f46\u662f\u5e76\u6ca1\u6709\u6df1\u5165\u7684\u8bb2\u89e3\u5b83\u5230\u5e95\u662f\u4ec0\u4e48\u6837\u7684. <code>IL</code> \u901a\u5e38\u6765\u8bf4\u53ef\u4ee5\u7406\u89e3\u6210\u4e24\u4e2a\u90e8\u5206, \u4e00\u4e2a \"\u6267\u884c\" \u90e8\u5206, \u4e00\u4e2a \"\u58f0\u660e\" \u90e8\u5206, \"\u6267\u884c\" \u90e8\u5206\u89c4\u5b9a\u4e86\u4e00\u4e2a\u51fd\u6570\u5185\u90e8\u7684\u4ee3\u7801\u5e94\u8be5\u600e\u4e48\u64cd\u63a7\u6211\u4eec\u7684\u7a0b\u5e8f, \u800c \"\u58f0\u660e\" \u90e8\u5206\u5219\u89c4\u5b9a\u4e86\u4e00\u4e2a\u51fd\u6570\u7684\u8fd4\u56de\u503c, \u53c2\u6570\u5217\u8868, \u8bbf\u95ee\u4fee\u9970\u7b26, \u6240\u5728\u7c7b, \u7c7b\u7684\u8bbf\u95ee\u4fee\u9970\u7b26, \u540d\u79f0\u7b49\u8fd9\u4e9b\u5143\u6570\u636e, \u83b7\u53d6\u8fd9\u4e9b\u5143\u6570\u636e\u5176\u5b9e\u4f60\u65e9\u5728\u5b66\u4e60\u53cd\u5c04\u7684\u65f6\u5019\u5c31\u8fdb\u884c\u8fc7. \u540c\u65f6\u4fee\u6539\u6216\u751f\u6210\u8fd9\u4e9b\u5143\u6570\u636e\u4e5f\u4e0d\u56f0\u96be, \u4f46\u662f\u5728\u8fdb\u884c\u851a\u84dd modding \u65f6\u4fee\u6539\u6216\u751f\u6210\u8fd9\u4e9b\u5143\u6570\u636e\u7684\u64cd\u4f5c\u51e0\u4e4e\u4e0d\u4f1a\u88ab\u4f7f\u7528\u5230, \u6240\u4ee5\u8fd9\u4e00\u8282\u6211\u4eec\u805a\u7126\u4e8e <code>IL</code> \u7684 \"\u6267\u884c\" \u90e8\u5206, \u8bb2\u8ff0\u5176\u57fa\u672c\u7ed3\u6784, \u57fa\u7840\u8bed\u6cd5\u7b49\u5185\u5bb9.  </p>"},{"location":"trans/il/#_2","title":"\u521d\u5370\u8c61","text":"<p>HelloWorld!<pre><code>namespace DynamicAssemblyTest;\n\npublic static class Program\n{\n    public static void Main()\n    {\n        Console.WriteLine(\"Hello world!\");\n    }\n}\n</code></pre> \u73b0\u5728, \u8bd5\u7740\u7f16\u8bd1\u4e0a\u8ff0\u5f88\u7b80\u5355\u7684 HelloWorld \u7a0b\u5e8f, \u627e\u5230\u5176\u7a0b\u5e8f\u96c6, \u7136\u540e\u7528 <code>dnSpy</code>(\u6216\u8005 <code>ILSpy</code> \u4e5f\u884c) \u6253\u5f00\u5b83. \u4e0d\u8fc7\u8fd9\u6b21\u6211\u4eec\u4e0d\u662f\u5728\u770b <code>C#</code> \u4ee3\u7801\u4e86, \u6211\u4eec\u9700\u8981\u770b <code>IL</code> \u4ee3\u7801, \u6240\u4ee5\u6211\u4eec\u5728\u5982\u4e0b\u56fe\u7684\u8fd9\u4e2a\u4e0b\u62c9\u6846\u4e2d\u9009\u62e9 <code>IL</code>:</p> <p></p> <p>\u5728\u56fe\u4e2d\u7684\u90a3\u4e00\u5768\u4f60\u53ef\u80fd\u4e0d\u77e5\u6240\u63aa\u7684\u4ee3\u7801\u5c31\u662f <code>IL</code> \u4ee3\u7801\u4e86, \u5728\u4e0a\u8ff0 <code>IL</code> \u4ee3\u7801\u4e2d <code>.method</code> <code>.class</code> \u8fd9\u4e00\u7c7b\u5b57\u6837\u5c31\u8868\u793a\u58f0\u660e\u4e00\u4e2a \u65b9\u6cd5/\u7c7b, \u800c\u5176\u540e\u9762\u6240\u8ddf\u7684\u4e00\u5927\u957f\u4e32\u5173\u952e\u5b57\u5c31\u662f\u4e00\u4e9b\u5143\u6570\u636e, \u6bd4\u5982\u7c7b\u540d, \u8bbf\u95ee\u4fee\u9970\u7b26\u7b49\u6211\u4eec\u4e4b\u524d\u8c08\u8bba\u8fc7\u7684\u4e1c\u897f, \u540e\u9762\u7684\u5927\u62ec\u53f7\u5c31\u8868\u793a\u8fd9\u4e2a\u58f0\u660e\u7684 \"\u5185\u5bb9\u7269\", \u901a\u5e38\u7c7b\u7684 \"\u5185\u5bb9\u7269\" \u6709\u5185\u90e8\u7c7b, \u65b9\u6cd5, \u6784\u9020\u5668, \u5b57\u6bb5, \u5c5e\u6027\u7b49, \u90a3\u4e48\u663e\u800c\u6613\u89c1\u8fd9\u91cc\u5c31\u6beb\u65e0\u7591\u95ee\u5c31\u662f <code>IL</code> \u7684\u58f0\u660e\u90e8\u5206\u4e86. \u73b0\u5728\u6211\u4eec\u5173\u6ce8 <code>.method</code> \u58f0\u660e, \u5176\u7684 \"\u5185\u5bb9\u7269\" \u5c31\u662f\u6211\u4eec\u63a5\u4e0b\u6765\u8981\u805a\u7126\u7684, \u5373 <code>IL</code> \u7684 \"\u6267\u884c\" \u90e8\u5206. \u5728\u4e0a\u56fe\u4e2d dnSpy \u5e2e\u6211\u4eec\u5c06\u524d\u9762\u52a0\u4e0a\u4e86\u5b57\u8282\u5185\u5b58\u504f\u79fb\u7684\u90a3\u6bcf\u4e00\u884c\u5c31\u662f\u6211\u4eec\u7684 <code>IL</code> \u4ee3\u7801\u4e86, \u4e0d\u8fc7\u8fd9\u91cc\u6211\u4eec\u4e0d\u592a\u4f1a\u9700\u8981\u8fd9\u4e2a\u504f\u79fb\u91cf, \u56e0\u4e3a\u5927\u591a\u6570\u6d89\u53ca\u64cd\u4f5c <code>IL</code> \u7684\u5e93\u90fd\u4f1a\u4e3a\u6211\u4eec\u81ea\u52a8\u5b8c\u6210\u8fd9\u4e2a\u504f\u79fb\u7684\u8ba1\u7b97.</p>"},{"location":"trans/il/#_3","title":"\u5207\u6362\u73af\u5883 &amp; \u52a8\u6001\u7a0b\u5e8f\u96c6","text":"<p>\u73b0\u5728\u6211\u4eec\u9700\u8981\u4e00\u4e2a\u73af\u5883\u6765\u4e66\u5199\u6211\u4eec\u7684 <code>IL</code> \u4ee3\u7801, \u5f53\u7136\u4f60\u867d\u7136\u5b8c\u5168\u53ef\u4ee5\u5c31\u5728 dnSpy \u5bf9\u7740\u90a3\u4e00\u5927\u5806 <code>C#</code> \u7f16\u8bd1\u540e\u7684 <code>IL</code> \u8fdb\u884c\u4fee\u6539,  \u5e76\u9891\u7e41\u4fdd\u5b58\u4fee\u6539\u7136\u540e\u8fd0\u884c\u6765\u67e5\u770b\u6548\u679c, \u4f46\u662f\u8fd9\u603b\u5f52\u6ca1\u6709\u6211\u4eec\u76f4\u63a5\u5728 <code>C#</code> \u4ee3\u7801\u91cc\u5199 <code>IL</code> \u4ee3\u7801\u91cc\u65b9\u4fbf!</p> <p>\u9996\u5148, \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u4e0d\u518d\u5728 mod \u5de5\u7a0b\u91cc\u5de5\u4f5c\u4e86, \u8fd9\u90e8\u5206\u5185\u5bb9\u662f\u72ec\u7acb\u5f00\u6765\u7684, \u6240\u4ee5\u6211\u4f1a\u63a8\u8350\u4f60\u65b0\u5efa\u4e00\u4e2a\u9879\u76ee\u6765\u505a\u8fd9\u4e9b. \u8fd9\u91cc\u6211\u7ed9\u9879\u76ee\u53d6\u7684\u540d\u662f <code>DynamicAssemblyTest</code>, \u76ee\u6807\u6846\u67b6\u662f <code>.net 7</code>. \u5b8c\u6210\u540e, \u590d\u5236\u7c98\u8d34\u4ee5\u4e0b\u4ee3\u7801(\u4e4b\u540e\u6211\u4eec\u4f1a\u6162\u6162\u89e3\u91ca\u7684): <pre><code>using System.Reflection;\nusing System.Reflection.Emit;\n\nnamespace DynamicAssemblyTest;\n\npublic static class Program\n{\n    public static MethodInfo GenerateMethod(Action&lt;ILGenerator&gt; generateAction)\n    {\n        AssemblyBuilder asmBuilder = AssemblyBuilder.DefineDynamicAssembly(new(\"MyAssembly\"), AssemblyBuilderAccess.RunAndCollect);\n        ModuleBuilder moduleBuilder = asmBuilder.DefineDynamicModule(\"MyTestModule\");\n        TypeBuilder typeBuilder = moduleBuilder.DefineType(\"MyType\");\n        MethodBuilder methodBuilder = typeBuilder.DefineMethod(\"MyMethod\", MethodAttributes.Public | MethodAttributes.Static);\n        generateAction(methodBuilder.GetILGenerator());\n        return typeBuilder.CreateType().GetMethod(\"MyMethod\")!;\n    }\n\n    public static void Main()\n    {\n        MethodInfo methodInfo = GenerateMethod(il =&gt;\n        {\n            il.Emit(OpCodes.Ldstr, \"Hello Dynamic Method!\");\n            il.Emit(OpCodes.Call, typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!);\n            il.Emit(OpCodes.Ret);\n        });\n        Action action = methodInfo.CreateDelegate&lt;Action&gt;();\n        action();\n    }\n}\n</code></pre></p> <p>Note</p> <p>\u6211\u9ed8\u8ba4\u542f\u7528\u4e86\u9690\u5f0f\u547d\u540d\u7a7a\u95f4, \u5982\u679c\u4f60\u9047\u5230\u4e86\u7c7b\u578b\u672a\u627e\u5230\u7684\u62a5\u9519\u90a3\u4f60\u5c31\u5f97\u624b\u52a8 using \u4e00\u4e0b\u5269\u4f59\u7684\u90a3\u4e9b\u547d\u540d\u7a7a\u95f4\u4e86.</p> <p>\u73b0\u5728\u8fd0\u884c\u4f60\u7684\u7a0b\u5e8f, \u4f60\u5e94\u8be5\u4f1a\u5f97\u5230\u4e00\u53e5\u8f93\u51fa: <code>Hello Dynamic Method!</code>. \u4e0a\u8ff0\u4ee3\u7801\u5176\u5b9e\u662f\u5728\u5728\u4ee3\u7801\u4e2d\u52a8\u6001\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7a0b\u5e8f\u96c6, \u7136\u540e\u52a8\u6001\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7c7b, \u5e76\u5411\u91cc\u9762\u52a8\u6001\u5b9a\u4e49\u4e86\u4e00\u4e2a <code>MyMethod</code> \u65b9\u6cd5, \u4e4b\u540e\u6211\u4eec\u52a8\u6001\u5730 \"\u7f16\u8bd1\" \u4e86\u8fd9\u4e2a\u7a0b\u5e8f\u96c6\u5e76\u5c06\u5176\u88c5\u8f7d\u5230\u6211\u4eec\u7684\u7a0b\u5e8f\u96c6\u57df\u4e2d, \u5176\u4e2d, <code>MyMethod</code> \u65b9\u6cd5\u7684 <code>IL</code> \u7684\u5185\u5bb9\u5c31\u662f\u5728\u6211\u4eec\u7684 <code>Main</code> \u65b9\u6cd5\u4e2d <code>GenerateMethod</code> \u53c2\u6570\u4e2d\u7684\u59d4\u6258\u5b9a\u4e49\u7684. \u5f80\u7b80\u5355\u6765\u8bf4\u5c31\u662f\u6211\u4eec\u5728\u4ee3\u7801\u4e2d\u53cd\u5c04\u521b\u5efa\u4e86\u4e00\u6bb5\u65b0\u7684\u4ee3\u7801\u5e76\u6267\u884c, \u8fd9\u542c\u8d77\u6765\u662f\u4e0d\u662f\u9177\u6781\u4e86? \u4e0a\u9762\u8fd9\u4e2a\u52a8\u6001\u5b9a\u4e49\u7a0b\u5e8f\u96c6\u7684\u5e93\u53eb\u505a <code>System.Reflection.Emit</code>, \u5728\u8fd9\u91cc\u6211\u4eec\u53ea\u662f\u4e3a\u4e86\u5b66\u4e60\u4e00\u70b9 <code>IL</code> \u77e5\u8bc6\u800c\u4f7f\u7528, \u5230\u540e\u9762\u4fee\u6539\u851a\u84dd\u7684\u7a0b\u5e8f\u96c6\u65f6\u6211\u4eec\u9700\u8981\u4f7f\u7528 Everest \u5e26\u7684 <code>Mono.Cecil</code> \u5e93, \u4e0d\u8fc7\u4ed6\u4eec\u5927\u540c\u5c0f\u5f02.</p>"},{"location":"trans/il/#il_1","title":"\u57fa\u672c <code>IL</code>","text":"<pre><code>IL_0000: nop\nIL_0001: ldstr     \"Hello world!\"\nIL_0006: call      void [System.Console]System.Console::WriteLine(string)\nIL_000B: nop\nIL_000C: ret\n</code></pre> <p>\u901a\u5e38\u6765\u8bf4, \u4e00\u6bb5 <code>IL</code> \u5305\u542b\u591a\u884c <code>IL</code>, \u6bcf\u4e00\u884c <code>IL</code>(\u6211\u5076\u5c14\u4e5f\u4f1a\u79f0\u4e3a\u4e00\u53e5 <code>IL</code>) \u90fd\u5305\u542b\u4e00\u4e2a\u64cd\u4f5c\u7801(OpCode)\u4ee5\u53ca\u53ef\u4ee5\u6ca1\u6709\u7684\u53c2\u6570. \u6bd4\u5982\u4e0a\u8ff0\u6bb5 <code>IL</code>, \u5176\u5305\u542b\u4e94\u884c <code>IL</code>:</p> <ul> <li>\u7b2c\u4e00\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>nop</code>, \u6ca1\u6709\u53c2\u6570</li> <li>\u7b2c\u4e8c\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>ldstr</code>, \u53c2\u6570\u662f\u4e00\u4e32\u5b57\u7b26\u4e32, \u6216\u8005\u4e25\u8c28\u7684\u8bf4, \u662f\u4e00\u4e2a\u5b57\u7b26\u4e32\u7684 <code>token</code>, \u5b83\u5f15\u7528\u4e86\u7a0b\u5e8f\u96c6\u5143\u6570\u636e\u4e2d\u5b58\u653e\u5b57\u7b26\u4e32\u672c\u4f53\u7684\u4f4d\u7f6e,  \u4e0d\u8fc7\u6211\u4eec\u53ef\u4ee5\u5ffd\u7565\u8fd9\u4e2a\u7ec6\u8282, \u56e0\u4e3a\u6211\u4eec\u4e0d\u4f1a\u6d89\u53ca\u5230 <code>IL</code> \u7684\u5177\u4f53\u5b57\u8282\u5c42\u9762\u7684\u4e1c\u897f.</li> <li>\u7b2c\u4e09\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>call</code>, \u53c2\u6570\u662f\u4e00\u4e2a\u65b9\u6cd5, \u5b83\u4e5f\u662f\u4e00\u4e2a <code>token</code>, \u5176\u4e5f\u662f\u5f15\u7528\u4e86\u5143\u6570\u636e\u4e2d\u5b58\u653e\u65b9\u6cd5\u672c\u4f53\u7684\u4f4d\u7f6e</li> <li>\u7b2c\u56db\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>nop</code>, \u6ca1\u6709\u53c2\u6570</li> <li>\u7b2c\u4e94\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>ret</code>, \u6ca1\u6709\u53c2\u6570</li> </ul> <p>\u90a3\u4e48, \u5728\u77e5\u9053 <code>IL</code> \u7684\u57fa\u672c\u7ed3\u6784\u540e, \u6211\u4eec\u5c31\u53ef\u4ee5\u5177\u4f53\u5b66\u4e60 <code>IL</code> \u8fd9\u4e9b\u64cd\u4f5c\u7801\u5230\u5e95\u5e72\u4e86\u4ec0\u4e48\u4e86.</p>"},{"location":"trans/il/#_4","title":"\u8bc4\u4f30\u6808","text":"<p>Note</p> <p>\u5982\u679c\u4f60\u5728\u8fd9\u91cc\u4e0d\u77e5\u9053\u6808\u662f\u4ec0\u4e48\u7684\u8bdd, \u4f60\u5c31\u8be5\u53bb\u590d\u4e60\u4e00\u4e0b\u4f60\u4e4b\u524d\u5b66\u4e60\u7684\u6570\u636e\u7ed3\u6784\u4e4b\u6808\u4e86.</p> <p>\u5728 <code>IL</code> \u4ee3\u7801\u4e2d, \u5927\u91cf\u64cd\u4f5c\u7b26\u672c\u8d28\u4e0a\u90fd\u662f\u5728\u64cd\u4f5c\u4e00\u4e2a\u53eb\u505a <code>\u8bc4\u4f30\u6808</code> \u7684\u4e1c\u897f, \u4ece\u5b57\u9762\u4e0a\u6211\u4eec\u5c31\u53ef\u4ee5\u77e5\u9053\u5b83\u662f\u4e00\u4e2a\u6808, \u90a3\u4e48\u65e2\u7136\u662f\u6808, \u90a3\u4e48\u901a\u5e38\u5c31\u6709 <code>\u538b\u5165</code> \u548c <code>\u5f39\u51fa</code> \u4e24\u79cd\u64cd\u4f5c, <code>\u8bc4\u4f30\u6808</code> \u4e5f\u662f\u5982\u6b64. \u6bd4\u5982\u5982\u4e0b <code>C#</code> \u65b9\u6cd5: <pre><code>static int Add(int a, int b, int c) \n{\n    return a + b + c;\n}\n</code></pre></p> <p>\u5b83\u5728\u7f16\u8bd1\u5668\u7684 <code>Release</code> \u4f18\u5316\u4e0b\u4f1a\u7f16\u8bd1\u6210\u5982\u4e0b <code>IL</code>:</p> <p>Info</p> <p>\u7f16\u8bd1\u5668\u7684 <code>Debug</code> \u7f16\u8bd1\u4e0b\u4f1a\u4ea7\u751f\u5f88\u591a\u7528\u4e8e\u8c03\u8bd5\u4ee3\u7801\u7684 <code>IL</code>, \u76f8\u5bf9\u6765\u8bf4\u4f1a\u590d\u6742\u5f88\u591a, \u6240\u4ee5\u6211\u4eec\u4f7f\u7528 <code>Release</code> \u7f16\u8bd1\u6765\u5c3d\u53ef\u80fd\u7b80\u5316</p> <pre><code>.method private hidebysig static \n        int32 Add (\n            int32 a,\n            int32 b,\n            int32 c\n        ) cil managed \n    {\n        .maxstack 8\n\n        IL_0000: ldarg.0\n        IL_0001: ldarg.1\n        IL_0002: add\n        IL_0003: ldarg.2\n        IL_0004: add\n        IL_0005: ret\n    } // end of method Program::Add\n</code></pre> <p>\u8fd9\u91cc\u6211\u4eec\u628a\u4e00\u90e8\u5206\u58f0\u660e\u90e8\u5206\u653e\u51fa\u6765\u4e86, \u4e0d\u8fc7\u6211\u4eec\u53ea\u9700\u8981\u5173\u5fc3\u8fd9\u4e00\u884c: <code>.maxstack 8</code>, \u5b83\u8868\u793a\u8bf7\u6c42\u5728\u8fd9\u4e2a\u65b9\u6cd5\u6267\u884c\u8fc7\u7a0b\u4e2d\u8bc4\u4f30\u6808\u6709\u786e\u4fdd 8 \u4e2a\u5927\u5c0f\u7684\u7a7a\u95f4\u53ef\u4ee5\u4f7f\u7528. \u7528\u56fe\u8868\u7684\u65b9\u6cd5\u5927\u6982\u662f(\u6700\u5de6\u4fa7\u6808\u9ad8\u5ea6\u6700\u4f4e, \u5411\u53f3\u6808\u9ad8\u5ea6\u9010\u6e10\u589e\u52a0, \u7ea2\u8272\u8868\u793a\u76ee\u524d\u4f7f\u7528\u4e86\u7684\u6808\u4f4d, \u4e4b\u540e\u7684\u56fe\u8868\u540c):</p> <p> <pre><code>flowchart LR\n    S1 --- S2 --- S3 --- S4 --- S5 --- S6 --- S7 --- S8\n    style S1 stroke:red</code></pre> </p> <p>\u9996\u5148\u6211\u4eec\u4f1a\u4ecb\u7ecd\u4e00\u4e2a\u7cfb\u5217\u7684\u64cd\u4f5c\u7b26 <code>ldarg.*</code>, \u5b83\u8868\u793a\u5c06\u65b9\u6cd5\u53c2\u6570\u5217\u8868\u4e2d\u7684\u7b2c *-1 \u4e2a\u53c2\u6570\u538b\u5165\u8bc4\u4f30\u6808\u4e2d, \u4e0d\u5e26\u53c2\u6570(<code>ldarg.0</code> \u4e0e <code>ldarg.1</code> \u91cc\u7684\u6570\u5b57\u662f\u64cd\u4f5c\u7b26\u672c\u8eab, \u4e0d\u8981\u8ba4\u4e3a\u5b83\u662f\u4e00\u4e2a\u53c2\u6570\u4e86),  \u6ce8\u610f\u8fd9\u662f\u5728\u9759\u6001\u65b9\u6cd5\u4e2d\u800c\u8a00\u7684, \u5982\u679c\u8be5\u65b9\u6cd5\u662f\u6210\u5458\u65b9\u6cd5, \u90a3\u4e48 <code>ldarg.0</code> \u5b9e\u9645\u4e0a\u538b\u5165\u7684\u662f <code>this</code> \u7684\u503c, \u800c <code>ldarg.1</code> \u624d\u662f\u7b2c\u4e00\u4e2a\u53c2\u6570.  </p> <p>\u5728\u4e0a\u8ff0\u6bb5 <code>IL</code> \u4e2d, \u8be5\u65b9\u6cd5\u662f\u4e2a\u9759\u6001\u65b9\u6cd5, \u6240\u4ee5\u524d\u4e24\u884c <code>ldarg.0</code> \u4e0e <code>ldarg.1</code> \u4f1a\u5c06\u7b2c\u4e00\u4e2a\u53c2\u6570\u548c\u7b2c\u4e8c\u4e2a\u53c2\u6570\u538b\u5165\u8bc4\u4f30\u6808\u4e2d. \u73b0\u5728\u5047\u8bbe\u6211\u4eec\u8c03\u7528\u4f20\u5165\u7684\u53c2\u6570\u5206\u522b\u662f <code>1, 2, 3</code>(Sn\u8868\u793a\u672a\u4f7f\u7528\u7684\u6808\u4f4d, a:b \u8868\u793a\u8be5\u4f4d\u7f6e\u5b58\u5165\u4e86\u4e00\u4e2aa\u7c7b\u578b\u7684b\u503c, \u540e\u540c):</p> <p> <pre><code>flowchart \n    subgraph start\n    direction LR\n    S1_3[\"S1\"] --- S2_3[\"S2\"] --- S3_3[\"S3\"] --- S4_3[\"S4\"]\n    end\n\n    subgraph ldarg.0\n    direction LR\n    S1[\"int32: 1\"] --- S2 --- S3 --- S4\n    style S1 stroke:red\n    end\n\n    subgraph ldarg.1\n    direction LR\n    S1_2[\"int32: 1\"] --- S2_2[\"int32: 2\"] --- S3_2[\"S3\"] --- S4_2[\"S4\"]\n    style S1_2 stroke:red\n    style S2_2 stroke:red\n    end\n\n    start --&gt; ldarg.0 --&gt; ldarg.1</code></pre> </p> <p>\u7136\u540e\u8981\u4ecb\u7ecd\u7684\u662f <code>add</code> \u64cd\u4f5c\u7b26, <code>add</code> \u64cd\u4f5c\u7b26\u4f1a\u5f39\u51fa\u8bc4\u4f30\u6808\u4e0a\u7684\u4e24\u4e2a\u5143\u7d20, \u7136\u540e\u5c06\u5b83\u4eec\u76f8\u52a0, \u7136\u540e\u5c06\u7ed3\u679c\u538b\u5165\u8bc4\u4f30\u6808. \u5f53\u8fd9\u4e24\u4e2a\u5143\u7d20\u4efb\u610f\u4e00\u4e2a\u4e0d\u662f\u57fa\u672c\u6570\u5b57\u7c7b\u578b\u65f6 jit \u5c31\u4f1a\u629b\u51fa <code>InvalidProgramException</code> \u5f02\u5e38. \u540c\u65f6\u6ce8\u610f\u4e00\u4e2a\u7ec6\u8282, \u4f60\u4e3a\u7c7b\u91cd\u8f7d\u7684\u52a0\u53f7\u8fd0\u7b97\u7b26\u5e76\u4e0d\u662f\u4f7f\u7528\u7684\u8fd9\u4e2a\u64cd\u4f5c\u7b26, \u800c\u662f\u8c03\u7528\u7684\u4e00\u4e2a\u7279\u6b8a\u7684\u540d\u4e3a <code>op_Add</code> \u7684\u5e26\u6709 <code>special name</code> \u6807\u8bb0\u7684\u65b9\u6cd5. \u6700\u540e\u662f <code>ret</code> \u64cd\u4f5c\u7b26, \u5f53\u65b9\u6cd5\u6ca1\u6709\u8fd4\u56de\u503c\u65f6\u5b83\u4f1a\u5c06\u63a7\u5236\u6743\u4ea4\u56de\u7ed9\u8c03\u7528\u8005, \u540c\u65f6 jit \u4f1a\u4e3a\u6211\u4eec\u68c0\u67e5\u8bc4\u4f30\u6808\u662f\u5426\u6e05\u7a7a, \u5982\u679c\u8bc4\u4f30\u6808\u4e0a\u8fd8\u6709\u4e1c\u897f\u90a3\u4e48\u540c\u6837 jit \u4f1a\u629b\u51fa\u5f02\u5e38. \u5f53\u65b9\u6cd5\u62e5\u6709\u8fd4\u56de\u503c\u65f6\u5b83\u4f1a\u786e\u4fdd\u8bc4\u4f30\u6808\u4e0a\u6709\u4e14\u53ea\u5269\u4e00\u4e2a\u5143\u7d20, \u7136\u540e\u5c06\u8fd9\u4e2a\u503c\u5f39\u51fa\u5e76\u538b\u5165\u8c03\u7528\u8005\u7684\u8bc4\u4f30\u6808\u4e0a(\u8bc4\u4f30\u6808\u662f\u65b9\u6cd5\u72ec\u7acb\u5730). \u90a3\u4e48\u81ea\u7136\u800c\u7136, \u6211\u4eec\u6700\u521d\u7684\u90a3 6 \u53e5 <code>IL</code> \u5927\u6982\u4f1a\u662f\u8fd9\u4e2a\u5de5\u4f5c\u6d41\u7a0b:</p> <p> <pre><code>flowchart \n    subgraph start\n    direction LR\n    S1 --- S2 --- S3 --- S4\n    end\n\n    subgraph ldarg.0\n    direction LR\n    S1_2[\"int32: 1\"] --- S2_2[\"S2\"] --- S3_2[\"S3\"] --- S4_2[\"S4\"]\n    style S1_2 stroke:red\n    end\n\n    subgraph ldarg.1\n    direction LR\n    S1_3[\"int32: 1\"] --- S2_3[\"int32: 2\"] --- S3_3[\"S3\"] --- S4_3[\"S4\"]\n    style S1_3 stroke:red\n    style S2_3 stroke:red\n    end\n\n    subgraph add\n    direction LR\n    S1_4[\"int32: 3\"] --- S2_4[\"S2\"] --- S3_4[\"S3\"] --- S4_4[\"S4\"]\n    style S1_4 stroke:red\n    end\n\n    subgraph ldarg.2\n    direction LR\n    S1_5[\"int32: 3\"] --- S2_5[\"int32: 3\"] --- S3_5[\"S3\"] --- S4_5[\"S4\"]\n    style S1_5 stroke:red\n    style S2_5 stroke:red\n    end\n\n    subgraph 2ndadd [\"2nd add\"]\n    direction LR\n    S1_6[\"int32: 6\"] --- S2_6[\"S2\"] --- S3_6[\"S3\"] --- S4_6[\"S4\"]\n    style S1_6 stroke:red\n    end\n\n    start --&gt; ldarg.0 --&gt; ldarg.1 --&gt; add --&gt; ldarg.2 --&gt; 2ndadd --&gt; ret</code></pre> </p> <p><sub>\u8fd9\u56fe\u505a\u5b8c\u540e\u770b\u4e0a\u53bb\u597d\u50cf\u4e0d\u662f\u60f3\u8c61\u4e2d\u7684\u90a3\u4e48\u76f4\u89c2...</sub></p>"},{"location":"trans/il/#il_2","title":"\u4e66\u5199 <code>IL</code>","text":"<p>\u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u4e86\u89e3\u4e86\u4e00\u5c0f\u4e9b <code>IL</code> \u7684\u77e5\u8bc6, \u73b0\u5728\u6211\u4eec\u56de\u5230\u4e4b\u524d\u7684\u5de5\u7a0b\u4e2d, \u66f4\u6539\u4e3a\u4ee5\u4e0b\u4ee3\u7801: <pre><code>using System.Reflection;\nusing System.Reflection.Emit;\n\nnamespace DynamicAssemblyTest;\n\npublic static class Program\n{\n    public static MethodInfo GenerateMethod(Action&lt;ILGenerator&gt; generateAction)\n    {\n        AssemblyBuilder asmBuilder = AssemblyBuilder.DefineDynamicAssembly(new(\"MyAssembly\"), AssemblyBuilderAccess.RunAndCollect);\n        ModuleBuilder moduleBuilder = asmBuilder.DefineDynamicModule(\"MyTestModule\");\n        TypeBuilder typeBuilder = moduleBuilder.DefineType(\"MyType\");\n        MethodBuilder methodBuilder = typeBuilder.DefineMethod(\"MyMethod\", MethodAttributes.Public | MethodAttributes.Static\n            , typeof(int), new Type[] { typeof(int), typeof(int), typeof(int) });\n        generateAction(methodBuilder.GetILGenerator());\n        return typeBuilder.CreateType().GetMethod(\"MyMethod\")!;\n    }\n\n    public static void Main()\n    {\n        MethodInfo methodInfo = GenerateMethod(il =&gt;\n        {\n            il.Emit(OpCodes.Ldarg_0);\n            il.Emit(OpCodes.Ldarg_1);\n            il.Emit(OpCodes.Add);\n            il.Emit(OpCodes.Ldarg_2);\n            il.Emit(OpCodes.Add);\n            il.Emit(OpCodes.Ret);\n        });\n        var func = methodInfo.CreateDelegate&lt;Func&lt;int, int, int, int&gt;&gt;();\n        var result = func(1, 2, 3);\n        Console.WriteLine($\"result is {result}\");\n    }\n}\n</code></pre></p> <p>\u8fd9\u91cc\u6211\u4eec\u5728\u4e0a\u9762\u66f4\u6539\u4e86\u65b9\u6cd5\u7684\u5b9a\u4e49, \u4f7f\u5b83\u53d8\u4e3a\u5e26\u6709 <code>int</code> \u8fd4\u56de\u503c\u4e14\u63a5\u6536 3 \u4e2a\u53c2\u6570\u7684\u65b9\u6cd5, \u7136\u540e\u9002\u5f53\u4fee\u6539\u6211\u4eec\u8c03\u7528\u8fd9\u4e2a\u65b9\u6cd5\u7684\u5730\u65b9, \u7136\u540e\u8fd0\u7528\u6211\u4eec\u521a\u624d\u7684 <code>IL</code> \u77e5\u8bc6\u5b9e\u73b0\u8fd9\u4e2a\u65b9\u6cd5. \u73b0\u5728, \u8fd0\u884c\u5b83, \u4f60\u5e94\u8be5\u4f1a\u5f97\u5230 <code>result is 6</code> \u7684\u8f93\u51fa, \u4f46\u662f\u6211\u4eec\u5168\u7a0b\u90fd\u6ca1\u6709\u5728 <code>C#</code> \u4ee3\u7801\u4e2d\u4f7f\u7528 <code>+</code> \u8fd0\u7b97\u7b26, \u800c\u662f\u76f4\u63a5\u5728 <code>IL</code> \u4e2d\u8c03\u7528 <code>add</code> \u64cd\u4f5c\u7b26, \u4ece\u67d0\u4e9b\u65b9\u9762\u6765\u8bf4\u8fd9\u633a\u6709\u8da3\u7684.</p> <p>\u73b0\u5728, \u8bd5\u7740\u5b8c\u6210\u4e00\u4e2a\u5c0f\u7ec3\u4e60, \u5c06\u4e0a\u9762 <code>GenerateMethod</code> \u65b9\u6cd5\u91cc\u5bf9 <code>MyMethod</code> \u7684\u5b9e\u73b0\u4ece <code>a + b + c</code> \u66f4\u6539\u4e3a <code>a + b * c</code>.</p> \u63d0\u793a\u7b54\u6848 <p>\u4e58\u6cd5\u7684\u64cd\u4f5c\u7b26\u4e3a <code>mul</code>, \u5176\u4f7f\u7528\u65b9\u6cd5\u4e0e <code>add</code> \u4e00\u81f4.</p> \u65b9\u6cd5\u4e00\u65b9\u6cd5\u4e8c\u89e3\u91ca <pre><code>il.Emit(OpCodes.Ldarg_1);\nil.Emit(OpCodes.Ldarg_2);\nil.Emit(OpCodes.Mul);\nil.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Add);\nil.Emit(OpCodes.Ret);\n</code></pre> <pre><code>il.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Ldarg_1);\nil.Emit(OpCodes.Ldarg_2);\nil.Emit(OpCodes.Mul);\nil.Emit(OpCodes.Add);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u5728\u65b9\u6cd5\u4e00\u4e2d\u6211\u4eec\u7684\u601d\u8def\u5f88\u81ea\u7136, \u5148\u538b\u5165\u540e\u4e24\u4e2a\u53c2\u6570\u4f7f\u5176\u76f8\u4e58\u540e\u518d\u4e0e\u7b2c\u4e00\u4e2a\u53c2\u6570\u76f8\u52a0. \u4e5f\u5c31\u662f\u5b9e\u73b0\u7684\u662f <code>(b * c) + a</code>. \u5728\u65b9\u6cd5\u4e8c\u4e2d\u5c31\u9700\u8981\u52a8\u70b9\u8111\u5b50, \u6211\u4eec\u4e00\u6b21\u6027\u5c06\u4e09\u4e2a\u53c2\u6570\u538b\u5165\u4e86\u6808\u4e2d, \u7136\u540e\u6267\u884c\u4e00\u4e2a <code>mul</code> \u64cd\u4f5c, \u5b83\u4f1a\u628a\u6700\u540e\u538b\u5165\u7684\u4e24\u4e2a\u5143\u7d20\u5f39\u51fa\u76f8\u4e58\u540e\u538b\u5165, \u7136\u540e\u6211\u4eec\u9a6c\u4e0a\u518d\u6267\u884c\u4e00\u4e2a <code>add</code> \u64cd\u4f5c, \u5c06\u521a\u521a\u88ab\u538b\u5165\u7684\u5143\u7d20\u4e0e\u6700\u5f00\u59cb\u88ab\u538b\u5165\u7684\u7b2c\u4e00\u4e2a\u53c2\u6570\u76f8\u52a0, \u4e5f\u5c31\u662f\u5b9e\u73b0\u7684\u662f <code>a + (b * c)</code>.</p> <p>\u73b0\u5728\u4f60\u53ef\u4ee5\u8bd5\u7740\u73a9\u4e00\u4e9b\u6709\u8da3\u7684\u4e1c\u897f, \u6bd4\u5982\u8bd5\u7740\u7528 <code>ldarg.3</code> \u538b\u5165\u4e00\u4e2a\u4e0d\u5b58\u5728\u7684\u7b2c\u56db\u4e2a\u53c2\u6570, \u6216\u8005\u5728 <code>ret</code> \u65f6\u8bc4\u4f30\u6808\u4e0a\u6ca1\u6709\u5143\u7d20\u6216\u8005\u6709\u5f88\u591a\u4e2a\u5143\u7d20. \u2003\u2014\u2014\u2014\u2014 \u5b83\u4eec\u90fd\u4f1a\u8ff7\u60d1 jit \u7136\u540e\u4e0d\u77e5\u6240\u63aa\u5730\u6254\u7ed9\u4f60\u4e00\u4e2a <code>InvalidProgramException</code>.</p> <p>\u90a3\u4e48\u518d\u6765\u8bd5\u8bd5 <code>a - b + c</code>:</p> \u63d0\u793a\u7b54\u6848 <p>\u51cf\u6cd5\u7684\u64cd\u4f5c\u7b26\u4e3a <code>sub</code>, \u5b83\u4f1a\u5f39\u51fa\u4e24\u4e2a\u503c, \u5c06\u540e\u5f39\u51fa\u7684\u503c\u51cf\u53bb\u5148\u5f39\u51fa\u7684\u503c\u540e\u5c06\u7ed3\u679c\u538b\u5165\u8bc4\u4f30\u6808.</p> <p><pre><code>il.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Ldarg_1);\nil.Emit(OpCodes.Sub);\nil.Emit(OpCodes.Ldarg_2);\nil.Emit(OpCodes.Add);\nil.Emit(OpCodes.Ret);\n</code></pre> \u4f60\u53ef\u80fd\u5df2\u7ecf\u53d1\u73b0\u7684\u4e00\u4e2a\u6bd4\u8f83\u8212\u670d\u7684\u70b9\u662f, \u76f8\u51cf\u7684\u987a\u5e8f\u521a\u597d\u5c31\u662f\u538b\u5165\u7684\u987a\u5e8f, \u4e5f\u5373\u5f39\u51fa\u7684\u9006\u987a\u5e8f, \u8fd9\u70b9\u4f1a\u8ba9\u6211\u4eec\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\u624b\u5199 <code>IL</code> \u7684\u66f4\u7b26\u5408\u76f4\u89c9\u4e00\u70b9.</p>"},{"location":"trans/il/#_5","title":"\u65b9\u6cd5\u7684\u8c03\u7528","text":"<p>\u73b0\u5728\u6211\u4eec\u7684 <code>IL</code> \u6307\u4ee4\u53ea\u80fd\u505a\u4e9b\u52a0\u52a0\u51cf\u51cf\u662f\u4e0d\u662f\u5f88\u65e0\u804a? \u90a3\u4e48\u73b0\u5728\u6211\u4eec\u6765\u8bd5\u8bd5\u5728 <code>IL</code> \u4e2d\u8c03\u7528\u65b9\u6cd5. \u5728 <code>IL</code> \u4e2d\u6709\u4e09\u79cd\u8c03\u7528\u65b9\u6cd5\u6307\u4ee4:</p> \u64cd\u4f5c\u7b26 \u53c2\u6570 \u63cf\u8ff0 <code>call</code> \u65b9\u6cd5 token \u6839\u636e\u65b9\u6cd5\u7684\u53c2\u6570\u5217\u8868(\u5305\u542b <code>this</code>, \u5982\u679c\u5176\u662f\u6210\u5458\u65b9\u6cd5\u65f6)\u9006\u987a\u5e8f\u5f39\u51fa\u5bf9\u5e94\u6570\u91cf\u53c2\u6570\u5e76\u4ee5\u6b64\u8c03\u7528\u5bf9\u5e94\u65b9\u6cd5 <code>callvirt</code> \u65b9\u6cd5 token \u540c <code>call</code>, \u4f46\u662f\u8be5\u6307\u4ee4\u5728\u5bf9\u5e94\u65b9\u6cd5\u4e3a\u865a\u65b9\u6cd5\u65f6\u4f1a\u5411\u4e0b\u5bfb\u627e\u91cd\u5199\u540e\u7684\u65b9\u6cd5 <code>calli</code> callsite \u63cf\u8ff0 \u6839\u636e callsite \u63cf\u8ff0 \u5f39\u51fa\u5bf9\u5e94\u53c2\u6570\u5e76\u518d\u6b21\u5f39\u51fa\u6240\u9700\u7684\u51fd\u6570\u6307\u9488\u5e76\u8c03\u7528 <p>\u5176\u4e2d\u7528\u7684\u6700\u591a\u7684\u662f <code>call</code> \u548c <code>callvirt</code>, \u6700\u540e\u4e00\u4e2a <code>calli</code> \u5728\u505a\u4e0e\u672c\u673a\u4ea4\u4e92\u65f6\u624d\u5e38\u7528,  \u56e0\u4e3a\u5b83\u8981\u6c42\u6211\u4eec\u6709\u5bf9\u5e94\u7684\u51fd\u6570\u6307\u9488(\u51fd\u6570\u6307\u9488\u53ef\u80fd\u5f88\u591a\u6559\u7a0b\u4e0d\u4f1a\u63d0\u53ca, \u4f60\u53ef\u4ee5\u5728MSDN \u4e0a\u7684\u4e0d\u5b89\u5168\u4ee3\u7801\u3001\u6570\u636e\u6307\u9488\u548c\u51fd\u6570\u6307\u9488\u8fd9\u7bc7\u6587\u7ae0\u4e2d\u4e86\u89e3).  </p> <p><code>call</code> \u4e0e <code>callvirt</code> \u6700\u4e3b\u8981\u7684\u533a\u522b\u662f, <code>call</code> \u6307\u4ee4\u4e00\u65e6\u6307\u5b9a\u4e86\u5bf9\u5e94\u65b9\u6cd5, \u90a3\u4e48\u5728\u8fd0\u884c\u65f6\u8c03\u7528\u7684\u65b9\u6cd5\u662f\u4e0d\u4f1a\u53d8\u7684, \u6240\u4ee5\u5b83\u901a\u5e38\u751f\u6210\u4e8e\u9759\u6001\u65b9\u6cd5\u7684\u8c03\u7528\u4e2d, \u800c <code>callvirt</code> \u5728\u8fd0\u884c\u65f6\u4f1a\u68c0\u6d4b\u76ee\u6807\u7c7b\u578b, \u5e76\u5411\u4e0b\u67e5\u627e\u53ef\u80fd\u7684\u88ab\u91cd\u5199\u540e\u7684\u65b9\u6cd5, \u6240\u4ee5\u6309\u5b57\u9762\u610f\u601d\u5b83\u7ecf\u5e38\u751f\u6210\u4e8e\u865a\u65b9\u6cd5\u7684\u8c03\u7528\u4e2d, \u4e0d\u8fc7\u4e00\u822c\u5bf9\u4e8e\u666e\u901a\u6210\u5458\u65b9\u6cd5\u7684\u8c03\u7528, <code>C#</code> \u7f16\u8bd1\u5668\u4e5f\u4f1a\u751f\u6210 <code>callvirt</code> \u6307\u4ee4, \u8fd9\u662f\u56e0\u4e3a <code>callvirt</code> \u9700\u8981\u68c0\u67e5\u76ee\u6807\u7c7b\u578b, \u5728\u8c03\u7528\u5bf9\u8c61\u4e3a <code>null</code> \u65f6\u5c31\u629b\u51fa <code>NullReferenceException</code>, \u800c <code>call</code> \u6307\u4ee4\u53ef\u80fd\u76f4\u5230\u65b9\u6cd5\u8c03\u7528\u4e00\u534a\u65f6\u624d\u5bdf\u89c9 <code>this</code> \u4e3a <code>null</code>, \u8fd9\u662f\u4e00\u4e2a\u5f88\u5371\u9669\u7684\u884c\u4e3a.</p> <p>\u5728\u6211\u4eec\u5e9f\u8bdd\u5b8c\u4e4b\u540e, \u662f\u65f6\u5019\u505a\u4e00\u70b9\u5b9e\u9645\u7684\u4e86. \u73b0\u5728, \u6211\u4eec\u4e0d\u9700\u8981\u6211\u4eec\u4e4b\u524d\u6d4b\u8bd5 <code>add</code>, <code>ret</code>, <code>mul</code>, <code>sub</code> \u6307\u4ee4\u65f6\u58f0\u660e\u7684\u65b9\u6cd5\u7b7e\u540d\u4e86, \u6240\u4ee5\u6211\u4eec\u66f4\u6539\u5982\u4e0b\u4ee3\u7801, \u4f7f\u5f97\u6211\u4eec\u7684\u52a8\u6001\u65b9\u6cd5 <code>MyMethod</code> \u8fd4\u56de <code>void</code> \u5e76\u4e14\u4e0d\u63a5\u6536\u53c2\u6570: <pre><code>public static MethodInfo GenerateMethod(Action&lt;ILGenerator&gt; generateAction)\n{\n    AssemblyBuilder asmBuilder = AssemblyBuilder.DefineDynamicAssembly(new(\"MyAssembly\"), AssemblyBuilderAccess.RunAndCollect);\n    ModuleBuilder moduleBuilder = asmBuilder.DefineDynamicModule(\"MyTestModule\");\n    TypeBuilder typeBuilder = moduleBuilder.DefineType(\"MyType\");\n    MethodBuilder methodBuilder = typeBuilder.DefineMethod(\"MyMethod\", MethodAttributes.Public | MethodAttributes.Static\n        , typeof(void), Type.EmptyTypes);\n    generateAction(methodBuilder.GetILGenerator());\n    return typeBuilder.CreateType().GetMethod(\"MyMethod\")!;\n}\n</code></pre></p> <p>\u987a\u4fbf\u628a\u4e0b\u9762\u4e5f\u6539\u6210\u8fd9\u6837, \u4ee5\u8d34\u5408\u6211\u4eec\u5728\u4e0a\u9762\u7684\u5b9a\u4e49, \u987a\u4fbf\u6e05\u7a7a\u4e00\u4e0b\u6211\u4eec\u7684\u65b9\u6cd5\u4f53: <pre><code>MethodInfo methodInfo = GenerateMethod(il =&gt;\n{\n    il.Emit(OpCodes.Ret);\n});\nvar action = methodInfo.CreateDelegate&lt;Action&gt;();\naction();\n</code></pre></p> <p>\u73b0\u5728, \u6211\u4eec\u6253\u7b97\u4f7f\u7528 <code>IL</code> \u5199\u4e00\u4e2a HelloWorld \u7a0b\u5e8f, \u90a3\u4e48\u5c31\u9700\u8981\u8c03\u7528 <code>System.Console.WriteLine(string)</code> \u8fd9\u4e2a\u65b9\u6cd5, \u6ce8\u610f\u6b64\u65f6\u6211\u4eec\u5fc5\u987b\u6e05\u695a\u6211\u4eec\u8c03\u7528\u7684\u65b9\u6cd5\u7684\u5177\u4f53\u67d0\u4e2a\u91cd\u8f7d, \u73b0\u5728\u4f7f\u7528\u53cd\u5c04\u77e5\u8bc6, \u83b7\u53d6\u8fd9\u4e2a\u9759\u6001\u65b9\u6cd5\u7684 <code>MethodInfo</code>: <pre><code>var cws = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\n</code></pre></p> <p>\u7136\u540e\u6211\u4eec\u89c2\u5bdf\u5b83\u7684\u53c2\u6570, \u53d1\u73b0\u9700\u8981\u4e00\u4e2a <code>string</code>, \u6240\u4ee5\u6211\u4eec\u5f97\u4f7f\u7528 <code>ldstr</code> <code>IL</code> \u6307\u4ee4, \u5b83\u4f1a\u5c06\u5b83\u53c2\u6570 token \u5bf9\u5e94\u7684\u5b57\u7b26\u4e32\u538b\u5165\u8bc4\u4f30\u6808, \u5728\u8fd9\u91cc\u6211\u4eec\u4e0d\u9700\u8981\u5173\u5fc3\u8fd9\u4e2a token \u5982\u4f55\u751f\u6210, <code>System.Reflection.Emit</code> \u4f1a\u5e2e\u6211\u4eec\u505a\u597d\u8fd9\u4e9b, \u5728\u8fd9\u91cc\u53ea\u9700\u8981\u4f20\u5165 <code>string</code>: <pre><code>il.Emit(OpCodes.Ldstr, \"Hello World in IL!\");\n</code></pre></p> <p>\u4e00\u5207\u5c31\u7eea, \u8c03\u7528\u6211\u4eec\u7684\u65b9\u6cd5:</p> <pre><code>il.Emit(OpCodes.Call, cws);\n</code></pre> <p>\u603b\u7684\u4ee3\u7801\u5982\u4e0b: <pre><code>ar cws = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nil.Emit(OpCodes.Ldstr, \"Hello World in IL!\");\nil.Emit(OpCodes.Call, cws);\nil.Emit(OpCodes.Ret);\n</code></pre></p> <p>\u73b0\u5728, \u8fd0\u884c\u7a0b\u5e8f, \u4f60\u5e94\u8be5\u4f1a\u770b\u5230\u5982\u4e0b\u8f93\u51fa: \u54c7\u4f60\u592a\u5f3a\u4e86\u4f60\u505a\u5230\u4e86\u8fd9\u4e2a\u795e\u4ed9\u64cd\u4f5c\u4f60\u600e\u4e48\u53ef\u4ee5\u8fd9\u4e48\u5f3a\uff01\uff01\uff01\u2003\u5f85\u4f1a\u513f\u6211\u8bf4\u6211\u81ea\u5df1\u5462<pre><code>Hello World in IL!\n</code></pre></p> <p>\u5bf9\u4e8e\u6709\u8fd4\u56de\u503c\u7684\u65b9\u6cd5, <code>call</code> \u8c03\u7528\u5b8c\u540e\u4f1a\u5c06\u8fd4\u56de\u503c\u538b\u5165\u5806\u6808, \u6bd4\u5982\u8981\u5c06\u4ee5\u4e0b <code>C#</code> \u4ee3\u7801\u8f6c\u4e3a <code>IL</code> \u4ee3\u7801: <pre><code>Console.WriteLine(Console.ReadLine());\n</code></pre></p> <p>\u53ea\u9700\u8981\u8fd9\u6837: <pre><code>var cws = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar cr = typeof(Console).GetMethod(\"ReadLine\")!;\nil.Emit(OpCodes.Call, cr);\nil.Emit(OpCodes.Call, cws);\nil.Emit(OpCodes.Ret);\n</code></pre></p> <p>\u5f53\u6211\u4eec\u4e0d\u9700\u8981\u8fd4\u56de\u503c\u65f6, \u6211\u4eec\u5fc5\u987b\u663e\u5f0f\u4f7f\u7528 <code>pop</code> \u6307\u4ee4\u820d\u5f03\u5b83, \u9632\u6b62\u5b83\"\u6c61\u67d3\"\u6211\u4eec\u7684\u8bc4\u4f30\u6808: <pre><code>// \u7b49\u5f85\u7528\u6237\u7684\u4e00\u4e2a\u56de\u8f66\u8f93\u5165\nConsole.ReadLine();\nConsole.WriteLine(\"Hey, I see you pressed the Enter!\");\n</code></pre></p> <pre><code>var cws = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar cr = typeof(Console).GetMethod(\"ReadLine\")!;\nil.Emit(OpCodes.Call, cr);\nil.Emit(OpCodes.Pop);\nil.Emit(OpCodes.Ldstr, \"Hey, I see you pressed the Enter!\");\nil.Emit(OpCodes.Call, cws);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u65b9\u6cd5\u7684\u53c2\u6570\u5217\u8868\u987a\u5e8f\u548c\u538b\u6808\u987a\u5e8f\u4e00\u81f4, \u8c03\u7528\u591a\u53c2\u6570\u65b9\u6cd5\u4e5f\u4f1a\u663e\u5f97\u5f88\u81ea\u7136: <pre><code>double a = Math.Pow(123, 4);\nConsole.WriteLine(a);\n</code></pre></p> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(double) })!;\nvar powMethod = typeof(Math).GetMethod(\"Pow\")!;\nil.Emit(OpCodes.Ldc_R8, 123.0);\nil.Emit(OpCodes.Ldc_R8, 4.0);\nil.Emit(OpCodes.Call, powMethod);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p><code>ldc.r8</code> \u6307\u4ee4\u5c06\u53c2\u6570\u4e2d\u7684 <code>float64</code>, \u5373 <code>double</code> \u5b57\u9762\u91cf\u538b\u5165\u8bc4\u4f30\u6808\u4e2d, \u7c7b\u4f3c\u7684\u64cd\u4f5c\u7b26\u8fd8\u6709 <code>ldc.i4</code>, \u5b83\u5c06\u53c2\u6570\u4e2d\u7684 <code>int32</code> \u5373 <code>int</code> \u5b57\u9762\u91cf\u538b\u5165\u8bc4\u4f30\u6808\u4e2d, \u6ce8\u610f\u5728\u8fd9\u91cc\u4f20\u53c2\u6211\u4eec\u5fc5\u987b\u660e\u786e\u5199\u660e\u53c2\u6570\u7c7b\u578b, \u6bd4\u5982\u4e0a\u9762\u7684 <code>IL</code> \u5982\u679c\u4f7f\u7528 <code>123</code> \u800c\u4e0d\u662f <code>123.0</code> \u4f1a\u53d1\u751f jit \u5f02\u5e38\u6216\u884c\u4e3a\u975e\u671f\u671b, \u56e0\u4e3a\u53c2\u6570\u7c7b\u578b\u4e0d\u5339\u914d, <code>123</code> \u5339\u914d\u5230\u4e86 <code>il.Emit</code> \u7684 <code>int</code> \u91cd\u8f7d, \u800c\u6211\u4eec\u9700\u8981\u7684\u662f <code>double</code> \u91cd\u8f7d, \u6240\u4ee5\u6211\u4eec\u5199\u660e <code>123.0</code> \u6216 <code>123d</code> \u4ee5\u4f7f\u5176\u6210\u4e3a <code>double</code> \u7c7b\u578b\u7684\u5b57\u9762\u91cf. \u5bf9\u4e8e <code>float</code> <code>long</code> <code>double</code> \u7b49\u8fd9\u4e9b\u6709\u5bf9\u5e94\u5b57\u9762\u91cf\u540e\u7f00\u7684(<code>f</code>, <code>l</code>, <code>d</code>) \u7c7b\u578b\u6211\u4eec\u76f4\u63a5\u52a0\u540e\u7f00\u5c31\u884c\u4e86, \u4f46\u5bf9\u4e8e <code>short</code> \u548c <code>byte</code> \u8fd9\u4e9b, \u6211\u4eec\u5fc5\u987b\u8fdb\u884c\u663e\u5f0f\u5f3a\u8f6c:</p> <pre><code>public static void Main()\n{\n    MethodInfo methodInfo = GenerateMethod(il =&gt;\n    {\n        // il \u4e2d\u6ca1\u6709\u5bf9\u5e94\u7684\u52a0\u8f7d `int16` \u548c `int8` \u7684\u6307\u4ee4, \u6211\u4eec\u5f97\u4f7f\u7528 `ldc.i4`, \n        // \u867d\u7136\u5b83\u672c\u6765\u662f\u7528\u6765\u52a0\u8f7d `int32` \u7684, \u4f46 jit \u4f1a\u77e5\u9053\u6211\u4eec\u60f3\u8981\u5e72\u4ec0\u4e48\n        // \u5bf9\u4e8e\u5c0f\u4e00\u70b9\u7684\u6574\u6570\u5b57\u9762\u91cf IL \u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a `ldc.i4.s` \u6307\u4ee4\n        // \u5176\u53c2\u6570\u4e3a `int8` \u5373 `byte` \u6216 `sbyte` \u7c7b\u578b\n        var printByte = typeof(Program).GetMethod(\"PrintByte\")!;\n        il.Emit(OpCodes.Ldc_I4_S, (byte)12);\n        il.Emit(OpCodes.Call, printByte);\n        il.Emit(OpCodes.Ldc_I4, (int)12);\n        il.Emit(OpCodes.Call, printByte);\n        il.Emit(OpCodes.Ret);\n    });\n    var action = methodInfo.CreateDelegate&lt;Action&gt;();\n    action();\n\n}\n\npublic static void PrintByte(byte v)\n{\n    Console.WriteLine($\"Your byte is {v}\");\n}\n</code></pre>"},{"location":"trans/il/#_6","title":"\u5bf9\u8c61\u5b9e\u4f8b\u5316","text":"<p>\u8fd9\u4e00\u6b65\u5f88\u7b80\u5355, \u4e3a\u4e86\u5b9e\u4f8b\u5316\u4e00\u4e2a\u5bf9\u8c61, \u6211\u4eec\u9700\u8981\u4f7f\u7528 <code>newobj</code> \u64cd\u4f5c\u7b26, \u5176\u53c2\u6570\u4e3a\u5bf9\u5e94\u5bf9\u8c61\u7684\u4e00\u4e2a\u6784\u9020\u5668, \u8be5\u6307\u4ee4\u6267\u884c\u540e\u4f1a\u5c06\u6211\u4eec\u8981\u7684\u5bf9\u8c61\u538b\u5165\u8bc4\u4f30\u6808, \u6bd4\u5982\u5982\u4e0b <code>C#</code> \u4ee3\u7801:</p> <pre><code>new StringBuilder();\n</code></pre> <p>\u6211\u4eec\u9700\u8981\u8fd9\u6837\u751f\u6210\u5b83\u7684 <code>IL</code>:</p> <pre><code>var sbctor = typeof(StringBuilder).GetConstructor(Type.EmptyTypes)!;\nil.Emit(OpCodes.Newobj, sbctor);\n</code></pre>"},{"location":"trans/il/#_7","title":"\u6210\u5458\u65b9\u6cd5\u7684\u8c03\u7528","text":"<p>\u73b0\u5728, \u6211\u4eec\u5728\u8bc4\u4f30\u6808\u4e0a\u6709\u4e86\u4e00\u4e2a\u5bf9\u8c61, \u6211\u4eec\u5c31\u53ef\u4ee5\u7528\u5b83\u8c03\u7528\u5b83\u7684\u6210\u5458\u65b9\u6cd5\u4e86. \u6210\u5458\u65b9\u6cd5\u7684\u8c03\u7528\u4e0e\u9759\u6001\u65b9\u6cd5\u8c03\u7528\u57fa\u672c\u4e00\u81f4, \u4f46\u662f\u6bcf\u6b21\u8c03\u7528\u4e4b\u524d\u6211\u4eec\u90fd\u5fc5\u987b\u8bb0\u5f97\u5c06 <code>this</code> \u7684\u503c\u4f5c\u4e3a\u7b2c0\u4e2a\u53c2\u6570\u538b\u5165\u5806\u6808, \u987a\u4fbf, \u8bb0\u4f4f\u8fd9\u91cc\u7684 <code>this</code> \u662f\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u7684, \u6bcf\u6b21\u8c03\u7528\u90fd\u4f1a\u88ab\u5f39\u51fa\u8bc4\u4f30\u6808, \u6240\u4ee5\u5728\u8fde\u7eed\u8c03\u7528\u5b83\u7684\u6210\u5458\u65b9\u6cd5\u65f6\u8bb0\u5f97\u5c06 <code>this</code> \u518d\u6b21\u538b\u5165. \u901a\u5e38\u6211\u4eec\u4f1a\u4f7f\u7528 <code>callvirt</code> \u6765\u8c03\u7528\u6210\u5458\u65b9\u6cd5, \u4e00\u65b9\u9762\u4e3a\u4e86\u786e\u4fdd\u8c03\u7528\u5230\u4e86\u91cd\u5199\u540e\u7684\u865a\u51fd\u6570, \u4e00\u65b9\u9762\u4e3a\u4e86\u5c3d\u53ef\u80fd\u65e9\u7684\u68c0\u6d4b\u51fa <code>this</code> \u4e3a null.</p> <pre><code>Console.WriteLine(new StringBuilder().Append(\"abc\").Append(\"def\").Append(\"ghi\").ToString());\n</code></pre> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar sbctor = typeof(StringBuilder).GetConstructor(Type.EmptyTypes)!;\nvar appendMethod = typeof(StringBuilder).GetMethod(\"Append\", new Type[] { typeof(string) })!;\nvar toStringMethod = typeof(StringBuilder).GetMethod(\"ToString\", Type.EmptyTypes)!;\n// StringBuilder.Append \u65b9\u6cd5\u4f1a\u8fd4\u56de\u81ea\u8eab, \u6240\u4ee5\u8fd9\u91cc\u7684 `this` \u5728\u65b9\u6cd5\u88ab\u8c03\u7528\u540e\u53c8\u88ab\u5f39\u51fa\u53c8\u88ab\u538b\u5165\nil.Emit(OpCodes.Newobj, sbctor);\nil.Emit(OpCodes.Ldstr, \"abc\");\nil.Emit(OpCodes.Callvirt, appendMethod);\nil.Emit(OpCodes.Ldstr, \"def\");\nil.Emit(OpCodes.Callvirt, appendMethod);\nil.Emit(OpCodes.Ldstr, \"ghi\");\nil.Emit(OpCodes.Callvirt, appendMethod);\nil.Emit(OpCodes.Callvirt, toStringMethod);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u4f46\u662f\u5b9e\u9645\u4e0a, \u6211\u4eec\u660e\u786e\u77e5\u9053 <code>StringBuilder</code> \u662f\u5bc6\u5c01\u7684, \u6ca1\u4eba\u4f1a\u91cd\u5199\u5b83\u7684\u865a\u65b9\u6cd5, \u4ee5\u53ca\u8fd9\u91cc\u6211\u4eec\u660e\u786e\u77e5\u9053\u8fd9\u91cc\u7684 <code>this</code> \u4e0d\u4e3a null, \u6240\u4ee5\u5b9e\u9645\u4e0a\u4e0a\u9762\u7684 <code>callvirt</code> \u90fd\u80fd\u6362\u6210 <code>call</code>:</p> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar sbctor = typeof(StringBuilder).GetConstructor(Type.EmptyTypes)!;\nvar appendMethod = typeof(StringBuilder).GetMethod(\"Append\", new Type[] { typeof(string) })!;\nvar toStringMethod = typeof(StringBuilder).GetMethod(\"ToString\", Type.EmptyTypes)!;\n// StringBuilder.Append \u65b9\u6cd5\u4f1a\u8fd4\u56de\u81ea\u8eab, \u6240\u4ee5\u8fd9\u91cc\u7684 `this` \u5728\u65b9\u6cd5\u88ab\u8c03\u7528\u540e\u53c8\u88ab\u5f39\u51fa\u53c8\u88ab\u538b\u5165\nil.Emit(OpCodes.Newobj, sbctor);\nil.Emit(OpCodes.Ldstr, \"abc\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Ldstr, \"def\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Ldstr, \"ghi\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Call, toStringMethod);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre>"},{"location":"trans/il/#_8","title":"\u5c40\u90e8\u53d8\u91cf","text":"<p>\u4e5f\u8bb8\u4f60\u4e5f\u53d1\u73b0\u4e86, \u6211\u4eec\u4e0a\u9762\u7684\u4ee3\u7801\u90fd\u6709\u4e9b\"\u618b\u5c48\", \u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u5728\u4e0a\u9762\u7684\u4ee3\u7801\u4e2d\u6ca1\u6709\u7528\u5230\u5c40\u90e8\u53d8\u91cf. \u5728 <code>System.Reflection.Emit</code> \u4e2d, \u6211\u4eec\u5fc5\u987b\u663e\u5f0f\u6307\u5b9a\u6211\u4eec\u53ef\u80fd\u7528\u5230\u51e0\u4e2a\u5c40\u90e8\u53d8\u91cf\u4ee5\u53ca\u5bf9\u5e94\u7684\u7c7b\u578b, \u6bd4\u5982\u5982\u4e0b C# \u4ee3\u7801: <pre><code>StringBuilder sb = new();\nsb.Append(\"abc\");\nsb.Append(\"def\");\nsb.Append(\"ghi\");\nstring str = sb.ToString();\nConsole.WriteLine(str);\n</code></pre></p> <p>\u6211\u4eec\u8fdb\u884c\u5206\u6790, \u53d1\u73b0\u5b83\u4f7f\u7528\u4e86\u4e24\u4e2a\u5c40\u90e8\u53d8\u91cf: <code>sb</code> \u548c <code>str</code>, \u6240\u4ee5\u6211\u4eec\u5728\u8c03\u7528 <code>il.Emit</code> \u4e4b\u524d\u8c03\u7528 <code>il.DeclareLocal</code>:</p> <pre><code>il.DeclareLocal(typeof(StringBuilder)); // 0\nil.DeclareLocal(typeof(string)); // 1\n</code></pre> <p>\u6ce8\u610f\u6211\u4eec\u8c03\u7528 <code>DeclareLocal</code> \u7684\u987a\u5e8f, \u8fd9\u4e2a\u987a\u5e8f\u6211\u4eec\u5728\u4e0b\u9762\u7684 <code>IL</code> \u4e2d\u5c31\u4f1a\u4f7f\u7528\u5b83:</p> \u54e6\u5929\u54ea\u5b83\u771f\u7684\u592a\u957f\u4e86<pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar sbctor = typeof(StringBuilder).GetConstructor(Type.EmptyTypes)!;\nvar appendMethod = typeof(StringBuilder).GetMethod(\"Append\", new Type[] { typeof(string) })!;\nvar toStringMethod = typeof(StringBuilder).GetMethod(\"ToString\", Type.EmptyTypes)!;\n\nil.DeclareLocal(typeof(StringBuilder)); // 0\nil.DeclareLocal(typeof(string)); // 1\n\nil.Emit(OpCodes.Newobj, sbctor);\n// \u5c06\u6211\u4eec\u7684 StringBuilder \u5bf9\u8c61\u5b58\u5230 0 \u53f7\u4f4d\u7684\u5c40\u90e8\u53d8\u91cf\u4e0a\nil.Emit(OpCodes.Stloc_0); \n// \u628a\u6211\u4eec\u4e4b\u524d\u5728 0 \u53f7\u4f4d\u5c40\u90e8\u53d8\u91cf\u4e0a\u5b58\u7684 StringBuilder \u5bf9\u8c61\u8bfb\u53d6\u51fa\u6765\u5e76\u538b\u5165\u8bc4\u4f30\u6808\u4e0a\nil.Emit(OpCodes.Ldloc_0); \n// \u51c6\u5907 StringBuilder.Append \u7684\u90a3\u4e2a\u53c2\u6570\u4f5c\u4e3a\u5176\u5185\u90e8 ldarg.1 \u4f1a\u8bfb\u53d6\u7684\u503c(ldarg.0 \u662f this)\nil.Emit(OpCodes.Ldstr, \"abc\");\nil.Emit(OpCodes.Call, appendMethod);\n// \u6211\u4eec\u5728\u8fd9\u91cc\u4e0d\u4f1a\u4f7f\u7528 StringBuilder.Append \u7684\u90a3\u4e2a\u7528\u4e8e\u94fe\u5f0f\u8c03\u7528\u7684\u8fd4\u56de\u503c\n// \u6240\u4ee5\u6211\u4eec\u4f7f\u7528 `pop` \u5f39\u51fa\u5b83\u907f\u514d\"\u6c61\u67d3\"\u6211\u4eec\u7684\u8bc4\u4f30\u6808.\nil.Emit(OpCodes.Pop);\nil.Emit(OpCodes.Ldloc_0);\nil.Emit(OpCodes.Ldstr, \"def\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\nil.Emit(OpCodes.Ldloc_0);\nil.Emit(OpCodes.Ldstr, \"ghi\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\nil.Emit(OpCodes.Ldloc_0);\nil.Emit(OpCodes.Call, toStringMethod);\nil.Emit(OpCodes.Stloc_1);\nil.Emit(OpCodes.Ldloc_1);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u5728\u4e0a\u9762\u7684 <code>IL</code> \u4e2d, <code>stloc.0</code> \u5c06\u6808\u9876\u7684\u503c\u5f39\u51fa\u5e76\u5b58\u5230\u5c40\u90e8\u53d8\u91cf 0 \u53f7\u4f4d\u4e0a, <code>ldloc.0</code> \u8bfb\u53d6\u5c40\u90e8\u53d8\u91cf 0 \u53f7\u4f4d\u7684\u503c\u7136\u540e\u5c06\u5176\u538b\u5165\u8bc4\u4f30\u6808\u4e0a. \u4e0d\u8fc7\u5b9e\u9645\u4e0a\u8fd9\u91cc\u7528\u4e0d\u7740\u5c40\u90e8\u53d8\u91cf, \u9664\u4e86\u4f7f\u7528 <code>Append</code> \u8fd4\u56de\u7684 <code>this</code> \u4e4b\u5916, \u6211\u4eec\u8fd8\u53ef\u4ee5\u4f7f\u7528 <code>dup</code> \u6307\u4ee4\u6765\u7b80\u5316\u5927\u91cf\u7684 <code>ldloc.0</code> \u64cd\u4f5c. \u9664\u6b64\u4e4b\u5916 <code>string</code> \u90a3\u4e2a\u5c40\u90e8\u53d8\u91cf\u4e5f\u7528\u4e0d\u7740, \u6211\u4eec\u5728 <code>ToString</code> \u540e\u76f4\u63a5\u8c03\u7528 <code>Console.WriteLine</code> \u5373\u53ef, \u56e0\u4e3a\u8fd9\u65f6\u7684 <code>string</code> \u521a\u597d\u5c31\u5728\u6808\u9876.</p> <pre><code>il.Emit(OpCodes.Newobj, sbctor);\n\nil.Emit(OpCodes.Dup);\nil.Emit(OpCodes.Ldstr, \"abc\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\n\nil.Emit(OpCodes.Dup);\nil.Emit(OpCodes.Ldstr, \"def\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\n\nil.Emit(OpCodes.Dup);\nil.Emit(OpCodes.Ldstr, \"ghi\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\n\nil.Emit(OpCodes.Dup);\nil.Emit(OpCodes.Call, toStringMethod);\nil.Emit(OpCodes.Call, cw);\n\n// \u8bb0\u5f97\u5f39\u51fa\u6700\u521d newobj \u6307\u4ee4\u538b\u5165\u7684\u90a3\u4e2a\u5143\u7d20, \u5426\u5219\u6b64\u65f6 ret \u6808\u5c31\u4e0d\u662f\u7a7a\u7684\u4e86\n// \u8fd9\u4f1a\u5bfc\u81f4 jit \u629b\u51fa InvalidProgramException\nil.Emit(OpCodes.Pop);\n\nil.Emit(OpCodes.Ret);\n</code></pre> <p><code>dup</code> \u6307\u4ee4\u5f39\u51fa\u6808\u9876\u7684\u5143\u7d20, \u7136\u540e\u538b\u5165\u4e24\u904d\u8fd9\u4e2a\u5143\u7d20, \u4e5f\u5c31\u662f\u5b83\u4f1a\u590d\u5236\u6808\u9876\u7684\u5143\u7d20\u4e00\u904d\u5e76\u538b\u5165, \u5728\u8fd9\u91cc,  \u6211\u4eec\u4f7f\u7528 <code>dup</code> \u6307\u4ee4\u5728\u6bcf\u6b21\u9700\u8981 <code>this</code> \u5bf9\u8c61\u65f6\u590d\u5236\u6700\u521d <code>newobj</code> \u6307\u4ee4\u538b\u5165\u7684\u5143\u7d20, \u8fd9\u6837\u5c31\u65e0\u9700\u4f7f\u7528\u5c40\u90e8\u53d8\u91cf\u800c\u590d\u6742\u5316\u6211\u4eec\u7684 <code>IL</code> \u4e86.</p>"},{"location":"trans/il/#_9","title":"\u5c5e\u6027\u7684\u8bbf\u95ee","text":"<p>\u5728 <code>IL</code> \u4e2d, \u5176\u5b9e\u6ca1\u6709\u4e00\u6761\u6307\u4ee4\u662f\u5173\u4e8e\u5c5e\u6027\u7684, \u56e0\u4e3a\u6211\u4eec\u77e5\u9053\u5c5e\u6027\u5b9e\u9645\u4e0a\u5c31\u662f\u4e00\u5bf9 getter \u548c setter \u800c\u5df2. \u901a\u5e38, \u4e00\u4e2a\u540d\u4e3a <code>MyProp</code> \u7684\u5c5e\u6027\u7684 getter \u65b9\u6cd5\u53eb\u505a <code>get_MyProp</code>, setter \u65b9\u6cd5\u53eb\u505a <code>set_MyProp</code>, \u5982\u679c\u4f60\u5728 C# \u4e2d\u5c1d\u8bd5\u7ed9\u65b9\u6cd5\u8fd9\u6837\u8d77\u540d\u4f60\u4f1a\u53d1\u73b0\u7f16\u8bd1\u5668\u4f1a\u4e3a\u4e86\u9632\u6b62\u65b9\u6cd5\u91cd\u540d\u800c\u62a5\u9519, \u987a\u4fbf, \u8fd9\u4e00\u5bf9\u65b9\u6cd5\u5b83\u4eec\u5404\u81ea\u90fd\u6709\u4e00\u4e2a <code>special name</code> \u7684\u7279\u6b8a\u6807\u8bb0\u4ee5\u4fbf\u7f16\u8bd1\u5668\u77e5\u6653\u5b83\u4eec\u5f52\u5c5e\u4e8e\u4e00\u4e2a\u5c5e\u6027.  </p> <p>\u6bd4\u5982\u5982\u4e0b <code>C#</code> \u4ee3\u7801:</p> <pre><code>Console.WriteLine(\"123\".Length);\n</code></pre> <pre><code>var cwInt = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(int) })!;\nvar stringGetLength = typeof(string).GetMethod(\"get_Length\")!;\nil.Emit(OpCodes.Ldstr, \"123\");\nil.Emit(OpCodes.Call, stringGetLength);\nil.Emit(OpCodes.Call, cwInt);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u5728\u8fd9\u91cc\u6211\u4eec\u8c03\u7528\u7684\u5c31\u662f <code>string</code> \u7684 <code>get_Length</code> \u65b9\u6cd5. \u5c31\u662f\u8fd9\u4e48\u7b80\u5355.</p>"},{"location":"trans/il/#_10","title":"\u5b57\u6bb5\u7684\u8bbf\u95ee","text":"<p>\u5bf9\u4e8e\u9759\u6001\u5b57\u6bb5\u7684\u8bbf\u95ee, \u6211\u4eec\u9700\u8981\u4f7f\u7528 <code>ldsfld</code> \u64cd\u4f5c\u7b26, \u6bd4\u5982 <code>Path.DirectorySeparatorChar</code> \u8fd9\u4e2a\u9759\u6001\u5b57\u6bb5: <pre><code>Console.WriteLine(Path.DirectorySeparatorChar);\n</code></pre></p> <pre><code>// \u6ce8\u610f\u4e0b\u8fd9\u91cc WriteLine \u7684\u91cd\u8f7d\u6362\u4e86, \u56e0\u4e3a Path.DirectorySeparatorChar \u662f char \u7c7b\u578b\u7684\nvar cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(char) })!;\nvar pathStfld = typeof(Path).GetField(\"DirectorySeparatorChar\")!;\nil.Emit(OpCodes.Ldsfld, pathStfld);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p><code>ldsfld</code> \u4f1a\u5c06\u53c2\u6570\u4e2d\u7684\u9759\u6001\u5b57\u6bb5\u7684 token \u5bf9\u5e94\u7684\u9759\u6001\u5b57\u6bb5\u7684\u503c\u538b\u5165\u8bc4\u4f30\u6808\u4e0a.</p> <p>\u5bf9\u4e8e\u6210\u5458\u5b57\u6bb5\u7684\u8bbf\u95ee\u4e5f\u662f\u7c7b\u4f3c\u7684, \u4e0d\u8fc7\u5b83\u4f1a\u9700\u8981\u5f39\u51fa\u4e00\u4e2a <code>this</code> \u5143\u7d20, \u6bd4\u5982\u5bf9\u4e8e\u5982\u4e0b C# \u7c7b:  </p> <p><sub>\u5176\u5b9e\u662f\u627e\u4e0d\u5230\u00a0bcl\u00a0\u91cc\u7ecf\u5e38\u8bbf\u95ee\u6210\u5458\u5b57\u6bb5\u7684\u4f8b\u5b50\u624d\u88ab\u8feb\u58f0\u660e\u65b0\u7c7b\u7684</sub></p> <pre><code>public class SomeClass\n{\n    public string SomeString;\n    public SomeClass()\n        =&gt; SomeString = \"\u8fd9\u91cc\u662f\u4e00\u4e2a\u5b57\u7b26\u4e32!\";\n}\n</code></pre> <pre><code>var someClassCtor = typeof(SomeClass).GetConstructor(Type.EmptyTypes)!;\nvar cwString = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar someClassFld = typeof(SomeClass).GetField(\"SomeString\")!;\nil.Emit(OpCodes.Newobj, someClassCtor);\nil.Emit(OpCodes.Ldfld, someClassFld);\nil.Emit(OpCodes.Call, cwString);\nil.Emit(OpCodes.Ret);\n</code></pre>"},{"location":"trans/il/#_11","title":"\u8df3\u8f6c\u6307\u4ee4","text":"<p>\u5728\u8fd9\u91cc\u6211\u4eec\u4f1a\u4ecb\u7ecd\u8fd9\u4e00\u8282\u7684\u6700\u540e\u4e00\u4e2a\u4e1c\u897f \u2014\u2014 \u8df3\u8f6c\u6307\u4ee4. \u5b83\u662f C# \u4e2d <code>if</code> <code>switch</code> <code>for</code> <code>while</code> <code>goto</code> \u7b49\u6d41\u7a0b\u63a7\u5236\u8bed\u53e5\u90fd\u5341\u5206\u4f9d\u8d56\u7684\u4e1c\u897f.  </p> <p>\u5728 <code>IL</code> \u4e2d, \u4e3a\u4e86\u65b9\u4fbf \u5927\u4e8e, \u5c0f\u4e8e, \u5927\u4e8e\u7b49\u4e8e, \u5c0f\u4e8e\u7b49\u4e8e, \u662f\u5426 null, \u662f\u5426\u975e0 \u7b49\u4f17\u591a\u6761\u4ef6\u8868\u8fbe\u5f0f\u7684\u5224\u65ad, <code>IL</code> \u5f15\u5165\u4e86\u5927\u91cf\u6709\u5173\u7684\u6307\u4ee4, \u5177\u4f53\u5982\u4e0b\u8868(\u6458\u81ea MSDN):</p> \u6307\u4ee4 \u63cf\u8ff0 beq\u00a0\u00a0\u00a0 \u5982\u679c\u4e24\u4e2a\u503c\u76f8\u7b49\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 beq.s\u00a0\u00a0 \u5982\u679c\u4e24\u4e2a\u503c\u76f8\u7b49\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bge\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bge.s\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bge.un\u00a0\u00a0\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bge.un.s\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bgt\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bgt.s\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bgt.un\u00a0\u00a0\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bgt.un.s\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 ble\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 ble.s\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 ble.un\u00a0\u00a0\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 ble.un.s\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u6743\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 blt\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 blt.s\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 blt.un\u00a0\u00a0\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 blt.un.s\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bne.un\u00a0\u00a0\u00a0 \u5f53\u4e24\u4e2a\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u4e0d\u76f8\u7b49\u65f6\uff0c\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bne.un.s\u00a0 \u5f53\u4e24\u4e2a\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u4e0d\u76f8\u7b49\u65f6\uff0c\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 br\u00a0\u00a0\u00a0\u00a0 \u65e0\u6761\u4ef6\u5730\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 br.s\u00a0\u00a0\u00a0\u00a0 \u65e0\u6761\u4ef6\u5730\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 brfalse\u00a0\u00a0 \u5982\u679c value \u4e3a false\u3001\u7a7a\u5f15\u7528\uff08Visual Basic \u4e2d\u7684 Nothing\uff09\u6216\u96f6\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 brfalse.s \u5982\u679c value \u4e3a false\u3001\u7a7a\u5f15\u7528\u6216\u96f6\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 brtrue\u00a0\u00a0\u00a0 \u5982\u679c value \u4e3a true\u3001\u975e\u7a7a\u6216\u975e\u96f6\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 brtrue.s\u00a0 \u5982\u679c value \u4e3a true\u3001\u975e\u7a7a\u6216\u975e\u96f6\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 <p>\u53ef\u4ee5\u53d1\u73b0, \u57fa\u672c\u90fd\u662f\u5404\u79cd\u5927\u4e8e\u5c0f\u4e8e\u7b49\u4e8e\u975e\u7a7a\u975e0\u7b49\u4ee5\u53ca\u6709\u7b26\u53f7\u65e0\u7b26\u53f7\u8fd9\u4e9b\u60c5\u51b5\u7684\u6392\u5217\u7ec4\u5408. \u4e0a\u8868\u4e2d\u6211\u4eec\u79f0\u9664\u4e86 <code>br</code> \u4e0e <code>br.s</code> \u6307\u4ee4\u5916\u7684\u6307\u4ee4\u4e3a \"\u6761\u4ef6\u8df3\u8f6c\u6307\u4ee4\", \u53cd\u4e4b\u6211\u4eec\u79f0\u4e3a \"\u65e0\u6761\u4ef6\u8df3\u8f6c\u6307\u4ee4\". \u8fd9\u91cc\u6211\u4eec\u53ea\u4f1a\u7b80\u5355\u4e3e\u4f8b <code>br</code> <code>brfalse</code> \u8fd9\u4e24\u4e2a\u6307\u4ee4\u7684\u4f7f\u7528. \u5176\u4ed6\u6307\u4ee4\u57fa\u672c\u53ea\u662f\u51e0\u4e2a\u6761\u4ef6\u4e0d\u540c\u7c7b\u578b\u4e0d\u540c\u7684\u5dee\u522b.</p> <p><code>brfalse</code> \u6307\u4ee4\u4f1a\u4ece\u8bc4\u4f30\u6808\u4e0a\u5f39\u51fa\u4e00\u4e2a\u503c, \u7136\u540e\u67e5\u770b\u8be5\u503c\u662f\u5426\u4e3a <code>false</code> \u6216\u8005 <code>null</code> \u6216\u8005 <code>0</code>, \u5982\u679c\u662f\u5219\u8df3\u8f6c\u5230\u53c2\u6570\u6240\u6307\u7684\u76ee\u6807\u4f4d\u7f6e, \u5426\u5219\u4e0d\u505a\u4efb\u4f55\u4e8b. \u6bd4\u5982\u5982\u4e0b C# \u4ee3\u7801:</p> <pre><code>public static void MyMethod(int value)\n{\n    if (value == 0)\n    {\n        Console.WriteLine(\"value is 0!\");\n    }\n    else\n    {\n        Console.WriteLine(\"value is not 0.\");\n    }\n}\n</code></pre> <p>\u987a\u4fbf\u8bb0\u5f97\u66f4\u6539\u6211\u4eec\u7684\u65b9\u6cd5\u5b9a\u4e49:</p> <pre><code>public static MethodInfo GenerateMethod(Action&lt;ILGenerator&gt; generateAction)\n{\n    AssemblyBuilder asmBuilder = AssemblyBuilder.DefineDynamicAssembly(new(\"MyAssembly\"), AssemblyBuilderAccess.RunAndCollect);\n    ModuleBuilder moduleBuilder = asmBuilder.DefineDynamicModule(\"MyTestModule\");\n    TypeBuilder typeBuilder = moduleBuilder.DefineType(\"MyType\");\n    MethodBuilder methodBuilder = typeBuilder.DefineMethod(\"MyMethod\", MethodAttributes.Public | MethodAttributes.Static\n        , typeof(void), new Type[] { typeof(int) });\n    generateAction(methodBuilder.GetILGenerator());\n    return typeBuilder.CreateType().GetMethod(\"MyMethod\")!;\n}\n\npublic static void Main()\n{\n    MethodInfo methodInfo = GenerateMethod(il =&gt;\n    {\n        // TODO implement the IL body\n    });\n    var action = methodInfo.CreateDelegate&lt;Action&lt;int&gt;&gt;();\n    action(1);\n}\n</code></pre> <p>\u5176\u5bf9\u5e94 <code>IL</code> \u4e3a:</p> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar valueIs0Target = il.DefineLabel();\nil.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Brfalse, valueIs0Target);\nil.Emit(OpCodes.Ldstr, \"value is not 0.\");\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\nil.MarkLabel(valueIs0Target);\nil.Emit(OpCodes.Ldstr, \"value is 0!\");\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u5728\u8fd9\u91cc, \u5728\u4f7f\u7528 <code>System.Reflection.Emit</code> \u5e93\u7684\u60c5\u51b5\u4e0b, \u6211\u4eec\u5728\u4ee3\u7801\u7684\u7b2c 2 \u884c\u5b9a\u4e49\u4e86\u4e00\u4e2a Label, \u7528\u6765\u4e4b\u540e\u4f5c\u4e3a\u6761\u4ef6\u8df3\u8f6c\u6307\u4ee4\u7684\u53c2\u6570\u4f20\u5165, \u4e0d\u8fc7\u76ee\u524d\u8fd9\u4e2a Label \u6ca1\u6709\u6307\u5411\u4efb\u4f55 <code>IL</code> \u6307\u4ee4\u4f4d\u7f6e, \u6240\u4ee5\u6211\u4eec\u5728\u7b2c 8 \u884c\u8c03\u7528 <code>MarkLabel</code> \u65b9\u6cd5, \u8c03\u7528\u5b8c\u8be5\u65b9\u6cd5\u540e\u7684\u4e0b\u4e00\u6b21 <code>Emit</code> \u7684 <code>IL</code> \u6307\u4ee4\u7684\u4f4d\u7f6e\u4fe1\u606f\u5c31\u4f1a\u88ab\u8bbe\u7f6e\u5230 Label \u4e2d, \u89c2\u5bdf\u4e0a\u8ff0\u4ee3\u7801\u4e0d\u96be\u53d1\u73b0, \u6211\u4eec\u8bfb\u53d6\u7684\u7b2c\u4e00\u4e2a\u53c2\u6570, \u5982\u679c\u4e3a 0 \u90a3\u4e48\u8df3\u8f6c\u5230\u8f93\u51fa <code>value is 0!</code> \u7684 <code>IL</code> \u6307\u4ee4\u6bb5\u524d, \u800c\u5f53\u975e 0 \u65f6\u4e0d\u505a\u4efb\u4f55\u4e8b\u8ba9\u5176\u81ea\u7136\u6267\u884c\u5230\u8f93\u51fa <code>value is not 0.</code> \u7684 <code>IL</code> \u6307\u4ee4\u6bb5\u524d, \u4f60\u53ef\u4ee5\u66f4\u6539\u8c03\u7528\u8fd9\u4e2a\u65b9\u6cd5\u7684\u4ee3\u7801\u7684\u5730\u65b9\u4f20\u5165\u7684\u53c2\u6570\u6765\u89c2\u5bdf\u5b83\u7684\u8f93\u51fa(\u6bd4\u5982\u5c06 <code>action(1)</code> \u6539\u4e3a <code>action(0)</code>). \u987a\u4fbf, \u5728\u8fd9\u4e2a\u6307\u4ee4\u6bb5\u540e\u9762\u7d27\u8ddf\u4e00\u4e2a <code>ret</code> \u6307\u4ee4\u76f4\u63a5\u8fd4\u56de\u8be5\u65b9\u6cd5\u9632\u6b62\u8bef\u6267\u884c\u5230\u540e\u9762\u7684 <code>IL</code> \u6bb5. \u4e0d\u8fc7\u8fd9\u53ea\u5728\u540e\u9762\u6ca1\u6709\u4ee3\u7801\u9700\u8981\u6267\u884c\u7684\u60c5\u51b5\u4e0b\u594f\u6548,  \u5982\u679c\u540e\u9762\u4f9d\u7136\u6709\u4ee3\u7801\u7684\u8bdd\u6211\u4eec\u5c31\u5f97\u4f7f\u7528 <code>br</code> \u6307\u4ee4\u4e86.</p> <p><code>br</code> \u6307\u4ee4\u6267\u884c\u540e\u4f1a\u5c06\u76ee\u524d\u7684\u6267\u884c\u4f4d\u7f6e\u65e0\u6761\u4ef6\u7684\u8df3\u8f6c\u5230\u5bf9\u5e94\u4f4d\u7f6e, \u6bd4\u5982\u521a\u624d\u4ecb\u7ecd <code>brfalse</code> \u6307\u4ee4\u672b\u5c3e\u7684\u4e00\u70b9\u5c0f\u95ee\u9898, \u5373\u6bd4\u5982\u5982\u4e0b C# \u4ee3\u7801:</p> <pre><code>if (value == 0)\n{\n    Console.WriteLine(\"value is 0!\");\n}\nelse\n{\n    Console.WriteLine(\"value is not 0.\");\n}\nConsole.WriteLine(\"always execute me!\");\n</code></pre> <p>\u5728\u672b\u5c3e\u6211\u4eec\u6709\u4e00\u4e2a\u65b9\u6cd5\u8c03\u7528\u662f\u65e0\u5173 <code>value</code> \u7684\u503c\u7684, \u4e4b\u524d\u7684\u4ee3\u7801\u6211\u4eec\u4e3a\u4e86\u9632\u6b62\u8bef\u6267\u884c <code>IL</code> \u6211\u4eec\u4f7f\u7528\u4e86 <code>ret</code> \u6307\u4ee4\u76f4\u63a5\u8fd4\u56de\u6574\u4e2a\u65b9\u6cd5, \u4f46\u662f\u73b0\u5728\u8fd9\u91cc\u6211\u4eec\u65e0\u6cd5\u8fd9\u4e48\u5e72, \u4e0d\u8fc7\u73b0\u5728\u6709 <code>br</code> \u6307\u4ee4\u53ef\u4ee5\u4f7f\u7528\u4e86:</p> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar valueIs0Target = il.DefineLabel();\nvar afterIfTarget = il.DefineLabel();\nil.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Brfalse, valueIs0Target);\nil.Emit(OpCodes.Ldstr, \"value is not 0.\");\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Br, afterIfTarget);\nil.MarkLabel(valueIs0Target);\nil.Emit(OpCodes.Ldstr, \"value is 0!\");\nil.Emit(OpCodes.Call, cw);\nil.MarkLabel(afterIfTarget);\nil.Emit(OpCodes.Ldstr, \"always execute me!\");\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre>"},{"location":"trans/il/#s","title":"<code>.s</code> \u7cfb\u6307\u4ee4","text":"<p>\u4f60\u53ef\u80fd\u53d1\u73b0\u4e86\u5c31\u662f\u4e00\u4e9b <code>IL</code> \u6307\u4ee4\u540c\u65f6\u8fd8\u6709\u4e00\u4e2a\u5e26 <code>.s</code> \u540e\u7f00\u7684\u7248\u672c, \u8fd9\u4e2a\u6211\u4eec\u4e00\u822c\u53eb\u5b83\u7684 \"\u77ed\u683c\u5f0f\" \u7248\u672c, \u53cd\u4e4b\u53eb \"\u957f\u683c\u5f0f\" \u7248\u672c, \u6bd4\u5982\u5c31\u521a\u624d\u7684 <code>br</code> \u5bf9\u5e94\u7684 <code>br.s</code>, \u901a\u5e38\u7c7b\u4f3c\u8fd9\u4e00\u5bf9 <code>IL</code> \u6307\u4ee4\u7684\u533a\u522b\u5c31\u662f <code>.s</code> \u7248\u672c\u7684\u53c2\u6570\u4f1a\u77ed\u4e00\u70b9, \u6bd4\u5982\u957f\u683c\u5f0f\u7248\u672c\u7684\u53c2\u6570\u957f\u5ea6\u662f 4 \u5b57\u8282, \u800c\u77ed\u683c\u5f0f\u7248\u672c\u7684\u53c2\u6570\u957f\u5ea6\u53ef\u80fd\u5c31\u662f 2 \u5b57\u8282, \u6ce8\u610f\u8fd9\u91cc\u4e0d\u662f\u8bf4\u7684\u662f\u538b\u5165\u8bc4\u4f30\u6808\u7684\u503c\u7684\u7c7b\u578b, \u957f\u77ed\u683c\u5f0f\u7248\u672c\u6240\u505a\u7684\u4e8b\u60c5\u662f\u5b8c\u5168\u4e00\u6837\u7684, \u53ea\u662f\u4f20\u53c2\u5141\u8bb8\u4f60\u7528\u77ed\u4e00\u70b9\u7684\u53c2\u6570. \u8fd9\u5176\u5b9e\u5c31\u662f\u4e00\u4e2a\u5bf9 <code>IL</code> \u6307\u4ee4\u7684\u5927\u5c0f\u4f18\u5316, \u7f16\u8bd1\u5668\u901a\u5e38\u5c31\u4f1a\u80fd\u7528 <code>.s</code> \u7248\u672c\u5c31\u7528 <code>.s</code> \u7248\u672c, \u5f53\u53c2\u6570\u9700\u6c42\u8d85\u8fc7\u77ed\u683c\u5f0f\u53c2\u6570\u8868\u8fbe\u8303\u56f4\u65f6\u624d\u4f1a\u4f7f\u7528\u957f\u683c\u5f0f, \u5bf9\u4e8e\u6211\u4eec\u7684\u8bdd\u5982\u679c\u4f60\u60f3\u5fae\u5fae\u7684\u4f18\u5316\u4e00\u4e0b\u4f60\u7684 <code>IL</code> \u7684\u5927\u5c0f\u7684\u8bdd, \u4f60\u53ef\u4ee5\u9009\u62e9\u5728\u53c2\u6570\u8303\u56f4\u591f\u7528\u7684\u60c5\u51b5\u4e0b\u4f7f\u7528 <code>.s</code> \u7248\u672c.</p>"},{"location":"trans/il/#_12","title":"\u7ed3\u5c3e","text":"<p>\u81f3\u6b64, \u4e00\u4e9b\u57fa\u672c\u7684 <code>IL</code> \u4f60\u5df2\u4e86\u89e3, \u6211\u4eec\u5728\u8fd9\u91cc\u4ecb\u7ecd\u7684 <code>IL</code> \u6307\u4ee4\u4e0d\u8fc7\u662f\u51b0\u5c71\u4e00\u89d2, \u8fd8\u6709\u5f88\u591a\u5176\u4ed6\u7684 <code>IL</code> \u6307\u4ee4\u6ca1\u6709\u4ecb\u7ecd, \u4e0d\u8fc7\u5b83\u4eec\u5927\u540c\u5c0f\u5f02, \u57fa\u672c\u90fd\u662f\u5bf9\u8bc4\u4f30\u6808\u7684\u5404\u79cd\u5404\u6837\u7684\u64cd\u4f5c, \u6211\u4eec\u53ea\u9700\u8981\u5728\u7528\u5230\u65f6\u6216\u8005\u5076\u5c14\u7ffb\u9605\u4e00\u4e0b <code>IL</code> \u6307\u4ee4\u8868\u5c31\u80fd\u4e86\u89e3. \u6b64\u5916, \u5728 dnSpy \u7684 <code>IL</code> \u4ee3\u7801\u7684\u89c6\u89d2\u65f6, \u70b9\u51fb <code>IL</code> \u64cd\u4f5c\u7b26\u7684\u540d\u79f0\u53ef\u4ee5\u5f88\u65b9\u4fbf\u5730\u8df3\u8f6c\u5230 msdn \u4e0a\u5bf9\u8fd9\u4e2a\u6307\u4ee4\u7684\u63cf\u8ff0. \u90a3\u4e48, \u5728\u4e86\u89e3\u4f7f\u7528 <code>System.Reflection.Emit</code> \u5e93\u540e, \u6211\u4eec\u5c31\u53ef\u4ee5\u4f7f\u7528 <code>Mono.Cecil</code> \u5728\u851a\u84dd\u4e2d\u66f4\u6539\u851a\u84dd\u7684\u7a0b\u5e8f\u96c6\u4e86.  </p> <p>\u4e00\u4e9b\u53ef\u80fd\u6709\u7528\u7684\u8d44\u6e90:</p> <ul> <li>OpCodes Fields - Microsoft Learn (https://learn.microsoft.com/...)</li> <li>\u7406\u89e3IL - Rorschach - \u77e5\u4e4e (https://zhuanlan.zhihu.com/...)</li> <li>IL\u6307\u4ee4\u8be6\u7ec6 - Zery - \u535a\u5ba2\u56ed (https://www.cnblogs.com/...)</li> </ul>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\u200b\\u3000\\-\u3001\u3002\uff0c\uff0e\uff1f\uff01\uff1b]+","pipeline":["stemmer"]},"docs":[{"location":"","title":"\u9996\u9875","text":"<p>\u672c\u7cfb\u5217\u6559\u7a0b\u4e3b\u8981\u5199\u81ea\u4e8e\u4e2a\u4eba\u5728\u5236\u4f5c\u851a\u84dd CodeMod \u7684\u4e00\u4e9b\u7ecf\u9a8c \u672c\u7f51\u7ad9\u5185\u5bb9\u5f00\u6e90\u5728: github.com/Saplonily/CelesteModTourial \u5341\u5206\u6b22\u8fce\u6765\u63d0 pr \u548c issue \u4ee5\u4fee\u590d\u5404\u79cd\u8bed\u6cd5\u9519\u8bef, \u7528\u8bcd\u9519\u8bef\u548c\u5185\u5bb9\u9519\u8bef\u4ee5\u53ca\u5efa\u8bae_(:\u0437\u300d\u2220)_  </p> <p>\u5927\u90e8\u5206\u6587\u7ae0\u53ef\u80fd\u4f1a\u5199\u7684\u4e0d\u660e\u4e0d\u767d\u4ee5\u81f3\u4e8e\u9700\u8981\u9891\u7e41\u4fee\u6539, \u5982\u679c\u4f60\u6709\u66f4\u597d\u7684\u4fee\u6539\u5efa\u8bae\u7684\u8bdd\u6b22\u8fce\u6765\u63d0 issue.  </p> <p>\u90a3\u4e48\u4e00\u5207\u5c31\u7eea, \u53ef\u4ee5\u5f00\u59cb\u9605\u8bfb \u5165\u95e8-\u7b2c\u4e00\u8282 \u4e86:</p> <p>\u5f00\u59cb - Celeste Everest MonoMod</p> <p>\u6700\u540e, \u611f\u8c22\u4e00\u4e9b\u4e3a\u672c\u6559\u7a0b\u8d21\u732e\u7684\u4eba:</p> <ul> <li>Apple Sheep - \u5728\u5199\u4f5c\u521d\u671f\u63d0\u4f9b\u4e86\u5927\u91cf\u4fee\u6539\u5efa\u8bae (Bilibili)</li> <li>\u591c\u8c37\u7d2b\u5e7d - \u4e3a\u914d\u7f6e\u73af\u5883\u8282\u63d0\u4f9b\u4e86\u4f7f\u7528\u6a21\u677f\u7684\u5efa\u8bae (Bilibili)</li> <li>\u7535\u7bb1 - \u5236\u4f5c\u4e86\u5305\u542b\u57fa\u7840 Loenn \u4f7f\u7528\u6559\u7a0b\u7684\u4f5c\u56fe\u6559\u7a0b (Bilibili)</li> </ul> <p>\u4ee5\u53ca\u6211\u81ea\u5df1 :D</p> <ul> <li>Saplonily (Bilibili, Outlook)</li> </ul> <p>\u8bf4\u8d77\u6765\u56fd\u5185\u7684 coder \u770b\u8d77\u6765\u771f\u7684\u597d\u5c11\u54ce, \u6240\u4ee5\u8bf4\u5199\u8fd9\u4e2a\u6559\u7a0b\u53ef\u4ee5\u8ba4\u4e3a\u662f\u6211\u4e0d\u60f3\u5199\u7801\u60f3\u63a8\u7ed9\u522b\u4eba((</p> <p>\u5728\u7f51\u7ad9\u4e2d\u7684\u4ee3\u7801\u5757\u4e2d\u7684\u4e00\u4e9b\u9ad8\u4eae\u5728\u6a2a\u5411\u6eda\u52a8\u65f6\u4f1a\u53d1\u751f\u622a\u65ad, \u5373\u9ad8\u4eae\u5e76\u6ca1\u6709\u8986\u76d6\u6574\u884c, \u8fd9\u4e2a\u662f <code>mkdocs-material</code> \u81ea\u8eab\u7684 bug, \u800c\u4e14\u770b\u4e0a\u53bb\u8bf4\u662f\u4fee\u590d\u8d77\u6765\u5f88\u56f0\u96be, issue \u94fe\u63a5: mkdocs-material issue #452.  </p> <p>bug \u4e8e\u4e0b: <pre><code>t11ntpj808mbc1gu4lx7n9d8tj5q3ck3t1c0aclc    Liquorice oat cake carrot cake. Halvah lemon drops bear claw fruitcake. Marshmallow danish jelly-o toffee.\njqlksiohper0brg9x2ajcm7ajjf8ptjxprqstvda    Apple pie cake jelly-o sugar plum.\nx3mjly0wn48wy7lgf2bfymbykommv8dbyp7an1n8    Toffee candy brownie carrot cake jujubes sweet roll chocolate gingerbread.\nq0b5pj6eacuwj3t1i4jv7yxf00mi6osc0h5etcfz    Cupcake tiramisu danish brownie danish jujubes gingerbread toffee gummi bears.\nu25qzla31ahqxd2x6b2wgpbxvw88h5w6mujoqtuq    Fruitcake jelly beans candy canes icing pastry liquorice. Bear claw tart chocolate sweet souffl\u00e9 sweet roll marshmallow ice cream liquorice.\n9xcjy4nvh1jinka64lkdr1nhagm8odp0frr56nks    Bear claw tootsie roll toffee biscuit cotton candy macaroon. \n5rmcwguz3jzws8w1hh2jbfdau74jip3f8rbu10oy    Pudding caramels carrot cake sweet roll danish oat cake.\ns50wqctf9059ets5ezp4oeq7p6pfr24ntww2d15v    Oat cake macaroon pastry cheesecake. Dessert topping chocolate bar. \nvue3y73jcwsg5um4pw8aqhuv3njgtg9iq0ortx5p    Sesame snaps candy canes muffin lollipop wafer. \n1o6edje4xcb7vtcvct4ghawafdvmvgkx4r0scny5    Macaroon pudding gingerbread. \n</code></pre></p> <p>\u672c\u7cfb\u5217\u5185\u5bb9\u4f9d\u636eCC BY-SA 4.0\u8bb8\u53ef\u8bc1\u8fdb\u884c\u6388\u6743</p>"},{"location":"arc/basic_env/","title":"\u57fa\u7840\u73af\u5883\u914d\u7f6e - \u65e7","text":""},{"location":"arc/basic_env/#_1","title":"\u9879\u76ee\u521b\u5efa","text":"<p>\u5728vs\u521b\u5efa\u9879\u76ee\u9875\u9762\u4e2d\u6211\u4eec\u9700\u8981\u9009\u62e9\u8fd9\u4e2a:  </p> <p> \u6ce8\u610f\u8981\u9009\u5e26 <code>.NET Framework</code> \u5b57\u6837\u7684, \u851a\u84dd\u7684\u5e95\u5c42\u6846\u67b6\u76f8\u5bf9\u4e8e\u76ee\u524d\u7684 <code>.NET</code> \u5df2\u7ecf\u5f88\u53e4\u8001\u4e86, \u6240\u4ee5\u53ef\u80fd\u4f1a\u88ab\u7a0d\u5fae\u7279\u6b8a\u70b9\u5bf9\u5f85(, \u4e4b\u540e\u5728\u4e3a\u9879\u76ee\u547d\u540d\u7684\u7a97\u53e3\u4e2d\u7684\u9879\u76ee\u6846\u67b6\u8bb0\u5f97\u7cbe\u786e\u9009\u62e9 <code>.NET Framework 4.5.2</code>.  </p> <p> \u5982\u679c\u4f60\u6ca1\u6709 <code>.NET Framework 4.5.2</code> \u7684\u9009\u9879\u8bf7\u68c0\u67e5\u662f\u5426\u5b89\u88c5\u4e86\u6b64\u6846\u67b6, \u5e76\u4e14\u4f60\u9009\u62e9\u7684\u662f\u5e26 <code>.NET Framework</code> \u5b57\u6837\u7684\u7c7b\u5e93\u9879\u76ee.</p> <p>\u5f53\u4f60\u521b\u5efa\u5b8c\u9879\u76ee\u540e, \u4f60\u4f1a\u5f97\u5230\u4e00\u4e2a\u4ee3\u7801\u6587\u4ef6 <code>Class1.cs</code>, \u5b83\u770b\u8d77\u6765\u50cf: Class1.cs<pre><code>using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace MyCelesteMod\n{\n    public class Class1\n    {\n\n    }\n}\n</code></pre></p>"},{"location":"arc/basic_env/#_2","title":"\u6dfb\u52a0\u5bf9\u851a\u84dd\u7684\u5f15\u7528","text":"<p>\u56e0\u4e3a\u6211\u4eec\u662f\u851a\u84dd mod \u561b, \u6240\u4ee5\u80af\u5b9a\u5f97\u4f9d\u8d56\u4e00\u4e9b\u851a\u84dd\u7684\u4e1c\u897f, \u5373\u4f9d\u8d56\u4e8e\u851a\u84dd\u7684\u7a0b\u5e8f\u96c6. \u5177\u4f53\u64cd\u4f5c\u6765\u8bf4:</p> <ul> <li>\u5728\u89e3\u51b3\u65b9\u6848\u89c6\u56fe\u7a97\u53e3\u4f60\u7684\u9879\u76ee\u4e0b\u7684<code>\u5f15\u7528</code>\u4e0a\u53f3\u51fb</li> <li>\u9009\u62e9<code>\u6dfb\u52a0\u5f15\u7528</code></li> <li>\u5728\u65b0\u7684\u7a97\u53e3\u9009\u62e9\u5de6\u4fa7\u7684<code>\u6d4f\u89c8</code></li> <li>\u70b9\u51fb\u7a97\u53e3\u53f3\u4e0b\u89d2\u7684<code>\u6d4f\u89c8</code> </li> <li>\u5b8c\u6210\u540e\u5728\u5f39\u51fa\u7684\u6587\u4ef6\u9009\u62e9\u6846\u4e2d\u9009\u62e9\u4ee5\u4e0b\u51e0\u4e2a\u5728\u851a\u84dd\u6839\u76ee\u5f55\u4e0b\u7684\u6587\u4ef6:<ul> <li><code>Celeste.exe</code></li> <li><code>FNA.dll</code></li> <li><code>MMHOOK_Celeste.dll</code></li> <li><code>YamlDotNet.dll</code></li> </ul> </li> </ul> <p>\u5bf9\u4e8e steam \u7248\u851a\u84dd\u7684\u76ee\u5f55\u901a\u5e38\u4f1a\u5728 <code>C:\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste</code></p> <p>\u53e6\u5916\u4e3a\u4e86\u4fdd\u8bc1\u4f60\u7684 mod \u7684\u8de8\u5e73\u53f0\u6027, \u4f60\u7684\u5f15\u7528\u5217\u8868\u91cc <code>System</code> \u5f00\u5934\u7684\u53ea\u80fd\u5305\u542b:</p> <ul> <li><code>System</code></li> <li><code>System.Configuration</code></li> <li><code>System.Core</code></li> <li><code>System.Data</code></li> <li><code>System.Drawing</code></li> <li><code>System.Runtime.Serialization</code></li> <li><code>System.Security</code></li> <li><code>System.Xml</code></li> <li><code>System.Xml.Linq</code></li> </ul> <p>\u5982\u679c\u4f60\u7684\u9879\u76ee\u5f15\u7528\u6709\u5176\u4ed6 <code>System</code> \u5f00\u5934\u7cfb\u5217\u7684\u5f15\u7528, \u5e76\u4e14\u5b83\u4eec\u4e0d\u5728\u4e0a\u8ff0\u5217\u8868\u4e0a, \u4f60\u9700\u8981\u5c06\u5176\u79fb\u9664(\u53f3\u952e-&gt;\u79fb\u9664).</p>"},{"location":"arc/basic_env/#module","title":"\u6dfb\u52a0 Module \u7c7b","text":"<p>ok\u5728\u6211\u4eec\u4e00\u756a\u6298\u817e\u4e0b\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u5f00\u59cb\u6765\u5199\u4ee3\u7801\u4e86, \u90a3\u4e48\u9996\u5148\u628a\u4f60\u7684 <code>Class1.cs</code> \u91cd\u547d\u540d\u6210 <code>(\u4f60\u7684mod\u540d)Module.cs</code>, \u6bd4\u5982\u8fd9\u91cc\u6211\u7684 mod \u540d\u53eb <code>MyCelesteMod</code>, \u90a3\u4e48\u8fd9\u4e2a\u6587\u4ef6\u6700\u597d\u53eb\u505a <code>MyCelesteModModule.cs</code>, \u8fd9\u662f\u4e3a\u4e86\u65b9\u4fbf\u65e5\u540e\u5f00\u53d1\u80fd\u4e00\u773c\u8bc6\u522b\u51fa\u8fd9\u662f\u6211\u4eec\u6700\u65e9\u671f\u521b\u5efa\u7684\u90a3\u4e2a\u5173\u952e\u7c7b.</p> <p>\u5982\u679c\u4f60\u7684 vs \u63d0\u793a\u4f60\u662f\u5426\u91cd\u547d\u540d\u6807\u8bc6\u7b26, \u4f60\u53ef\u4ee5\u9009\u662f, \u8fd9\u6837\u90a3\u4e2a\u6587\u4ef6\u91cc\u7684 <code>Class1</code> \u7c7b\u540d\u4e5f\u4f1a\u5e2e\u4f60\u91cd\u547d\u540d</p> <p>\u90a3\u4e48\u540c\u6837\u5730\u5bf9\u8fd9\u4e2a\u6587\u4ef6\u91cc\u7684\u7c7b\u7684\u540d\u5b57\u4e5f\u91cd\u547d\u540d, \u7136\u540e\u6211\u4eec\u8ba9\u8fd9\u4e2a\u7c7b\u7ee7\u627f\u4e8e <code>EverestModule</code>.</p> <p>\u5982\u679c\u51fa\u73b0\u4e86\u672a\u547d\u540d\u6807\u8bc6\u7b26\u7684\u9519\u8bef, \u8bf7\u68c0\u67e5\u4f60\u662f\u5426\u6b63\u786e\u5f15\u7528\u4e86 <code>Celeste.exe</code> \u5e76\u4e14 using \u4e86 <code>Celeste.Mod</code> \u547d\u540d\u7a7a\u95f4</p> <p><code>EverestModule</code> \u662f\u4e00\u4e2a\u62bd\u8c61\u7c7b ,\u90a3\u4e48\u73b0\u5728\u6211\u4eec\u9700\u8981\u52a0\u5165\u4e24\u4e2a\u65b9\u6cd5\u4ee5\u5b9e\u73b0\u5b83, \u540c\u65f6\u8ba9vs\u95ed\u5634. MyCelesteMod.cs<pre><code>public override void Load()\n{\n}\n\npublic override void Unload()\n{\n}\n</code></pre></p> <p><code>Load</code> \u65b9\u6cd5\u4f1a\u5728 Everest \u52a0\u8f7d\u4f60\u7684 Mod \u65f6\u88ab\u8c03\u7528 <code>Unload</code> \u65b9\u6cd5\u4f1a\u5728 Everest \u5378\u8f7d\u4f60\u7684 Mod \u65f6\u88ab\u8c03\u7528 \u5728\u8fd9\u91cc\u6211\u4eec\u4f1a\u5199\u4e2a\u7c7b\u4f3c Hello world \u7684\u4e1c\u897f, \u5373\u5728 <code>Load</code> \u91cc\u6253\u5370\u4e9b\u8bdd. em, \u53ef\u80fd\u4e0d\u662f\u4f60\u671f\u671b\u7684 <code>Console.WriteLine</code> \u800c\u662f <code>Logger.Log</code>, \u5c31\u50cf\u8fd9\u6837:</p> <pre><code>Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World! Hello Everest!\");\n</code></pre> <p>\u8fd9\u662f\u4e00\u4e2a\u851a\u84dd\u5e95\u5c42\u6846\u67b6 <code>Monocle</code> \u5f15\u64ce\u91cc\u7684\u4e00\u4e2a\u9759\u6001\u7c7b, \u5728\u4e4b\u540e\u6211\u4eec\u4f1a\u4ecb\u7ecd\u851a\u84dd\u4e2d\u5e38\u89c1\u7c7b\u7684\u4f7f\u7528. \u4e0b\u9762\u662f\u8fd9\u4e2a\u65b9\u6cd5\u7684\u53c2\u6570\u5217\u8868:</p> <ul> <li>\u7b2c\u4e00\u4e2a\u53c2\u6570: \u8fd9\u53e5\u65e5\u5fd7\u7684\u7b49\u7ea7, \u8fd9\u91cc\u6211\u4eec\u5148\u9009 <code>Info</code>.</li> <li>\u7b2c\u4e8c\u4e2a\u53c2\u6570: \u8fd9\u53e5\u65e5\u5fd7\u7684 <code>Tag</code>, \u901a\u5e38\u5b83\u662f\u4f60\u7684 Mod \u540d\u5b57</li> <li>\u7b2c\u4e09\u4e2a\u53c2\u6570: \u6211\u4eec\u5e0c\u671b\u8f93\u51fa\u7684\u8bdd</li> </ul> <p>\u90a3\u4e48\u4f60\u73b0\u5728\u7684\u4ee3\u7801\u5e94\u8be5\u662f\u5927\u6982\u8fd9\u6837\u5b50\u7684: MyCelesteMod.cs<pre><code>using Celeste.Mod;\nusing System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace MyCelesteMod\n{\n    public class MyModModule : EverestModule\n    {\n        public override void Load()\n        {\n            Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World! Hello Everest!\");\n        }\n\n        public override void Unload()\n        {\n\n        }\n    }\n}\n</code></pre></p> <p>\u73b0\u5728, \u6309\u4e0b <code>Ctrl + B</code>, vs \u5e94\u8be5\u4f1a\u542f\u52a8\u7f16\u8bd1.</p> <p>\u4f60\u4f1a\u9047\u5230\u4e00\u4e2a\u5173\u4e8e <code>x86</code> \u4e0e <code>AnyCpu</code> \u67b6\u6784\u4e0d\u7b26\u7684\u8b66\u544a, \u8fd9\u91cc\u6211\u4eec\u5148\u5ffd\u7565\u5b83\u5e76\u5728\u540e\u9762\u89e3\u51b3.</p> <p>\u7f16\u8bd1\u5b8c\u6210, \u6211\u4eec\u5c31\u53ef\u4ee5\u627e\u5230\u6211\u4eec\u7f16\u8bd1\u51fa\u6765\u7684\u65b0\u9c9c\u7684\u7a0b\u5e8f\u96c6: <code>&lt;\u4f60\u7684\u9879\u76ee\u540d&gt;/&lt;\u4f60\u7684\u9879\u76ee\u540d&gt;/bin/Debug/&lt;\u4f60\u7684\u9879\u76ee\u540d&gt;.dll</code>, \u4f60\u7684 vs \u7684\u8f93\u51fa\u7a97\u53e3\u4e5f\u5e94\u8be5\u4f1a\u5199\u4e0a\u8fd9\u4e2a dll \u7684\u5b8c\u6574\u8def\u5f84.</p>"},{"location":"arc/basic_env/#everest","title":"\u8ba9 Everest \u52a0\u8f7d","text":"<p>\u4ee5\u4e0a\u4e00\u987f\u64cd\u4f5c\u8fc7\u540e\u4f60\u4f1a\u53d1\u73b0\u4f60\u7684\u851a\u84dd\u4ec0\u4e48\u4e5f\u6ca1\u53d1\u751f(\u4e50). \u56e0\u4e3a\u6211\u4eec\u8fd8\u6ca1\u544a\u8bc9\u5b83\u8ba9\u5b83\u52a0\u8f7d\u6211\u4eec\u7684 mod! \u4e3a\u4e86\u8ba9 Everest \u52a0\u8f7d\u6211\u4eec\u7684 mod, \u5176\u4e2d\u4e00\u4e2a\u65b9\u6cd5\u5c31\u662f\u5728\u851a\u84dd\u7684 Mods \u6587\u4ef6\u5939\u91cc\u9762\u65b0\u5efa\u4e00\u4e2a\u6587\u4ef6\u5939, \u5e76\u653e\u5165\u6211\u4eec\u7684 mod \u6587\u4ef6, \u5b83\u7684\u540d\u5b57\u6211\u4eec\u6700\u597d\u5c31\u662f\u9879\u76ee\u540d\u5b57, \u6bd4\u5982 <code>MyCelesteMod</code>, \u7136\u540e\u5728\u8fd9\u91cc\u5199\u4e00\u4efd <code>everest.yaml</code> \u6587\u4ef6, \u5b83\u5305\u542b\u6211\u4eec mod \u7684\u4e00\u4e9b\u57fa\u672c\u4fe1\u606f: everest.yaml<pre><code>- Name: &lt;mod\u540d\u5b57&gt;\nVersion: &lt;\u7248\u672c&gt;\nDLL: &lt;dll\u4f4d\u7f6e&gt;\nDependencies:\n    - Name: Everest\n    Version: &lt;\u4f9d\u8d56\u7684 everest \u7248\u672c&gt;\n</code></pre> ok, \u6211\u4eec\u6765\u6162\u6162\u586b\u8fd9\u4e9b\u4e1c\u897f - <code>mod\u540d\u5b57</code>: \u63a8\u8350\u4e3a\u9879\u76ee\u540d\u6bd4\u5982 <code>MyCelesteMod</code> - <code>\u7248\u672c</code>: \u7531\u4e8e\u662f\u5f00\u53d1\u65e9\u671f, \u6240\u4ee5\u7248\u672c\u63a8\u8350\u6307\u5b9a\u4e3a0\u5f00\u5934\u7684 <code>0.1.0</code> - <code>\u4f9d\u8d56\u7684 everest \u7248\u672c</code>: \u8fd9\u91cc\u586b\u4f60\u7684 everest \u7248\u672c\u5c31\u884c\u4e86, \u6bd4\u5982\u8bf4\u5982\u679c\u4f60\u662f 3876 \u90a3\u4e48\u8fd9\u91cc\u5e94\u8be5\u5199 <code>1.3876.0</code> - <code>Dll \u4f4d\u7f6e</code>: \u6211\u4eec\u5148\u628a\u4e4b\u524d\u7f16\u8bd1\u7684\u65b0\u9c9c(\u53ef\u80fd\u73b0\u5728\u4e0d\u548b\u65b0\u9c9c\u4e86)\u7684 dll \u590d\u5236\u5230\u8fd9\u4e2a\u6587\u4ef6\u5939\u6765, \u6ca1\u8bb0\u9519\u7684\u8bdd\u5728\u8fd9\u91cc\u53eb <code>MyCelesteMod.dll</code>, ok, <code>everest.yaml</code> \u91cc\u8981\u5199\u7684 dll \u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u8fd9\u4e2a\u6587\u4ef6\u5939\u7684, \u6211\u4eec\u5c31\u653e\u5728\u5b83\u91cc\u9762\u7b2c\u4e00\u5c42, \u6240\u4ee5\u6211\u4eec\u76f4\u63a5\u5199 <code>MyCelesteMod.dll</code> \u5c31\u884c\u4e86.</p> <p>\u73b0\u5728\u4f60\u7684\u90a3\u4e2a\u6587\u4ef6\u5939\u73b0\u5728\u53ef\u80fd\u957f\u8fd9\u4e2a\u6837\u5b50:</p> <ul> <li>MyCelesteMod<ul> <li>MyCelesteMod.dll</li> <li>everest.yaml</li> </ul> </li> </ul> <p>everest.yaml\u53ef\u80fd\u957f\u8fd9\u4e2a\u6837\u5b50: everest.yaml<pre><code>- Name: MyCelesteMod\nVersion: 0.1.0\nDLL: MyCelesteMod.dll\nDependencies:\n    - Name: Everest\n    Version: 1.3876.0\n</code></pre></p> <p>ok, \u5728\u542f\u52a8\u4e4b\u524d\u6211\u4eec\u8fd8\u8981\u5e72\u6700\u540e\u4e00\u4ef6\u5c0f\u4e8b, \u5c31\u662f\u6211\u4eec\u7684\u65e5\u5fd7, \u5b83\u6253\u5370\u5728\u6587\u4ef6\u91cc\u540c\u65f6\u4e5f\u6253\u5370\u5728\u63a7\u5236\u53f0\u91cc, \u65e5\u5fd7\u6587\u4ef6\u7ffb\u9605\u6bd4\u8f83\u9ebb\u70e6, \u6240\u4ee5\u4e3a\u4e86\u65e5\u540e\u65b9\u4fbf\u8c03\u8bd5, \u6211\u4eec\u8fd8\u662f\u5148\u8ba9\u851a\u84dd\u542f\u52a8\u7684\u540c\u65f6\u542f\u52a8\u4e00\u4e2a\u63a7\u5236\u53f0\u597d\u4e00\u70b9. Everest \u5df2\u7ecf\u4e3a\u6211\u4eec\u505a\u4e86\u8fd9\u4ef6\u4e8b\u4e86, \u6211\u4eec\u8981\u505a\u7684\u53ea\u662f\u5728\u851a\u84ddexe\u540c\u76ee\u5f55\u4e0b\u627e\u5230<code>everest-launch.txt</code>, \u6ca1\u627e\u5230\u4e5f\u6ca1\u5173\u7cfb, \u65b0\u5efa\u4e00\u4e2a\u5c31\u53ef\u4ee5\u4e86, \u7136\u540e\u5728\u91cc\u9762\u5199\u4e0a<code>--console</code>, \u662f\u7684\u5c31\u8fd9\u4e00\u5c0f\u70b9\u4e1c\u897f, \u7136\u540e\u6211\u4eec\u4fdd\u5b58, \u542f\u52a8\u851a\u84dd!</p> <p>\u542f\u52a8\u540e\u4f60\u5e94\u8be5\u4f1a\u540c\u65f6\u770b\u5230\u4e00\u4e2a\u63a7\u5236\u53f0\u7a97\u53e3, \u626b\u89c6\u4e00\u4e0b: console output<pre><code>[MonoMod] [AutoPatch] Patch pass\n[MonoMod] [AutoPatch] PatchRefs pass\n[MonoMod] [PostProcessor] PostProcessor pass #1\n[MonoMod] [Write] Writing modded module into output file.\n(07/05/2023 23:22:16) [Everest] [Info] [MyCelesteMod] Hello World! Hello Everest!\n(07/05/2023 23:22:16) [Everest] [Info] [core] Module MyCelesteMod 0.1.0 registered.\n(07/05/2023 23:22:16) [Everest] [Info] [loader] Loading mods with unsatisfied optional dependencies (if any)\nFNA3D Driver: D3D11\nD3D11 Adapter: Intel(R) UHD Graphics 630\nBEGIN LOAD\n- GFX LOAD: 139ms\n- MTN LOAD: 9ms\nWINDOW-1600x900\nGAME DISPLAYED (in 291ms)\n- AUDIO LOAD: 454ms\n- GFX DATA LOAD: 75ms\n</code></pre> \u5927\u6982\u5728\u5982\u4e0a\u7684\u4f4d\u7f6e\u9644\u8fd1(\u5728\u8fd9\u91cc\u662f\u7b2c5\u884c)\u4f60\u5c31\u80fd\u627e\u5230\u4f60\u7684 Hello world \u4e86, \u81f3\u6b64\u57fa\u672c\u73af\u5883\u914d\u7f6e\u7ed3\u675f.</p>"},{"location":"arc/sdk-styled-proj/","title":"\u504f\u597d - sdk-styled csproj","text":""},{"location":"arc/sdk-styled-proj/#sdk-style-csproj","title":"Sdk-style csproj","text":"<p>\u73b0\u5728\u6253\u5f00\u4f60\u7684\u9879\u76ee\u76ee\u5f55\u4e2d\u7684 <code>.csproj</code> \u6587\u4ef6(\u901a\u5e38\u4e5f\u4f1a\u88ab\u53eb\u4f5c*\u9879\u76ee\u6587\u4ef6*), \u5b83\u7528\u4e8e\u7ec4\u7ec7\u63cf\u8ff0\u4f60\u7684\u9879\u76ee\u662f\u4ec0\u4e48\u6837\u5b50\u7684, \u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u975e\u5e38\u7684\u6742\u4e71\u4e0d\u53ef\u8bfb, \u5c31\u50cf:</p> .csproj<pre><code>&lt;?xml version=\"1.0\" encoding=\"utf-8\"?&gt;\n&lt;Project ToolsVersion=\"15.0\" xmlns=\"http://schemas.microsoft.com/developer/msbuild/2003\"&gt;\n  &lt;Import Project=\"$(MSBuildExtensionsPath)\\$(MSBuildToolsVersion)\\Microsoft.Common.props\" Condition=\"Exists('$(MSBuildExtensionsPath)\\$(MSBuildToolsVersion)\\Microsoft.Common.props')\" /&gt;\n  &lt;PropertyGroup&gt;\n    &lt;Configuration Condition=\" '$(Configuration)' == '' \"&gt;Debug&lt;/Configuration&gt;\n    &lt;Platform Condition=\" '$(Platform)' == '' \"&gt;AnyCPU&lt;/Platform&gt;\n    &lt;ProjectGuid&gt;{100E625E-04C6-434F-865C-3E6E50A379B5}&lt;/ProjectGuid&gt;\n    &lt;OutputType&gt;Library&lt;/OutputType&gt;\n    &lt;AppDesignerFolder&gt;Properties&lt;/AppDesignerFolder&gt;\n    &lt;RootNamespace&gt;MyCelesteMod&lt;/RootNamespace&gt;\n    &lt;AssemblyName&gt;MyCelesteMod&lt;/AssemblyName&gt;\n    &lt;TargetFrameworkVersion&gt;v4.5.2&lt;/TargetFrameworkVersion&gt;\n    &lt;FileAlignment&gt;512&lt;/FileAlignment&gt;\n    &lt;Deterministic&gt;true&lt;/Deterministic&gt;\n  &lt;/PropertyGroup&gt;\n  &lt;PropertyGroup Condition=\" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' \"&gt;\n    &lt;DebugSymbols&gt;true&lt;/DebugSymbols&gt;\n    &lt;DebugType&gt;full&lt;/DebugType&gt;\n    &lt;Optimize&gt;false&lt;/Optimize&gt;\n    &lt;OutputPath&gt;bin\\Debug\\&lt;/OutputPath&gt;\n    &lt;DefineConstants&gt;DEBUG;TRACE&lt;/DefineConstants&gt;\n    &lt;ErrorReport&gt;prompt&lt;/ErrorReport&gt;\n    &lt;WarningLevel&gt;4&lt;/WarningLevel&gt;\n  &lt;/PropertyGroup&gt;\n  &lt;PropertyGroup Condition=\" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' \"&gt;\n    &lt;DebugType&gt;pdbonly&lt;/DebugType&gt;\n    &lt;Optimize&gt;true&lt;/Optimize&gt;\n    &lt;OutputPath&gt;bin\\Release\\&lt;/OutputPath&gt;\n    &lt;DefineConstants&gt;TRACE&lt;/DefineConstants&gt;\n    &lt;ErrorReport&gt;prompt&lt;/ErrorReport&gt;\n    &lt;WarningLevel&gt;4&lt;/WarningLevel&gt;\n  &lt;/PropertyGroup&gt;\n  &lt;ItemGroup&gt;\n    &lt;Reference Include=\"Celeste\"&gt;\n      &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\Celeste.exe&lt;/HintPath&gt;\n    &lt;/Reference&gt;\n    &lt;Reference Include=\"FNA\"&gt;\n      &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\FNA.dll&lt;/HintPath&gt;\n    &lt;/Reference&gt;\n    &lt;Reference Include=\"MMHOOK_Celeste\"&gt;\n      &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\MMHOOK_Celeste.dll&lt;/HintPath&gt;\n    &lt;/Reference&gt;\n    &lt;Reference Include=\"YamlDotNet\"&gt;\n      &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\YamlDotNet.dll&lt;/HintPath&gt;\n    &lt;/Reference&gt;\n    &lt;Reference Include=\"System\" /&gt;\n    &lt;Reference Include=\"System.Core\" /&gt;\n    &lt;Reference Include=\"System.Xml.Linq\" /&gt;\n    &lt;Reference Include=\"Microsoft.CSharp\" /&gt;\n    &lt;Reference Include=\"System.Xml\" /&gt;\n  &lt;/ItemGroup&gt;\n  &lt;ItemGroup&gt;\n    &lt;Compile Include=\"MyModModule.cs\" /&gt;\n    &lt;Compile Include=\"Properties\\AssemblyInfo.cs\" /&gt;\n  &lt;/ItemGroup&gt;\n  &lt;Import Project=\"$(MSBuildToolsPath)\\Microsoft.CSharp.targets\" /&gt;\n&lt;/Project&gt;\n</code></pre> <p>Note</p> <p>\u5bf9\u4e8e\u6b64\u90e8\u5206\u7684\u5185\u5bb9\u4f60\u53ef\u80fd\u9700\u8981\u9605\u8bfb\u4e86\u89e3\u4e00\u4e0b <code>XML</code> \u683c\u5f0f\u6587\u4ef6</p> <p>\u5b9e\u9645\u4e0a\u5bf9\u4e8e\u6211\u4eec\u771f\u6b63\u7ecf\u5e38\u4fee\u6539\u7684\u5c5e\u6027\u53ea\u6709\u4e0a\u9762\u6807\u4eae\u7684\u884c, \u90a3\u4e48\u5982\u679c\u8fd9\u65f6\u5019\u4f7f\u7528 <code>Sdk-style csproj</code> \u4f1a\u597d\u5f88\u591a, \u5b83\u770b\u4e0a\u53bb\u662f\u8fd9\u6837\u7684:</p> Sdk-style csproj<pre><code>&lt;Project Sdk=\"Microsoft.NET.Sdk\"&gt;\n\n    &lt;PropertyGroup&gt;\n        &lt;OutputType&gt;Library&lt;/OutputType&gt;\n        &lt;RootNamespace&gt;MyCelesteMod&lt;/RootNamespace&gt;\n        &lt;AssemblyName&gt;MyCelesteMod&lt;/AssemblyName&gt;\n        &lt;TargetFramework&gt;net452&lt;/TargetFramework&gt;\n    &lt;/PropertyGroup&gt;\n\n    &lt;ItemGroup&gt;\n        &lt;Reference Include=\"Celeste\"&gt;\n            &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\Celeste.exe&lt;/HintPath&gt;\n        &lt;/Reference&gt;\n        &lt;Reference Include=\"FNA\"&gt;\n            &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\FNA.dll&lt;/HintPath&gt;\n        &lt;/Reference&gt;\n        &lt;Reference Include=\"MMHOOK_Celeste\"&gt;\n            &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\MMHOOK_Celeste.dll&lt;/HintPath&gt;\n        &lt;/Reference&gt;\n        &lt;Reference Include=\"YamlDotNet\"&gt;\n            &lt;HintPath&gt;..\\..\\..\\..\\..\\..\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\YamlDotNet.dll&lt;/HintPath&gt;\n        &lt;/Reference&gt;\n        &lt;Reference Include=\"System\" /&gt;\n        &lt;Reference Include=\"System.Core\" /&gt;\n        &lt;Reference Include=\"System.Xml.Linq\" /&gt;\n        &lt;Reference Include=\"Microsoft.CSharp\" /&gt;\n        &lt;Reference Include=\"System.Xml\" /&gt;\n    &lt;/ItemGroup&gt;\n\n&lt;/Project&gt;\n</code></pre> <p>\u4f60\u4f1a\u53d1\u73b0\u5176\u5b9e\u8fd9\u91cc\u53ea\u7559\u4e0b\u4e86\u6211\u4eec\u4e0a\u9762\u6807\u9ec4\u7684\u4e1c\u897f, \u662f\u7684, \u8fd9\u5c31\u662f <code>Sdk-style csproj</code> \u7684\u4f18\u70b9. \u8fc1\u79fb\u81f3 <code>Sdk-style csproj</code> \u975e\u5e38\u7b80\u5355, \u4f60\u53ea\u9700\u8981:</p> <ul> <li>\u5220\u9664 <code>PropertyGroup</code> \u548c <code>ItemGroup</code> \u53ca\u65c1\u8fb9\u7684\u975e\u6807\u9ec4\u8282\u70b9</li> <li>\u5220\u9664 <code>Project</code> \u8282\u70b9\u4e0b\u7684\u4e24\u4e2a <code>Import</code></li> <li>\u5220\u9664 <code>Project</code> \u8282\u70b9\u7684\u6240\u6709\u5c5e\u6027</li> <li>\u91cd\u65b0\u5728 <code>Project</code> \u8282\u70b9\u4e0a\u52a0\u5165\u5c5e\u6027: <code>Sdk = \"Microsoft.NET.Sdk\"</code></li> <li><code>TargetFrameworkVersion</code> \u66f4\u6539\u4e3a\u65b0\u7248\u7684 <code>TargetFramework</code>, <code>v4.5.2</code> \u66f4\u6539\u4e3a <code>net452</code></li> </ul> <p>Note</p> <p>\u4e0d\u7528\u62c5\u5fc3\u5220\u6389\u8fd9\u4e48\u591a\u4e1c\u897f\u4f1a\u51fa\u73b0\u95ee\u9898, \u5b9e\u9645\u4e0a\u6211\u4eec\u5220\u6389\u7684\u4e1c\u897f\u53ea\u662f\u5408\u5e76\u5165 <code>Sdk = \"Microsoft.NET.Sdk\"</code> \u8fd9\u4e00\u53e5\u4e86\u800c\u5df2</p> <p>\u8fd9\u4e2a\u65f6\u5019\u6574\u4e2a\u6587\u4ef6\u6e05\u6670\u53ef\u8bfb:</p> <ul> <li>\u6839\u8282\u70b9\u7684 <code>Project</code> \u4e0b\u6302\u8f7d\u7740 <code>PropertyGroup</code> \u4ee5\u53ca <code>ItemGroup</code>,</li> <li><code>PropertyGroup</code> \u63cf\u8ff0\u4e86\u6211\u4eec\u9879\u76ee\u7684\u4e00\u4e9b\u901a\u7528\u5c5e\u6027, \u6bd4\u5982\u8f93\u51fa\u7c7b\u578b, \u547d\u540d\u7a7a\u95f4, \u7a0b\u5e8f\u96c6\u6635\u79f0\u4ee5\u53ca\u9879\u76ee\u6846\u67b6\u7248\u672c,</li> <li><code>ItemGroup</code> \u5219\u63cf\u8ff0\u4e86\u6211\u4eec\u9879\u76ee\u4e2d\u7684\u4e00\u4e9b\u5f15\u7528\u7b49.</li> </ul> <p>\u5728\u8fd9\u91cc\u63d0\u53ca\u8fd9\u4e2a\u662f\u56e0\u4e3a\u5728\u540e\u9762\u90e8\u5206\u6211\u4eec\u4f1a\u9700\u8981\u4fee\u6539 <code>.csproj</code> \u6587\u4ef6, \u901a\u8fc7\u5bf9\u6bd4\u4f60\u53ef\u4ee5\u53d1\u73b0\u8fd9\u4e24\u4e2a xml \u6587\u4ef6\u90fd\u6709 <code>PropertyGroup</code> \u548c <code>ItemGroup</code> \u8282\u70b9 (\u5982\u679c\u6709\u591a\u4e2a\u8282\u70b9\u7684\u8bdd, \u4efb\u610f\u4e00\u4e2a\u90fd\u884c), \u6240\u4ee5\u6211\u4eec\u4e4b\u540e\u5bf9\u9879\u76ee\u6587\u4ef6\u7684\u4fee\u6539\u7684\u63cf\u8ff0\u90fd\u4f1a\u57fa\u4e8e\u8fd9\u4e24\u4e2a\u8282\u70b9.</p> <p>Warning</p> <p>\u8bb0\u5f97\u5220\u9664 <code>Properties</code> \u6587\u4ef6\u5939\u91cc\u7684 cs \u6587\u4ef6, \u5b83\u53ef\u80fd\u4f1a\u4e0e sdk-styled csproj \u81ea\u52a8\u751f\u6210\u7684\u6587\u4ef6\u76f8\u51b2\u7a81</p>"},{"location":"begin/basic_env/","title":"\u57fa\u7840\u73af\u5883\u914d\u7f6e","text":"<p>Note</p> <p>\u672c\u8282\u5185\u5bb9\u7531\u624b\u52a8\u914d\u7f6e\u91cd\u5199\u4e3a\u901a\u8fc7\u6a21\u677f\u914d\u7f6e, \u65e7\u7248\u4f60\u53ef\u4ee5\u5230\u5f52\u6863-\u57fa\u7840\u73af\u5883\u914d\u7f6e\u4e2d\u627e\u5230(\u4e0d\u63a8\u8350)</p>"},{"location":"begin/basic_env/#celeste","title":"Celeste","text":"<p>Note</p> <p>\u5982\u679c\u4f60\u4e0d\u662f Windows \u7528\u6237\u7684\u8bdd\u8fd9\u4e00\u6b65\u4f60\u53ef\u4ee5\u76f4\u63a5\u8df3\u8fc7.</p> <p>Everest \u9700\u6c42\u6211\u4eec\u4f7f\u7528 FNA \u7248\u672c\u7684\u851a\u84dd, \u800c Linux \u548c MacOS \u4e0a\u7684\u851a\u84dd\u5df2\u7ecf\u5c31\u662f FNA \u7248\u672c\u4e86, \u800c\u5728 Windows \u4e0a\u5219\u662f XNA \u7248\u672c, \u6240\u4ee5\u6211\u4eec\u9700\u8981\u4e00\u4e9b\u65b9\u6cd5\u5207\u6362\u5230 FNA \u7248\u672c:</p> <ul> <li>\u5728 Steam \u4e0a:  \u5e93-&gt;Celeste, \u53f3\u952e\u83dc\u5355\u5c5e\u6027-&gt;\u6d4b\u8bd5\u7248-&gt;Opengl</li> <li>\u5728 itch \u4e0a: \u91cd\u65b0\u4e0b\u8f7d\u4e00\u4e2a <code>Celeste Windows OpenGL</code> \u7248\u672c</li> <li>\u5728 Epic \u4e0a: \u5df2\u7ecf\u662f FNA \u7248\u672c\u4e86</li> </ul> <p>Note</p> <p>Everest \u4f1a\u5728\u8fd0\u884c\u65f6\u5c06\u4f60\u4ee5 FNA \u7248\u672c\u5236\u4f5c\u7684 mod \u91cd\u94fe\u63a5\u4e3a XNA, \u6240\u6709\u4f60\u4e0d\u662f\u5f88\u9700\u8981\u5728\u610f\u8fd9\u4fe9\u7684\u5dee\u8ddd \u6ce8\u610f\u66f4\u6362\u7248\u672c\u540e\u901a\u5e38\u4f1a\u53d8\u56de\u539f\u7248, \u8bb0\u5f97\u91cd\u65b0\u5b89\u88c5 Everest</p>"},{"location":"begin/basic_env/#c","title":"C# \u7f16\u7a0b\u80fd\u529b \u4e0e \u5f00\u53d1\u73af\u5883","text":"<p>\u56e0\u4e3a\u6211\u4eec\u662f CodeMod, \u55ef, \u90a3\u4e48\u5199\u4e00\u4e9b\u4ee3\u7801\u662f\u5fc5\u4e0d\u53ef\u5c11\u7684, \u851a\u84dd\u662f\u4f7f\u7528 <code>C#</code> \u57fa\u4e8e <code>.NET framework 4.5.2</code> \u6765\u5236\u4f5c\u7684, \u90a3\u4e48\u5b66\u4e60 <code>C#</code> \u5f53\u7136\u662f\u5fc5\u4e0d\u53ef\u5c11\u7684.</p> <p>Info</p> <p>\u7406\u8bba\u4e0a\u6240\u6709 .NET \u7cfb\u8bed\u8a00\u6bd4\u5982 <code>VB.NET</code> <code>F#</code> \u90fd\u53ef\u4ee5, \u4e0d\u8fc7\u4e3a\u4e86\u65b9\u4fbf\u8d77\u89c1\u6211\u4eec\u8fd8\u662f\u4f7f\u7528 C#.</p> <p>\u597d\u5427\u8fd9\u53e5\u8bdd\u53ef\u80fd\u8bf4\u7684\u592a\u5e73\u6de1\u4e86(wuwu), \u6bd5\u7adf\u5927\u90e8\u5206\u851a\u6279\u851a\u84dd mod \u7231\u597d\u8005\u5c31\u662f\u88ab\u8fd9\u4e00\u6b65\u5361\u4f4f\u7684, \u90a3\u4e48\u8fd9\u91cc...\u53ea\u80fd\u7ed9\u4f60\u63a8\u8350\u51e0\u4e2a\u5b66\u4e60\u6e20\u9053\u4e86, \u6bd5\u7adf\u5728\u8fd9\u91cc\u6ca1\u5fc5\u8981\u8ba9\u8fd9\u4e2a\u6559\u7a0b\u8fc7\u4e8e\u5168\u80fd.</p> <ol> <li>\u89c6\u9891: Bilibili - \u4e11\u840c\u6c14\u8d28\u72d7 - \u3010C#\u96f6\u57fa\u7840\u5165\u95e8\u6559\u7a0b Visual Studio 2022\u3011\u4eba\u751f\u4f4e\u8c37\u6765\u5b66C# (\u5168p, \u7a0d\u5fae\u4e0d\u5168)</li> <li>\u89c6\u9891: Bilibili - C#\u4ece\u5165\u95e8\u5230\u7cbe\u901a\uff08\u7b2c5\u7248\uff09 (1-71p, 109-132p)</li> <li>\u89c6\u9891: Bilibili - \u5218\u94c1\u731b - C#\u8bed\u8a00\u5165\u95e8\u8be6\u89e3-\u7b2c1\u5b63-\u526a\u8f91\u7248-\u516833\u8bfe-\u5206154\u96c6 (1-152p)</li> <li>\u7f51\u7ad9: Runnob - C# \u6559\u7a0b</li> <li>\u7f51\u7ad9: w3schools - C# \u6559\u7a0b (\u82f1\u6587)</li> <li>\u4e66\u7c4d: C#\u5165\u95e8\u7ecf\u5178-\u7b2c7\u7248-C# 6.0</li> </ol> <p>Info</p> <p>\u5982\u679c\u4f60\u6ca1\u6709\u80fd\u529b\u652f\u6301\u6b63\u7248\u4e66\u7c4d\u7684\u8bdd, \u4f60\u53ef\u4ee5\u5230\u4e00\u4e9b C# \u5f00\u53d1\u8005\u7fa4\u5185\u5bfb\u627e\u5b83\u7684\u7535\u5b50\u975e\u6b63\u7248(\u6bd4\u5982\u89c6\u9891 <code>1.</code> up \u7684\u7fa4\u5185) \u4e0a\u9762\u51e0\u4e2a\u6211\u66f4\u52a0\u63a8\u8350\u7684\u662f <code>1.</code> \u548c <code>3.</code> \u501f\u7528 <code>4.</code> \u7684\u76ee\u5f55, \u786e\u4fdd\u4f60\u5bf9\u4e0b\u9762\u8fd9\u4e9b\u6982\u5ff5(\u753b \u00d7 \u7684\u6682\u65f6\u5728\u851a\u84dd CodeMod \u4e2d\u7528\u4e0d\u5230)\u6709\u8db3\u591f\u6e05\u6670\u7684\u4e86\u89e3\u5728\u5f00\u59cb\u4f60\u7684\u851a\u84dd CodeMod \u4e4b\u65c5\u4e4b\u524d: </p> <p>\u76f8\u4fe1\u5728\u4e0a\u9762\u7684\u6559\u7a0b\u4e2d\u4f60\u5e94\u8be5\u5df2\u7ecf\u88ab\u63a8\u8350\u4e86\u4e00\u4e9b\u7f16\u8f91\u5668/IDE, \u90a3\u4e48\u5728\u672c\u6559\u7a0b\u4e2d\u6211\u4e2a\u4eba\u4f1a\u4e3a\u4e86\u65b9\u4fbf\u4ec5\u5728 <code>Windows</code> \u4e0a\u4f7f\u7528 <code>Visual Studio</code>, \u90a3\u4f60\u9047\u5230\u4e86\u4ec0\u4e48\u5947\u602a\u7684\u95ee\u9898\u53ef\u4ee5\u5230\u4efb\u4f55\u80fd\u8054\u7cfb\u5230\u6211\u7684\u5730\u65b9\u95ee\u6211_(:\u0437\u300d\u2220)_</p>"},{"location":"begin/basic_env/#_2","title":"\u901a\u8fc7\u6a21\u677f\u521b\u5efa\u9879\u76ee","text":"<p>_(:\u0437\u300d\u2220)_ \u6839\u636e\u4e00\u4e9b\u53cd\u9988\u6211\u4eec\u53d1\u73b0\u65e7\u7684\u624b\u52a8\u914d\u7f6e\u73af\u5883\u7684\u65b9\u5f0f\u975e\u5e38\u7684\u590d\u6742\u96be\u64cd\u4f5c( \u6240\u4ee5\u5462\u8fd9\u91cc\u5c31\u63a8\u8350\u4e00\u79cd\u65b0\u7684\u914d\u7f6e\u73af\u5883\u7684\u65b9\u5f0f - \u4f7f\u7528\u6a21\u677f \u8003\u8651\u5230 nuget \u5b89\u88c5\u6a21\u677f\u4e5f\u9700\u8981\u4e00\u5b9a\u7684\u547d\u4ee4\u884c\u57fa\u7840... \u6240\u4ee5\u8fd9\u91cc\u8003\u8651\u63d0\u4f9b\u76f4\u63a5\u7684\u4e0b\u8f7d\u94fe\u63a5, \u6216\u8005Github\u6e90,  \u4e0b\u8f7d\u89e3\u538b/clone\u540e, \u4f7f\u7528\u4f60\u7684 vs \u6253\u5f00\u5176\u4e2d\u7684 csproj \u6587\u4ef6, \u90a3\u4e48\u6309\u7406\u6765\u8bf4\u4f60\u4f1a\u770b\u5230\u8fd9\u51e0\u4e2a\u6587\u4ef6:</p> <p>Note</p> <p>\u4f60\u53ef\u80fd\u8fd8\u9700\u8981\u5b89\u88c5 <code>.NET 6 SDK</code> \u6765\u4f7f\u7528\u8be5\u6a21\u677f, \u4f60\u53ef\u4ee5\u70b9\u51fb\u8fd9\u91cc\u4e0b\u8f7d</p> <ul> <li>CelesteMod.props</li> <li>CelesteMod.targets</li> <li>Common.props</li> <li>MyCelesteModModule.cs</li> <li>MyCelesteMod.csproj</li> </ul> <p>\u4ee5\u53ca\u4f60\u7684\u9879\u76ee, \u5b83\u7684\u540d\u5b57\u662f <code>MyCelesteMod</code>, \u4e0d\u540c\u4e8e\u65e7\u7684\u65b9\u6cd5, \u5728\u8fd9\u91cc\u4f60\u7684\u914d\u7f6e\u8fc7\u7a0b\u5f88\u7b80\u5355:</p> <ul> <li>\u9996\u5148\u6253\u5f00 <code>Common.props</code>, \u5c06\u91cc\u9762\u7684 <code>CelesteRootPath</code> \u5185\u7684\u5185\u5bb9\u6539\u6210\u4f60\u7684\u851a\u84dd\u5b89\u88c5\u4f4d\u7f6e</li> </ul> <pre><code>&lt;Project&gt;\n    &lt;PropertyGroup&gt;\n        &lt;CelesteRootPath&gt;C:\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste&lt;/CelesteRootPath&gt;\n        &lt;CommonCelesteUsings&gt;true&lt;/CommonCelesteUsings&gt;\n        &lt;CommonCelesteReferences&gt;true&lt;/CommonCelesteReferences&gt;\n        &lt;ModAssetsFolderName&gt;ModFolder&lt;/ModAssetsFolderName&gt;\n    &lt;/PropertyGroup&gt;\n&lt;/Project&gt;\n</code></pre> <p>\u73b0\u5728\u4f60\u53ef\u4ee5\u6309\u4e0b <code>Ctrl+B</code> \u6216\u8005\u624b\u52a8\u70b9\u51fb <code>\u751f\u6210-&gt;\u751f\u6210\u89e3\u51b3\u65b9\u6848</code>, \u5982\u679c\u4f60\u5728\u4f60\u7684 vs \u8f93\u51fa\u91cc\u9762\u770b\u5230\u4e86\u7c7b\u4f3c\u8fd9\u4e00\u53e5:</p> <pre><code>1&gt;Copied files in 'ModFolder' to 'C:\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\Mods\\MyCelesteMod'\n</code></pre> <p>\u5e76\u4e14\u4f60\u5728\u4f60\u7684\u851a\u84dd Mod \u76ee\u5f55\u4e0b\u627e\u5230\u4e86\u8fd9\u4e2a\u88ab\u521b\u5efa\u7684\u76ee\u5f55, \u90a3\u4e48\u4f60\u7684\u73af\u5883\u5c31\u7b97\u662f\u914d\u5b8c\u4e86, \u5982\u679c\u4f60\u5f88\u611f\u5174\u8da3\u8fd9\u4e4b\u4e2d\u53d1\u751f\u4e86\u4ec0\u4e48, \u8981\u5f15\u7528\u54ea\u4e9b\u7a0b\u5e8f\u96c6, \u8fd9\u4e2a\u6a21\u677f\u80cc\u540e\u5e72\u4e86\u4ec0\u4e48, \u4f60\u53ef\u4ee5\u53bb\u770b\u90a3\u590d\u6742\u7684\u65e7\u7684\u914d\u7f6e\u65b9\u6cd5.</p> <p>Note</p> <p>\u8fd9\u4e2a\u6a21\u677f\u4f7f\u7528 <code>msbuild</code> \u5e2e\u52a9\u4e86\u4f60\u5f88\u591a\u4e8b! \u6bd4\u5982\u5f53\u4f60\u7f16\u8bd1\u5b8c\u9879\u76ee\u4e4b\u540e\u5b83\u4f1a\u590d\u5236\u7f16\u8bd1\u7ed3\u679c\u5230\u9879\u76ee\u76ee\u5f55\u7684 <code>ModFolder</code> \u76ee\u5f55\u4e0b, \u7136\u540e\u5c06\u6574\u4e2a <code>ModFolder</code> \u590d\u5236\u5230\u851a\u84dd\u7684 <code>Mods\\{\u4f60\u7684mod\u540d}</code> \u6587\u4ef6\u5939\u4e0b! \u6240\u4ee5\u5f53\u6211\u4eec\u9700\u8981\u66f4\u6539\u4e00\u4e9b\u6bd4\u5982\u8bf4 loenn \u7684\u914d\u7f6e\u6587\u4ef6, <code>everest.yaml</code> \u7684\u5185\u5bb9, \u4f60\u7684\u6d4b\u8bd5\u5730\u56fe\u7b49\u65f6,  \u4f60\u53ea\u9700\u8981\u7b80\u5355\u5730\u91cd\u65b0\u7f16\u8bd1\u4e00\u904d\u9879\u76ee, \u7136\u540e\u7b49\u5f85\u6a21\u677f\u6765\u5e2e\u4f60\u505a\u5269\u4e0b\u7684\u6d3b!  </p>"},{"location":"begin/basic_env/#_3","title":"\u66f4\u6539\u7ec6\u8282","text":"<p>\u901a\u8fc7\u6a21\u677f\u7684\u8bdd\u4f9d\u7136\u6709\u4e9b\u4e1c\u897f\u9700\u8981\u81ea\u884c\u66f4\u6539, \u6bd4\u5982\u8fd9\u4e2a Mod \u7684\u540d\u5b57. \u66f4\u6539 Mod \u7684\u540d\u5b57\u5f88\u7b80\u5355, \u4f60\u53ea\u9700\u8981\u7b80\u5355\u5730\u5728 vs \u91cc\u91cd\u547d\u540d\u9879\u76ee\u7684\u540d\u5b57 \u6bd4\u5982\u6211\u60f3\u53eb\u505a <code>MyAwesomeMod</code>, \u90a3\u4e48\u4f60\u53ef\u4ee5\u901a\u8fc7\u8fd9\u6837:  \u987a\u4fbf\u522b\u5fd8\u4e86\u628a\u7c7b\u4f3c <code>MyCelesteModModule.cs</code> \u7684\u6587\u4ef6\u540d\u4e5f\u6539\u6210\u7c7b\u4f3c <code>MyAwesomeModModule.cs</code>, \u4ee5\u53ca\u6539\u540d\u540e\u6e05\u7406\u4e00\u4e0b ModFolder \u4e0b\u9762\u53ef\u80fd\u6709\u7684\u4e00\u4e9b\u4ee5\u8fc7\u53bb\u540d\u5b57\u547d\u540d\u7684 .dll \u548c .pdb \u6587\u4ef6!  </p>"},{"location":"begin/basic_env/#module","title":"Module \u7c7b","text":"<p>\u5c31\u50cf\u6211\u4eec\u7684\u7ecf\u5178\u7684\u63a7\u5236\u53f0 C# \u5e94\u7528\u7a0b\u5e8f\u4e00\u6837\u6709\u4e2a <code>Main</code> \u65b9\u6cd5, \u6211\u4eec\u7684\u851a\u84dd Mod \u4e5f\u6709\u4e00\u4e2a \u7c7b\u4f3c\u7684\u4e1c\u897f,  \u90a3\u5c31\u662f Everest \u63d0\u4f9b\u7ed9\u6211\u4eec\u7684 <code>EverestModule</code> \u7c7b. \u90a3\u4e48, \u73b0\u5728\u6253\u5f00\u4f60\u7684 <code>Module.cs</code> \u90a3\u4e2a\u6587\u4ef6, \u4f60\u5e94\u8be5\u4f1a\u770b\u5230\u7ed3\u6784\u8fd9\u6837\u7684\u4ee3\u7801: <pre><code>namespace MyCelesteMod;\n\npublic class MyAwesomeModModule : EverestModule\n{\n    public override void Load()\n    {\n        Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World!\");\n\n    }\n\n    public override void Unload()\n    {\n    }\n}\n</code></pre> \u5728\u5f00\u5934\u6211\u4eec\u58f0\u660e\u4e86\u547d\u540d\u7a7a\u95f4, \u63a5\u4e0b\u6765\u6211\u4eec\u58f0\u660e\u4e86\u4e00\u4e2a\u7c7b, \u7136\u540e\u8ba9\u5b83\u7ee7\u627f\u4e8e <code>EverestModule</code>, \u6ce8\u610f\u8fd9\u4e2a\u7c7b\u662f\u62bd\u8c61\u7684, \u5b83\u8981\u6c42\u6211\u4eec\u5b9e\u73b0\u7684\u4e24\u4e2a\u65b9\u6cd5\u5206\u522b\u4e3a <code>Load</code> \u4e0e <code>Unload</code>. \u8fd9\u4e24\u4e2a\u65b9\u6cd5\u5f88\u7b80\u5355:</p> <ul> <li><code>Load</code> \u65b9\u6cd5\u5728\u4f60\u7684 mod \u88ab\u52a0\u8f7d\u65f6\u8c03\u7528.</li> <li><code>Unload</code> \u65b9\u6cd5\u5728\u4f60\u7684 mod \u88ab\u5378\u8f7d\u65f6\u8c03\u7528.</li> </ul> <p>\u901a\u5e38\u6211\u4eec\u4f1a\u5728 <code>Load</code> \u65b9\u6cd5\u91cc\u52a0\u8f7d\u6211\u4eec\u9700\u8981\u7684\u8d44\u6e90, \u8fdb\u884c\u9002\u5f53\u7684\u521d\u59cb\u5316, \u5728 <code>Unload</code> \u65b9\u6cd5\u91cc\u91ca\u653e\u6211\u4eec\u7684\u8d44\u6e90. \u5728\u8fd9\u91cc\u4e3a\u4e86\u660e\u663e\u53ef\u89c1, \u6211\u4eec\u5728 <code>Load</code> \u65b9\u6cd5\u91cc\u901a\u8fc7\u4e00\u4e2a\u851a\u84dd\u4e2d\u7684\u7c7b <code>Logger</code> \u6253\u5370\u51fa\u4e86\u4e00\u53e5 \"Hello World\".</p> \u5982\u679c\u4f60\u597d\u5947 <code>Logger.Log</code> \u8fd9\u4e2a\u65b9\u6cd5\u4f60\u53ef\u4ee5\u5c55\u5f00\u6765\u4e86\u89e3 <p><code>Logger</code> \u662f\u4e00\u4e2a\u851a\u84dd\u5e95\u5c42\u5f15\u64ce <code>Monocle</code> \u7684\u4e00\u4e2a\u5de5\u5177\u7c7b, \u5b83\u5e2e\u52a9\u4f60\u6253\u5370\u8f93\u51fa\u4e00\u4e9b\u8c03\u8bd5\u4fe1\u606f, \u901a\u5e38\u8fd9\u4e9b\u4fe1\u606f\u4f1a\u88ab\u6253\u5370\u8fdb\u63a7\u5236\u53f0\u7684\u540c\u65f6\u5199\u5165\u6e38\u620f\u7684 <code>log.txt</code> \u6587\u4ef6\u4e2d,  \u8fd9\u4e5f\u5c31\u89e3\u91ca\u4e86\u4e3a\u4ec0\u4e48\u4f60\u9047\u5230\u5404\u79cd\u95ee\u9898\u65f6\u522b\u4eba\u603b\u8981\u6c42\u4f60\u53d1\u9001\u4f60\u7684 <code>log.txt</code>. <code>Logger.Log</code> \u6709\u4e24\u4e2a\u91cd\u8f7d, \u5176\u4e2d\u4e00\u4e2a\u7684\u7b7e\u540d\u662f: <pre><code>public static void Log(LogLevel logLevel, string tag, string str)\n</code></pre> \u5b83\u4f1a\u4ee5 <code>logLevel</code> \u7684\u65e5\u5fd7\u7b49\u7ea7\u6253\u5370\u4e00\u4e2a\u6807\u7b7e\u4e3a <code>tag</code> \u7684\u6d88\u606f <code>str</code>, \u53e6\u4e00\u4e2a\u91cd\u8f7d\u4e0d\u8981\u6c42\u4f60\u4f20\u5165 <code>logLevel</code> \u4f46\u4f1a\u9ed8\u8ba4\u4f60\u7684 <code>logLevel</code> \u4e3a <code>LogLevel.Verbose</code>. <code>LogLevel</code> \u679a\u4e3e\u5305\u542b <code>Verbose, Debug, Info, Warn, Error</code>. \u901a\u5e38\u5bf9\u4e8e\u666e\u901a\u65e5\u5fd7\u6211\u4eec\u4f1a\u9009\u62e9 <code>Info</code>, \u5bf9\u4e8e\u8f83\u591a\u7684\u8c03\u8bd5\u4fe1\u606f\u9009\u62e9 <code>Debug</code>, \u5bf9\u4e8e\u5197\u4f59\u7684\u4fe1\u606f\u9009\u62e9 <code>Verbose</code>, \u5bf9\u4e8e\u4e00\u4e9b\u9519\u8bef\u4f46\u4e0d\u5f71\u54cd\u6e38\u620f\u8fdb\u884c\u7684\u4fe1\u606f\u9009\u62e9 <code>Warn</code>, \u5bf9\u4e8e\u4e00\u4e9b\u81f4\u547d\u6027\u9519\u8bef\u6211\u4eec\u4f1a\u9009\u62e9 <code>Error</code>. \u4e00\u822c\u5730, \u6e38\u620f\u53ea\u4f1a\u6253\u5370 <code>Info</code> \u7b49\u7ea7\u53ca\u4ee5\u4e0a\u7684\u65e5\u5fd7, \u4f60\u53ef\u4ee5\u901a\u8fc7\u5728\u851a\u84dd\u542f\u52a8\u7684\u547d\u4ee4\u884c\u4e2d\u52a0\u5165<code>--loglevel {\u7b49\u7ea7}</code>\u6765\u6307\u5b9a\u8fc7\u6ee4\u7b49\u7ea7.</p>"},{"location":"begin/basic_env/#everestyaml","title":"everest.yaml","text":"<p>ok, \u6211\u4eec\u524d\u9762\u51e0\u4e4e\u5df4\u62c9\u5df4\u62c9\u8bb2\u4e86\u51e0\u4e4e\u4e09\u5343\u591a\u4e2a\u5b57, \u4f46\u662f\u4f9d\u7136\u6ca1\u6709\u8ba9\u851a\u84dd\u52a0\u8f7d\u5230\u6211\u4eec\u7684mod, \u4e0d\u8fc7\u522b\u6025, \u8fd9\u662f\u5012\u6570\u7b2c\u4e8c\u6b65\u4e86. \u5b9e\u9645\u4e0a\u6709\u5173 code mod \u7684\u6240\u6709\u4ee3\u7801\u76f8\u5173\u7684\u4e1c\u897f\u6211\u4eec\u90fd\u5df2\u7ecf\u505a\u5b8c\u4e86, \u5269\u4f59\u7684\u5176\u5b9e\u53ea\u662f\u4e00\u4e2a\u666e\u901a mod \u8981\u505a\u7684 ---- \u5199 <code>everest.yaml</code>. \u5728\u8fd9\u91cc\u6211\u4eec\u9700\u8981\u5728 <code>ModFolder</code> \u8fd9\u4e2a\u6587\u4ef6\u5939\u91cc\u505a\u8fd9\u4ef6\u4e8b, \u90a3\u4e48, \u5728\u4f60\u7684\u8fd9\u4e2a\u6587\u4ef6\u5939\u4e0b\u521b\u5efa <code>everest.yaml</code> \u7a7a\u6587\u4ef6, \u4f60\u7684\u76ee\u5f55\u7ed3\u6784\u53ef\u80fd\u50cf\u662f:  </p> <p>Note</p> <p><code>.dll</code> \u6587\u4ef6\u548c <code>.pdb</code> \u6587\u4ef6\u4ec5\u4f1a\u5728\u4f60\u6784\u5efa\u8fc7\u9879\u76ee\u540e\u51fa\u73b0, \u6709\u65f6\u5019\u751a\u81f3 ModFolder \u76ee\u5f55\u4e5f\u4f1a\u5728\u6784\u5efa\u8fc7\u540e\u51fa\u73b0</p> <ul> <li>ModFolder<ul> <li>everest.yaml</li> <li>MyCelesteMod.dll</li> <li>MyCelesteMod.pdb</li> </ul> </li> </ul> <p>\u597d\u7684, \u73b0\u5728\u6211\u4eec\u6253\u5f00 <code>everest.yaml</code>, \u7136\u540e\u50cf\u4e00\u4e2a\u666e\u901a\u7684 mapper \u4e00\u6837\u586b\u5199\u4fe1\u606f: <pre><code>- Name: MyCelesteMod\n  Version: 0.1.0\n  DLL: MyCelesteMod.dll\n  Dependencies:\n    - Name: Everest\n      Version: 1.3971.0\n</code></pre> \u8fd9\u4e9b\u53c2\u6570\u5206\u522b\u662f:</p> <ul> <li><code>Name</code>: \u4f60\u7684 mod \u540d\u5b57</li> <li><code>Version</code>: \u4f60\u7684 mod \u7684\u7248\u672c</li> <li><code>DLL</code>: \u5982\u679c\u4f60\u662f code mod \u7684\u8bdd, \u8fd9\u91cc\u586b\u5165\u4f60\u7684 code (\u4e5f\u5c31\u662f dll \u6587\u4ef6) \u7684\u4f4d\u7f6e, \u8fd9\u91cc\u6211\u4eec\u662f\u76f4\u63a5\u628a .dll \u6587\u4ef6\u653e\u5230\u8fd9\u4e2a yaml \u7684\u65c1\u8fb9\u4e86, \u6240\u4ee5\u76f4\u63a5\u5199\u540d\u5b57\u5c31\u597d</li> </ul> <p>\u6700\u540e\u662f\u6700\u5e95\u4e0b\u7684\u90a3\u4e2a\u4f9d\u8d56, \u8fd9\u91cc\u6211\u4eec\u53ea\u4f9d\u8d56\u6700\u57fa\u7840\u7684 Everest, \u7248\u672c\u586b\u4e0a\u4f60\u76ee\u524d\u4f7f\u7528\u7684 Everest \u7248\u672c, \u8fd9\u91cc\u6211\u5c31\u586b\u5199 3971 \u4e86.  </p>"},{"location":"begin/basic_env/#_4","title":"\u6700\u540e\u4e00\u6b65!","text":"<p>\u4e3a\u4e86\u65b9\u4fbf\u6211\u4eec\u7684\u8c03\u8bd5, \u6211\u4eec\u9700\u8981\u8ba9\u851a\u84dd\u6253\u5f00\u7684\u540c\u65f6\u6253\u5f00\u63a7\u5236\u53f0, \u8fd9\u4e00\u6b65\u5f88\u7b80\u5355:</p> <ul> <li>\u627e\u5230\u851a\u84dd\u6839\u76ee\u5f55\u4e0b\u7684 <code>everest-launch.txt</code>, \u6ca1\u6709\u7684\u8bdd\u65b0\u5efa\u4e00\u4e2a\u7a7a\u7684\u5c31\u884c\u4e86</li> <li>\u5411\u91cc\u9762\u5199\u5165 <code>--console</code></li> <li>\u641e\u5b9a, \u8d70\u4f60!</li> </ul> <p>\u73b0\u5728, \u91cd\u65b0\u7f16\u8bd1\u9879\u76ee, \u8ba9 <code>msbuild</code> \u5e26\u7740\u4f60\u7684 <code>ModFolder</code> \u7684\u5185\u5bb9\u524d\u5f80\u851a\u84dd Mods \u6587\u4ef6\u5939\u4e0b, \u542f\u52a8\u851a\u84dd. \u5728\u540c\u65f6\u542f\u52a8\u7684\u9ed1\u4e4e\u4e4e\u7684\u547d\u4ee4\u884c\u7a97\u53e3\u4e0a\u4f60\u5e94\u8be5\u80fd\u5728\u8fd9\u9644\u8fd1\u770b\u5230\u90a3\u53e5\u719f\u6089\u7684 Hello world: <pre><code>(07/08/2023 21:18:59) [Everest] [Info] [core] Module DialogCutscene 1.0.0 registered.\n(07/08/2023 21:18:59) [Everest] [Info] [core] Module UpdateChecker 1.0.2 registered.\n(07/08/2023 21:18:59) [Everest] [Info] [core] Module InfiniteSaves 1.0.0 registered.\n(07/08/2023 21:18:59) [Everest] [Info] [core] Module DebugRebind 1.0.0 registered.\n(07/08/2023 21:18:59) [Everest] [Info] [core] Module RebindPeriod 1.0.0 registered.\n(07/08/2023 21:19:00) [Everest] [Info] [Everest.LuaBoot] Lua ready.\n(07/08/2023 21:19:00) [Everest] [Info] [MyCelesteMod] Hello World!\n(07/08/2023 21:19:00) [Everest] [Info] [core] Module MyAwesomeMod 0.1.0 registered.\n(07/08/2023 21:19:00) [Everest] [Info] [loader] Loading mods with unsatisfied optional dependencies (if any)\nFNA3D Driver: D3D11\nD3D11 Adapter: Intel(R) UHD Graphics 630\n</code></pre></p>"},{"location":"begin/basic_env/#_5","title":"\u8fd8\u6ca1\u5b8c","text":"<p>\u5728\u7ecf\u8fc7\u5982\u4e0a\u7684\u914d\u7f6e\u540e, \u4f60\u4f1a\u53d1\u73b0\u5728\u851a\u84dd\u542f\u52a8\u7684\u65f6\u5019, \u8fdb\u884c\u7f16\u8bd1\u5e76\u590d\u5236\u8d44\u6e90\u65f6\u4f1a\u62a5\u9519,  \u8fd9\u662f\u56e0\u4e3a everest \u9501\u5b9a\u5360\u7528\u4e86\u5b83\u4eec, \u5bfc\u81f4\u4f60\u4e0d\u5f97\u4e0d\u8ba9\u8fd9\u4e00\u5207\u5728\u851a\u84dd\u5173\u95ed\u65f6\u8fdb\u884c, \u540c\u65f6\u7531\u4e8e\u851a\u84dd\u7684\u91cd\u542f\u901f\u5ea6\u4e0d\u662f\u5f88\u7406\u60f3, \u8fd9\u5927\u5927\u7684\u62c9\u4f4e\u4e86 mod \u5f00\u53d1\u6548\u7387.  \u4e0d\u8fc7\u597d\u5728 everest \u63d0\u4f9b\u4e86\u4e00\u4e2a\u6280\u672f\u53eb\u505a <code>hot reload</code>, \u5373\u70ed\u91cd\u8f7d, \u5b83\u5141\u8bb8\u4f60\u5728\u6e38\u620f\u8fd0\u884c\u671f\u95f4\u66ff\u6362\u4f60\u7684\u4ee3\u7801\u5e76\u91cd\u8f7d\u8d44\u6e90, \u5b83\u76ee\u524d\u8fd8\u5728 wip \u72b6\u6001. \u8981\u5f00\u542f\u8fd9\u9879\u529f\u80fd, \u9996\u5148\u5230\u4f60\u7684\u851a\u84dd\u6839\u76ee\u5f55\u4e0b\u7684 Saves \u76ee\u5f55, \u627e\u5230\u5e76\u6253\u5f00 <code>modsettings-Everest.celeste</code> \u8fd9\u4e2a\u6587\u4ef6, \u7ffb\u5230\u5927\u6982\u4e2d\u95f4\u7684\u4f4d\u7f6e, \u627e\u5230\u5c5e\u6027 <code>CodeReload_WIP</code>, \u5c06\u5176\u66f4\u6539\u4e3a <code>true</code>, \u6b64\u65f6\u91cd\u65b0\u7f16\u8bd1\u4f60\u7684\u9879\u76ee, \u4f60\u5e94\u8be5\u5c31\u4e0d\u4f1a\u518d\u5f97\u5230\u4efb\u4f55\u9519\u8bef, \u5e76\u4e14 everest \u4e5f\u6b63\u786e\u5730\u70ed\u91cd\u8f7d\u4e86\u4f60\u7684 mod \u548c\u4f60\u7684 mod \u8d44\u6e90.</p>"},{"location":"begin/basic_env/#_6","title":"\u6700\u540e\u4e00\u4e9b\u788e\u788e\u5ff5","text":"<p>\u8fd9\u4e00\u8282\u5b8c\u6210\u540e\u4f60\u7684\u76ee\u5f55\u7ed3\u6784\u5927\u6982\u4f1a\u50cf\u662f:</p> <ul> <li>MyCelesteMod (\u4f60\u7684\u6839\u76ee\u5f55)<ul> <li>ModFolder<ul> <li>everest.yaml</li> <li>MyCelesteMod.dll</li> <li>MyCelesteMod.pdb</li> </ul> </li> <li>CelesteMod.props</li> <li>CelesteMod.targets</li> <li>Common.props</li> <li>MyCelesteMod.csproj</li> <li>MyCelesteModModule.cs</li> </ul> </li> </ul> <p>\u5176\u4e2d\u6b63\u5982\u4e4b\u524d\u6240\u4ecb\u7ecd\u7684, \u6211\u63a8\u8350\u5982\u679c\u4f60\u4f7f\u7528\u8be5\u6a21\u677f\u7684\u8bdd, mod \u7684\u8d44\u6e90\u6587\u4ef6\u5e94\u8be5\u653e\u5728 <code>ModFolder</code> \u4e2d, \u7136\u540e\u5c31\u50cf\u5f80\u5e38\u4e00\u6837\u653e\u7f6e\u4f60\u7684 mod \u8d44\u6e90, \u5f53\u4f60\u7684\u9879\u76ee\u5728\u6784\u5efa\u65f6\u5b83\u4eec\u4f1a\u81ea\u52a8\u88ab\u590d\u5236. \u5982\u679c\u4f60\u6ca1\u6709\u66f4\u6539\u4f60\u7684\u9879\u76ee\u800c\u53ea\u66f4\u6539\u4e86\u8d44\u6e90\u6587\u4ef6\u65f6\u4f60\u4f1a\u53d1\u73b0\u7f16\u8bd1\u9879\u76ee\u4f1a\u56e0\u4e3a\"\u6240\u6709\u6587\u4ef6\u90fd\u662f\u6700\u65b0\u7684\"\u800c\u8df3\u8fc7\u7f16\u8bd1, \u800c\u540c\u65f6\u4e5f\u4f1a\u8df3\u8fc7\u6211\u4eec\u7684\u8d44\u6e90\u590d\u5236, \u5bf9\u6b64\u7684\u8bdd\u6211\u4eec\u6709\u4e24\u79cd\u89e3\u51b3\u65b9\u6848:</p> <ul> <li>\u76f4\u63a5\u5f3a\u5236\u91cd\u65b0\u6784\u5efa\u9879\u76ee (vs\u4e2d \"\u751f\u6210\" -&gt; \"\u91cd\u65b0\u751f\u6210\u9879\u76ee\")</li> <li>\u5728\u9879\u76ee\u6839\u76ee\u5f55\u6267\u884c <code>msbuild -target:PostModBuild</code> \u547d\u4ee4\u884c</li> </ul> <p>\u597d\u50cf\u662f\u6709\u66f4\u597d\u7684\u89e3\u51b3\u65b9\u6cd5, \u4e0d\u8fc7\u9274\u4e8e\u672c\u4eba MSBuild \u77e5\u8bc6\u4e0d\u8db3\u53ea\u80fd\u505a\u6210\u8fd9\u6837\u4e86(x</p>"},{"location":"begin/celeste_everest_monomod/","title":"Celeste Everest MonoMod","text":""},{"location":"begin/celeste_everest_monomod/#celeste","title":"Celeste","text":"<p>\u989d, \u6765\u8fd9\u91cc\u7684\u5e94\u8be5\u90fd\u77e5\u9053 Celeste \u662f\u4ec0\u4e48\u5427(( \u540e\u6587\u4e2d\u63d0\u5230\u7684 <code>Celeste</code>, <code>\u851a\u84dd</code> \u90fd\u4f1a\u53ea\u6307 Celeste \u8fd9\u4e2a\u6e38\u620f, \u4e5f\u5c31\u662f\u6211\u4eec\u6b63\u5728\u5b66\u4e60\u4e3a\u5176\u5236\u4f5c mod \u7684\u5bf9\u8c61.</p>"},{"location":"begin/celeste_everest_monomod/#everest","title":"Everest","text":"<p>\u4f5c\u4e3a\u4e00\u4e2a\u851a\u84dd\u7684 mod \u73a9\u5bb6, \u5b89\u88c5 Everest \u662f\u5fc5\u4e0d\u53ef\u5c11\u7684\u6b65\u9aa4, \u56e0\u4e3a\u6211\u4eec\u7684 mod \u4f9d\u8d56\u4e8e\u5b83\u6240\u63d0\u4f9b\u7684\u5236\u4f5c mod \u4e2d\u6240\u5fc5\u987b\u7684\u4e1c\u897f. \u5b83\u5f00\u6e90\u5728Github\u4e0a. \u53ef\u80fd\u4f60\u8fd8\u542c\u8fc7 Olympus, \u5b83\u662f\u4e00\u4e2a Everest \u7684\u5b89\u88c5\u5668, \u4e5f\u662f\u4e00\u4e2a mod \u7ba1\u7406\u5668.</p> <p>\u5982\u679c\u4f60\u8fd8\u73a9\u8fc7 Minecraft \u7684\u8bdd\u6211\u4eec\u53ef\u4ee5\u5efa\u7acb\u4e00\u4e2a\u8fd9\u6837\u7684\u5947\u5999\u5173\u7cfb:</p> \u851a\u84dd\u4fa7 MC\u4fa7 Celeste Minecraft Everest Forge/Fabric Olympus PCL2/HCML <p>\u989d\u5916\u5730, Everest, Forge, Fabric \u8fd9\u4e00\u7c7b\u4e1c\u897f\u6211\u4eec\u5bf9\u5176\u6709\u4e2a\u7edf\u79f0, \u53eb\u505a <code>ModApi</code>. \u5c31\u50cf Celeste \u548c Minecraft \u88ab\u7edf\u79f0\u4e3a\u6e38\u620f\u672c\u4f53/\u539f\u7248.</p>"},{"location":"begin/celeste_everest_monomod/#monomod","title":"MonoMod","text":"<p>Everest \u5e95\u5c42\u57fa\u4e8e MonoMod, \u5728\u8fd9\u91cc\u4f60\u53ea\u9700\u8981\u77e5\u9053 Everest \u4f9d\u8d56\u4e86 MonoMod, \u540c\u6837\u5730\u8fd9\u4e5f\u662f\u4e00\u4e2a\u5f00\u6e90\u9879\u76ee(Github), \u6709\u8da3\u7684\u662f, Everest \u7684\u4e3b\u8981\u7ef4\u62a4\u8005\u4e4b\u4e00\u4e5f\u662f MonoMod \u7684\u4e3b\u8981\u7ef4\u62a4\u8005, \u540c\u65f6 MonoMod \u4e5f\u662f\u4e00\u4e9b\u5176\u4ed6\u6e38\u620f\u7684 mod \u5e95\u5c42, \u6bd4\u5982 Terraria \u7684 tModLoader, Fez \u7684 FEZMod \u7b49\u7b49.</p> <p>\u90a3\u4e48\u5728\u8fd9\u4e09\u4e2a\u57fa\u7840\u6982\u5ff5\u4e86\u89e3\u4e4b\u540e\u4f60\u5c31\u53ef\u4ee5\u5f00\u59cb\u5236\u4f5c\u4f60\u7684\u7b2c\u4e00\u4e2a mod\u4e86: \u57fa\u7840\u73af\u5883\u914d\u7f6e</p>"},{"location":"begin/hook%2Creading_1/","title":"\u94a9\u5b50, \u9605\u8bfb\u4ee3\u7801, demo1","text":""},{"location":"begin/hook%2Creading_1/#_1","title":"\u524d\u8a00","text":"<p>\u5728\u8fd9\u4e00\u8282, \u6211\u4eec\u4f1a\u4ecb\u7ecd\u5728\u5236\u4f5c mod \u4e2d\u7684\u4e00\u4e2a\u5f88\u91cd\u8981\u7684\u6280\u672f: \u94a9\u5b50(Hook), \u6211\u4eec\u4e3b\u8981\u4ecb\u7ecd On \u94a9\u5b50, \u5728\u4e4b\u540e\u6211\u4eec\u4f1a\u9605\u8bfb\u851a\u84dd\u7684\u4ee3\u7801, \u6700\u540e\u6211\u4eec\u4f1a\u5236\u4f5c\u4e00\u4e2a\u4fee\u6539\u73a9\u5bb6\u51b2\u523a\u6570\u7684\u5c0f demo.</p>"},{"location":"begin/hook%2Creading_1/#on","title":"\u94a9\u5b50 (\u7279\u6307 On \u94a9\u5b50)","text":"<p>\u5bf9\u4e8e C# \u7684\u4e00\u4e2a\u666e\u901a\u7684\u51fd\u6570\u6765\u8bf4, \u5b83\u88ab\u8c03\u7528\u65f6\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684:</p> <pre><code>graph LR\n    A[\u8c03\u7528\u65b9] --&gt; B[\u5373\u5c06\u8c03\u7528\u8be5\u51fd\u6570];\n    subgraph \u8be5\u51fd\u6570\n    B --&gt; C[\u8be5\u51fd\u6570\u4e3b\u4f53];\n    C --&gt; D[\u7ed3\u675f\u8c03\u7528\u8be5\u51fd\u6570];\n    end\n    D --&gt; E[\u8c03\u7528\u65b9];</code></pre> <p>\u5f53\u6211\u4eec\u5f15\u5165\u94a9\u5b50\u6280\u672f\u540e, \u8fd9\u4e2a\u51fd\u6570\u8c03\u7528\u65f6\u4f1a\u50cf\u88ab\"\u94a9\"\u4f4f\u4e00\u6837\u8f6c\u8eab\u53bb\u8c03\u7528\u6211\u4eec\u7684\u51fd\u6570:</p> <pre><code>graph LR\n    A[\u8c03\u7528\u65b9]; B[\u5373\u5c06\u8c03\u7528\u8be5\u51fd\u6570];\n    F[\u94a9\u5b50]; G[\u6211\u4eec\u7684\u51fd\u6570];\n    H[\u8be5\u51fd\u6570\u4e3b\u4f53];\n    D[\u7ed3\u675f\u8c03\u7528\u8be5\u51fd\u6570];\n    E[\u8c03\u7528\u65b9];\n    subgraph \u8be5\u51fd\u6570\n    B; H; D;\n    end\n    A --&gt; B;\n    B --&gt; F;\n    F --&gt; G;\n    H --&gt; D;\n    G --&gt; H;\n    G -.\u6216\u8005.-&gt; D;\n    D --&gt; E;</code></pre> <p>\u5982\u56fe\u6240\u89c1, \u8be5\u94a9\u5b50\u5141\u8bb8\u4f60\u5728\u8c03\u7528\u67d0\u4e2a\u51fd\u6570\u65f6\u8f6c\u8eab\u53bb\u8c03\u7528\u6211\u4eec\u7684\u51fd\u6570, \u540c\u65f6\u4f60\u80fd\u9009\u62e9\u6211\u4eec\u7684\u51fd\u6570\u6267\u884c\u5b8c\u540e\u662f\u5426\u518d\u6267\u884c\u56de\u539f\u51fd\u6570.</p> <p>\u5728 Everest \u4e2d, \u501f\u52a9\u4e8e MonoMod \u7684\u6280\u672f, \u521b\u5efa\u4e00\u4e2a On \u94a9\u5b50\u7b80\u5355\u7684\u5c31\u50cf:</p> \u7b80\u5355\u7684\u94a9\u53d6...<pre><code>public override void Load()\n{\n    On.Celeste.Player.Update += Player_Update;\n}\n\nprivate void Player_Update(On.Celeste.Player.orig_Update orig, Player self)\n{\n    orig(self);\n}\n\npublic override void Unload()\n{\n    On.Celeste.Player.Update -= Player_Update;\n}\n</code></pre> <p>\u5728\u4e0a\u9762\u7684\u4ee3\u7801\u4e2d\u6211\u4eec\u4f7f\u7528\u7c7b\u4f3c\u8ba2\u9605\u4e8b\u4ef6\u7684\u8bed\u6cd5\u53bb\u94a9\u4f4f\u4e86 <code>Player</code> \u7c7b\u7684 <code>Update</code> \u65b9\u6cd5(\u8be5\u65b9\u6cd5\u6bcf\u5e27\u90fd\u4f1a\u8c03\u7528\u4e00\u904d), Everest \u4e3a\u6211\u4eec\u628a\u51e0\u4e4e\u6240\u6709\u53ef\u80fd\u94a9\u53d6\u7684\u51fd\u6570\u653e\u5230\u4e86\u547d\u540d\u7a7a\u95f4 <code>On</code> \u4e2d, \u5f53\u4f60\u60f3\u94a9\u53d6\u67d0\u4e2a\u65b9\u6cd5\u65f6\u53ea\u9700\u901a\u8fc7 <code>On</code> \u547d\u540d\u7a7a\u95f4\u4e00\u8def\"\u70b9\"\u5230\u4f60\u60f3\u8981\u7684\u65b9\u6cd5\u4e0a, \u7136\u540e\u4f7f\u7528\u4e00\u4e2a\u94a9\u5b50\u51fd\u6570\u4ee5\u50cf\u4e8b\u4ef6\u4e00\u6837\u7684\u8bed\u6cd5\"\u8ba2\u9605\"\u5c31\u80fd\u94a9\u4f4f\u5b83! \u5728\u8fd9\u91cc\u6211\u4eec\u7684\u94a9\u5b50\u51fd\u6570\u5c31\u662f<code>Player_Update</code>, \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u53c2\u6570\u5f88\u590d\u6742, \u662f\u7684, \u6240\u4ee5\u4e00\u822c\u6765\u8bf4\u6211\u90fd\u662f\u4f9d\u8d56 IDE \u5e2e\u6211\u81ea\u52a8\u586b\u5199\u8fd9\u4e9b\u53c2\u6570\u5c31\u50cf:  </p> <p> </p> <p></p> <p>Note</p> <p>\u6ce8\u610f IDE \u751f\u6210\u7684\u51fd\u6570\u9ed8\u8ba4\u5305\u542b\u4e00\u53e5\u629b\u51fa\u5f02\u5e38\u8bed\u53e5, \u8bb0\u5f97\u628a\u5b83\u6539\u6389</p> <p><code>orig</code> \u53c2\u6570\u662f\u4e00\u4e2a\u59d4\u6258, \u8c03\u7528\u5b83\u5c31\u76f8\u5f53\u4e8e\u8c03\u7528\u8fd9\u4e2a\u94a9\u5b50\u94a9\u4f4f\u7684\u539f\u51fd\u6570, \u4e5f\u5c31\u662f\u8bf4\u4f60\u53ef\u4ee5\u5728\u8be5\u51fd\u6570\u8c03\u7528\u524d\u505a\u4e9b\u4e8b, \u4e5f\u53ef\u4ee5\u5728\u8be5\u51fd\u6570\u8c03\u7528\u540e\u505a\u4e9b\u4e8b, \u6216\u8005\u5e72\u8106\u4e0d\u8c03\u7528\u8fd9\u4e2a\u51fd\u6570, \u751a\u81f3\u8c03\u7528\u8fd9\u4e2a\u51fd\u6570\u591a\u6b21. \u901a\u5e38\u6765\u8bf4\u6211\u4eec\u90fd\u4f1a\u5728\u672b\u5c3e\u7b80\u5355\u7684\u8c03\u7528\u56de\u53bb\u907f\u514d\u9020\u6210\u4e0d\u5fc5\u8981\u7684\u9ebb\u70e6.</p> \u4e00\u4e9b\u94a9\u5b50\u672c\u8eab...<pre><code>private void Player_Update(On.Celeste.Player.orig_Update orig, Player self)\n{\n    // \u5728\u8fd9\u4e4b\u524d\u505a\u4e00\u4e9b\u4e8b...\n\n    // \u5f53\u67d0\u4e9b\u5947\u602a\u7684\u6761\u4ef6\u4e0d\u6210\u7acb\u65f6\u6211\u4eec\u624d\u8c03\u7528\u56de\u53bb\u539f\u6765\u7684\u51fd\u6570...\n    if (!xxx)\n        orig(self);\n\n    // \u5728\u8fd9\u4e4b\u540e\u505a\u4e00\u4e9b\u4e8b...\n}\n</code></pre> <p>\u5982\u679c\u4f60\u94a9\u53d6\u5230\u7684\u662f\u4e00\u4e2a\u6210\u5458\u51fd\u6570(\u4e5f\u53eb\u6210\u5458\u65b9\u6cd5), \u90a3\u4e48\u53c2\u6570\u901a\u5e38\u4f1a\u5e26\u6709\u4e00\u4e2a <code>self</code>, \u5b83\u8868\u793a\u6267\u884c\u8fd9\u4e2a\u6210\u5458\u51fd\u6570\u65f6 <code>this</code> \u7684\u503c, \u90a3\u4e48\u81ea\u7136\u5730\u5982\u679c\u4f60\u94a9\u53d6\u7684\u662f\u4e00\u4e2a\u9759\u6001\u51fd\u6570\u90a3\u4e48\u662f\u6ca1\u6709\u8fd9\u4e2a\u53c2\u6570\u7684. \u5982\u679c\u4f60\u94a9\u53d6\u7684\u51fd\u6570\u662f\u5e26\u53c2\u6570\u7684, \u90a3\u4e48\u53c2\u6570\u5217\u8868\u4f1a\u539f\u5c01\u4e0d\u52a8\u7684\u6392\u5217\u5728\u524d\u9762\u63d0\u5230\u7684\u53c2\u6570\u7684\u540e\u9762.  </p> <p>\u6bd4\u5982\u4f60\u5c1d\u8bd5\u94a9\u53d6 <code>Player.Jump</code> \u51fd\u6570\u65f6, \u5b83\u7684\u4e09\u4e2a\u53c2\u6570\u4f1a\u8fd9\u6837\u4f20\u9012\u7ed9\u4f60:</p> <pre><code>private void Player_Jump(On.Celeste.Player.orig_Jump orig, Player self, bool particles, bool playSfx)\n</code></pre> <p>\u6700\u540e, \u4e0d\u8981\u5fd8\u8bb0\u5728 <code>Unload</code> \u65b9\u6cd5\u91cc\u53d6\u6d88\u6389\u6211\u4eec\u7684\u94a9\u5b50(\u901a\u8fc7<code>-=</code>), \u9632\u6b62\u6211\u4eec\u7684\u94a9\u5b50\u5728\u4e0d\u5fc5\u8981\u7684\u5730\u65b9\u4ea7\u751f\u4e0d\u597d\u7684\u5f71\u54cd: \u53d6\u6d88\u94a9\u5b50<pre><code>public override void Unload()\n{\n    On.Celeste.Player.Update -= Player_Update;\n}\n</code></pre></p>"},{"location":"begin/hook%2Creading_1/#i","title":"\u9605\u8bfb\u4ee3\u7801 I","text":"<p>\u5230\u8fd9\u91cc\u4f60\u662f\u5426\u6709\u5f88\u591a\u95ee\u53f7(((, \u6bd4\u5982\u8fd9\u4e9b\u51fd\u6570\u90fd\u662f\u5e72\u4ec0\u4e48\u7684? </p> <ul> <li><code>Player</code> \u662f\u4ec0\u4e48?</li> <li><code>Player.Update</code> \u662f\u4ec0\u4e48?</li> <li><code>Player.Jump</code> \u53c8\u662f\u4ec0\u4e48??</li> </ul> <p>\u6240\u4ee5\u8fd9\u65f6\u6211\u4eec\u5c31\u9700\u8981\u9605\u8bfb\u851a\u84dd\u7684\u4ee3\u7801\u6765\u4e86\u89e3\u8fd9\u4e9b\u4e1c\u897f. \u5f53\u7136, \u851a\u84dd\u662f\u4e2a\u5546\u4e1a\u6e38\u620f, \u60f3\u6307\u671b\u5b83\u5f00\u6e90\u6240\u6709\u4ee3\u7801\u662f\u4e0d\u53ef\u80fd\u7684, \u90a3\u6211\u4eec\u5c31\u5fc5\u987b\u5f97\u501f\u52a9\u4e00\u4e9b\u53cd\u7f16\u8bd1\u5de5\u5177. \u5728\u8fd9\u91cc\u6211\u4f1a\u63a8\u8350 <code>dnSpy</code></p> <p>\u4f7f\u7528\u8be5\u8f6f\u4ef6\u5f88\u7b80\u5355:</p> <ul> <li>\u6253\u5f00\u5b83</li> <li>\u70b9\u51fb\u5de6\u4e0a\u89d2\u7684<code>\u6587\u4ef6</code>, <code>\u6253\u5f00</code></li> <li>\u9009\u62e9 <code>Celeste.exe</code></li> <li>\u5c55\u5f00\u851a\u84dd\u7684\u7a0b\u5e8f\u96c6</li> <li>\u4f60\u73b0\u5728\u53ef\u4ee5\u770b\u5230\u851a\u84dd\u90fd\u6709\u54ea\u4e9b\u7c7b\u4e86</li> <li>\u4f60\u73b0\u5728\u4e5f\u53ef\u4ee5\u770b\u5230\u851a\u84dd\u90fd\u6709\u54ea\u4e9b\u51fd\u6570\u4e86</li> </ul> <p>Warning</p> <p>\u4e0d\u8981\u4e0a\u4f20\u53cd\u7f16\u8bd1\u540e\u7684\u4ee3\u7801\u5230\u4efb\u4f55\u5730\u65b9, \u8fd9\u53ef\u80fd\u4f1a\u4e0d\u907f\u514d\u7684\u9020\u6210\u4e00\u4e9b\u4e89\u8bae.</p> <p>\u73b0\u5728\u6211\u4eec\u6d4f\u89c8\u851a\u84dd\u7684\u4ee3\u7801\u5c31\u50cf\u4f60\u5728 IDE \u91cc\u6d4f\u89c8\u4f60\u7684\u9879\u76ee\u4e00\u6837, \u867d\u7136\u8fd9\u4e0d\u662f\u6211\u4eec\u7684\u9879\u76ee. \u5728\u6d4f\u89c8\u8fc7\u7a0b\u4e2d, \u901a\u5e38\u53ef\u80fd\u4f60\u4f1a\u5bf9\u7740\u4e00\u4e2a\u5b57\u6bb5\u3001\u4e00\u4e2a\u51fd\u6570\u53d1\u5446, \u5927\u6982\u662f\u56e0\u4e3a\u4f60\u6839\u672c\u4e0d\u77e5\u9053\u5b83\u662f\u505a\u4ec0\u4e48\u7684! \u597d\u5728 <code>dnSpy</code> \u63d0\u4f9b\u4e86\u4e00\u4e2a\u5f88\u597d\u7528\u7684\"\u5206\u6790\"\u529f\u80fd\u6765\u7f13\u89e3\u8fd9\u4e2a :  \u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u770b\u5230\u54ea\u4e9b\u5b57\u6bb5\u3001\u54ea\u4e9b\u51fd\u6570\u88ab\u8c01\u8c03\u7528\u4e86\u3001\u88ab\u8c01\u5f15\u7528\u4e86\u3001\u88ab\u8c01\u66f4\u6539\u4e86:  </p>"},{"location":"begin/hook%2Creading_1/#monocle-ec","title":"Monocle, EC \u67b6\u6784","text":"<p>\u5728\u8fd9\u91cc\u6211\u4f1a\u7b80\u5355\u4ecb\u7ecd\u4e00\u4e0b\u6574\u4e2a\u851a\u84dd\u662f\u600e\u4e48\u7ec4\u7ec7\u8d77\u6765\u7684. \u9996\u5148\u851a\u84dd\u57fa\u4e8e <code>Monocle</code> \u5f15\u64ce, \u8fd9\u662f <code>matt</code> \u81ea\u5df1\u5f00\u53d1\u7684\u4e00\u4e2a\u5f15\u64ce, \u6240\u4ee5\u522b\u6307\u671b\u4f60\u80fd\u5728\u7f51\u4e0a\u627e\u5230\u5b83\u7684\u6559\u7a0b(, \u5176\u6b21 <code>Monocle</code> \u518d\u6b21\u4f9d\u8d56 <code>Monogame</code> \u6216\u8005 <code>FNA</code>, \u5b83\u4eec\u90fd\u662f\u5fae\u8f6f\u7684 <code>XNA</code> \u6846\u67b6\u7684\u91cd\u65b0\u5b9e\u73b0(\u56e0\u4e3a <code>XNA</code> \u65e9\u505c\u66f4\u4e86), <code>XNA</code> \u63d0\u4f9b\u7684 api \u90fd\u975e\u5e38\u539f\u59cb, \u751a\u81f3\u8fde\u6700\u57fa\u672c\u7684\u573a\u666f\u7ec4\u7ec7\u4e4b\u7c7b\u7684\u90fd\u6ca1\u6709, \u90a3\u4e48 <code>Monocle</code> \u5c31\u662f\u6765\u5b9e\u73b0\u8fd9\u4e9b\u7684.  </p> <p>\u901a\u5e38\u6765\u8bf4\u4e00\u4e2a\u6b63\u5728\u8fd0\u884c\u7684 <code>Monocle</code> \u6e38\u620f\u7684\u7ed3\u6784\u5c31\u50cf: <pre><code>graph LR\nR[Engine] --- A;\n\nA[Scene] --- B[Entity A];\nA --- C[Entity B];\nA --- E[Entity ...];\nB --- F[Component A];\nB --- G[Component B];\nC --- H[Component A];\nC --- I[Component C];\nC --- J[Component ...];</code></pre></p> <ul> <li><code>Scene</code> \u8868\u793a\u4e00\u4e2a\u573a\u666f, \u6bd4\u5982\u4e3b\u754c\u9762\u573a\u666f, pico8 \u573a\u666f, \u4ee5\u53ca\u6700\u5e38\u89c1\u7684 gameplay \u573a\u666f.  </li> <li><code>Entity</code> \u8868\u793a\u4e00\u4e2a\u5b9e\u4f53, \u6bd4\u5982\u8bf4\u739b\u5fb7\u7433\u5c31\u662f\u4e00\u4e2a\u5b9e\u4f53, \u4e00\u4e2a\u5f39\u7403\u662f\u4e00\u4e2a\u5b9e\u4f53, \u4e00\u4e2a\u6ce1\u6ce1\u662f\u4e00\u4e2a\u5b9e\u4f53.</li> <li><code>Component</code> \u8868\u793a\u4e00\u4e2a\u7ec4\u4ef6, \u5b83\u9644\u52a0\u4e0e\u5b9e\u4f53\u4e4b\u4e0a, \u901a\u5e38\u6211\u4eec\u80fd\u76f4\u63a5\u770b\u5230\u7684\u53ea\u6709\u56fe\u7247\u7ec4\u4ef6, \u6bd4\u5982\u5ca9\u6d46\u5757\u7684\u8d34\u56fe\u5c31\u662f\u7531 <code>Image</code> \u7ec4\u4ef6\u6765\u5c55\u73b0\u7684, \u73a9\u5bb6\u7684\u52a8\u753b\u7531 <code>Sprite</code> \u7ec4\u4ef6\u5c55\u73b0.  </li> </ul> <p>Info</p> <p>\u4ee5\u4e0a\u8fd9\u4e2a\u67b6\u6784\u6211\u4eec\u5c31\u79f0\u4e3a <code>EC</code> \u67b6\u6784, \u5b83\u662f\u6e38\u620f\u7684\u4e00\u79cd\u7ec4\u7ec7\u65b9\u5f0f\u7684\u5b9e\u73b0.  </p> <p>\u901a\u5e38\u5730, \u6bcf\u8fc7 <code>1/60</code> \u79d2, <code>Engine</code> \u5c31\u4f1a\u88ab\u8c03\u7528\u5b83\u7684 <code>Update()</code> \u51fd\u6570\u7528\u6765\u66f4\u65b0\u6e38\u620f\u903b\u8f91, <code>Engine.Update()</code> \u5185\u90e8\u4f1a\u518d\u6b21\u8c03\u7528 <code>Scene</code> \u7684 <code>Update()</code> \u51fd\u6570, <code>Scene.Update()</code> \u5185\u90e8\u4f1a\u904d\u5386\u5b83\u6240\u6709\u7684 <code>Entity</code> \u5e76\u8c03\u7528\u5b83\u4eec\u7684 <code>Update()</code> \u51fd\u6570, <code>Entity.Update()</code> \u5185\u90e8\u8fd8\u4f1a\u904d\u5386\u5b83\u6240\u6709\u7684 <code>Component</code> \u5e76\u8c03\u7528\u5b83\u4eec\u7684 <code>Update()</code> \u51fd\u6570.  </p> <p>\u90a3\u4e48\u81ea\u7136, <code>Player.Update()</code> \u5c31\u662f\u739b\u5fb7\u7433\u6bcf\u5e27\u7684\u66f4\u65b0\u903b\u8f91\u6240\u5728\u7684\u5730\u65b9\u4e86. \u73b0\u5728\u6211\u4eec\u505a\u4e00\u4e2a\u5c0f demo, \u5c06\u73a9\u5bb6\u7684\u51b2\u523a\u6570\u91cf\u9501\u6b7b\u4e3a\u5355\u51b2.  </p>"},{"location":"begin/hook%2Creading_1/#-demo1","title":"\u9501\u5b9a\u5355\u51b2 - demo1","text":"<p>\u901a\u8fc7\u7b80\u5355\u7684\u6d4f\u89c8\u851a\u84dd\u7684\u4ee3\u7801, \u4f60\u4e86\u89e3\u5230(\u6ca1\u4e86\u89e3\u5230\u4e5f\u6b63\u5e38, \u540e\u9762\u4f1a\u8bf4\u4e00\u4e9b\u5e38\u89c1\u7c7b\u548c\u7ed3\u6784\u5e2e\u52a9\u4f60\u7406\u89e3) <code>Player.Dashes</code> \u8fd9\u4e2a\u5b57\u6bb5\u50a8\u5b58\u4e86\u73a9\u5bb6\u7684\u51b2\u523a\u6570\u91cf, \u90a3\u4e48\u73b0\u5728\u6211\u4eec\u5c06\u5b83\u9501\u5b9a\u4e3a 1, \u4e5f\u5c31\u662f\u5355\u51b2. \u9996\u5148\u6211\u4eec\u94a9\u53d6 <code>Player.Update()</code>, \u7136\u540e\u5728\u786e\u4fdd\u8c03\u7528\u56de\u539f\u6765\u7684\u51fd\u6570\u540e\u76f4\u63a5\u5c06 <code>Dashes</code> \u5f3a\u5236\u4fee\u6539\u4e3a 1.</p> \u9501\u5b9a\u51b2\u523a\u4e3a1!<pre><code>public override void Load()\n{\n    On.Celeste.Player.Update += Player_Update;\n}\n\nprivate void Player_Update(On.Celeste.Player.orig_Update orig, Player self)\n{\n    self.Dashes = 1;\n    orig(self);\n}\n\npublic override void Unload()\n{\n    On.Celeste.Player.Update -= Player_Update;\n}\n</code></pre> <p>\u90a3\u4e48\u73b0\u5728\u7f16\u8bd1, \u6309\u4e4b\u524d\u7684\u5185\u5bb9\u64cd\u4f5c, \u5e76\u91cd\u542f\u851a\u84dd, \u4f60\u5e94\u8be5\u5c31\u4f1a\u770b\u5230\u4f60\u7684\u739b\u5fb7\u7433\u6c38\u8fdc\u90fd\u4f1a\u6709\u5355\u51b2\u4e86(\u5373\u4f7f\u662f\u5728\u7a7a\u4e2d!).</p>"},{"location":"begin/hook%2Creading_1/#_2","title":"\u94a9\u5b50\u7684\u6700\u4f73\u5b9e\u8df5","text":"<p>\u6211\u4eec\u5e94\u8be5\u5c3d\u53ef\u80fd\u4e00\u6b21\u6027\u5730\u5c31\u5c06\u6211\u4eec\u6240\u9700\u8981\u7684\u6240\u6709\u94a9\u5b50\u5728 <code>Load</code> \u91cc\u52a0\u8f7d\u5b8c, \u56e0\u4e3a\u521b\u5efa\u94a9\u5b50\u5b9e\u9645\u4e0a\u7684\u5f00\u9500\u5e76\u4e0d\u5c0f, \u5982\u679c\u4f60\u9700\u8981\u67d0\u4e9b \"\u67d0\u4e9b\u6761\u4ef6\u4e0d\u6210\u7acb\u4e0d\u542f\u52a8\u94a9\u5b50, \u6761\u4ef6\u6210\u7acb\u518d\u542f\u52a8\u94a9\u5b50\" \u7684\u903b\u8f91\u7684\u8bdd, \u6211\u5efa\u8bae\u4f60\u5e94\u8be5\u59cb\u7ec8\u4fdd\u6301\u94a9\u5b50, \u7136\u540e\u5728\u94a9\u5b50\u5185\u90e8\u5224\u65ad\u4f60\u7684\u6761\u4ef6, \u4e0d\u6210\u7acb\u65f6\u4f60\u5e94\u8be5\u76f4\u63a5\u56de\u8c03\u539f\u6765\u7684\u65b9\u6cd5\u5e76\u4e0d\u505a\u4efb\u4f55\u5176\u4ed6\u4e8b\u60c5.</p>"},{"location":"begin/preference/","title":"\u504f\u597d","text":"<p>\u5728\u672c\u7cfb\u5217\u6559\u7a0b\u4e2d\u672c\u4eba\u53ef\u80fd\u4f1a\u5076\u5c14\u4e60\u60ef\u6027\u7684\u4f7f\u7528\u4e00\u4e9b\u6bd4\u8f83\u65b0\u7684 C# \u8bed\u6cd5\u6216\u8005\u662f\u7279\u6027, \u901a\u5e38\u8fd9\u662f\u5927\u90e8\u5206 C# \u6559\u7a0b\u4e2d\u5f88\u5c11\u63d0\u53ca\u7684, \u6240\u4ee5\u4e3a\u4e86\u907f\u514d\u56f0\u60d1\u6211\u4f1a\u5728\u8fd9\u91cc\u63d0\u53ca\u4ed6\u4eec.</p> <p>Note</p> <p>\u4e3a\u4e86\u4f7f\u7528\u8fd9\u4e9b\u8bed\u6cd5\u4f60\u53ef\u80fd\u9700\u8981\u5b89\u88c5 <code>.NET 6 SDK</code>, \u5982\u679c\u4f60\u65e0\u6cd5\u7406\u89e3\u67d0\u4e9b\u4e1c\u897f, \u6ca1\u5173\u7cfb, \u4f60\u4f9d\u7136\u53ef\u4ee5\u4f7f\u7528\u540c\u65f6\u63d0\u53ca\u5230\u7684\u7b49\u6548\u65b9\u6cd5</p>"},{"location":"begin/preference/#_2","title":"\u7b80\u5355\u4e86\u89e3\u9879\u76ee\u6587\u4ef6","text":"<p>\u5728\u89e3\u51b3\u65b9\u6848\u8d44\u6e90\u7ba1\u7406\u5668\u4e2d, \u53cc\u51fb\u4f60\u7684\u9879\u76ee, \u6309\u7406\u6765\u8bf4\u4f60\u5e94\u8be5\u4f1a\u6253\u5f00\u8be5\u9879\u76ee\u7684 <code>.csproj</code> \u6587\u4ef6, \u901a\u5e38\u4e5f\u53eb\u505a\u9879\u76ee\u6587\u4ef6, \u5b83\u63cf\u8ff0\u4e86\u8fd9\u4e2a\u9879\u76ee\u7684\u5404\u65b9\u9762\u7684\u4fe1\u606f, \u5e76\u4e14\u4ee5\u4e0b\u51e0\u5c0f\u8282\u7684\u5185\u5bb9\u4e5f\u4f9d\u8d56\u4e8e\u6b64. \u5982\u679c\u4f60\u4f7f\u7528\u7684\u662f\u4ece\u6a21\u677f\u914d\u7f6e\u7684\u73af\u5883, \u90a3\u4e48\u4f60\u5e94\u8be5\u4f1a\u770b\u5230\u5982\u4e0b\u5185\u5bb9:</p> .csproj<pre><code>&lt;Project Sdk=\"Microsoft.NET.Sdk\"&gt;\n    &lt;Import Project=\"CelesteMod.props\" /&gt;\n    &lt;Import Project=\"Common.props\" /&gt;\n    &lt;PropertyGroup&gt;\n        &lt;RootNamespace&gt;$(AssemblyName)&lt;/RootNamespace&gt;\n        &lt;LangVersion&gt;preview&lt;/LangVersion&gt;\n    &lt;/PropertyGroup&gt;\n\n    &lt;ItemGroup&gt;\n        &lt;Reference Include=\"System\" /&gt;\n        &lt;Reference Include=\"System.Core\" /&gt;\n        &lt;Reference Include=\"System.Xml.Linq\" /&gt;\n        &lt;Reference Include=\"System.Xml\" /&gt;\n    &lt;/ItemGroup&gt;\n\n    &lt;Import Project=\"CelesteMod.targets\" /&gt;\n&lt;/Project&gt;\n</code></pre> <p>Note</p> <p>\u8fd9\u4e2a\u6587\u4ef6\u662f XML \u683c\u5f0f\u7684, \u5982\u679c\u4f60\u4e0d\u719f\u6089 XML \u7684\u8bdd\u4f60\u53ef\u4ee5\u5230\u8fd9\u91cc\u7b80\u5355\u770b\u4e00\u4e0b, \u514d\u5f97\u4f60\u4e0d\u77e5\u9053\u6211\u4eec\u8ba8\u8bba\u7684\u4e1c\u897f\u90fd\u662f\u4ec0\u4e48</p> <p>\u5176\u4e2d\u6211\u4eec\u53ea\u9700\u8981\u5173\u6ce8\u91cc\u9762\u7684 <code>PropertyGroup</code> \u4ee5\u53ca <code>ItemGroup</code> \u8282\u70b9 <code>PropertyGroup</code> \u8282\u70b9\u5b9a\u4e49\u4e86\u8fd9\u4e2a\u9879\u76ee\u6709\u54ea\u4e9b\u5c5e\u6027, \u6bd4\u5982\u9879\u76ee\u6846\u67b6\u7248\u672c, \u8bed\u8a00\u7248\u672c, \u7a0b\u5e8f\u96c6\u6635\u79f0\u7b49 <code>ItemGroup</code> \u5219\u5b9a\u4e49\u4e86\u8fd9\u4e2a\u9879\u76ee\u5305\u542b\u4ec0\u4e48, \u6bd4\u5982\u5f15\u7528\u4e86\u54ea\u4e9b\u7a0b\u5e8f\u96c6\u3001\u54ea\u4e9b nuget \u5305\u7b49.</p>"},{"location":"begin/preference/#implicit-usings-using","title":"Implicit Usings (\u9690\u5f0f Using)","text":"<p>Note</p> <p>\u5bf9\u4e8e\u901a\u8fc7\u6a21\u677f\u6784\u5efa\u7684\u9879\u76ee\u6765\u8bf4\u8fd9\u4e00\u6b65\u5df2\u7ecf\u5b8c\u6210, \u4f60\u53ef\u4ee5\u5c1d\u8bd5\u5c06 <code>Common.props</code> \u4e2d\u7684 <code>CommonCelesteUsings</code> \u66f4\u6539\u4e3a <code>false</code> \u6765\u611f\u53d7\u6ca1\u6709\u542f\u7528\u7684\u6548\u679c</p> <p>\u73b0\u5728\u770b\u770b\u4f60\u7684\u6e90\u6587\u4ef6\u5934\u9876\u662f\u4e0d\u662f\u5145\u6ee1\u4e86\u4e00\u5927\u5806 <code>using xxx</code>? \u90a3\u5c31\u5bf9\u4e86, \u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd9\u4e2a\u7279\u6027\u6765\u8ba9\u5b83\u770b\u8d77\u6765\u66f4\u7b80\u4ecb\u4e9b. \u90a3\u4e48\u6253\u5f00\u4f60\u7684\u9879\u76ee\u6587\u4ef6, \u5411\u4f60\u7684 <code>ItemGroup</code> \u4e2d\u52a0\u5165\u8fd9\u4e9b:</p> <pre><code>&lt;Using Include=\"System\"/&gt;\n&lt;Using Include=\"System.Collections.Generic\"/&gt;\n&lt;Using Include=\"System.IO\"/&gt;\n&lt;Using Include=\"System.Linq\"/&gt;\n&lt;Using Include=\"System.Threading\"/&gt;\n&lt;Using Include=\"System.Threading.Tasks\"/&gt;\n</code></pre> <p>\u8fd9\u4e2a\u65f6\u5019\u4f60\u5c31\u53ef\u4ee5\u79fb\u9664\u4f60\u7684\u5927\u90e8\u5206 <code>System</code> \u5f00\u5934\u7684 Using \u8bed\u53e5\u5566, \u8fd9\u88ab\u79f0\u4e3a <code>\u9690\u5f0f Using</code>, \u56e0\u4e3a\u6211\u4eec\u662f\u851a\u84dd mod, \u6240\u4ee5\u6211\u4eec\u7ecf\u5e38\u4e5f\u4f1a Using \u4ee5\u4e0b\u51e0\u4e2a\u547d\u540d\u7a7a\u95f4:</p> <ul> <li><code>Celeste.Mod</code>: \u5305\u542b\u5f88\u591a Everest \u76f8\u5173\u4e1c\u897f</li> <li><code>Celeste</code>: \u851a\u84dd\u672c\u4f53\u6240\u5728\u547d\u540d\u7a7a\u95f4</li> <li><code>Monocle</code>: \u851a\u84dd\u81ea\u5df1\u7684\u6e38\u620f\u5f15\u64ce</li> <li><code>Microsoft.Xna.Framework</code>: \u851a\u84dd\u81ea\u5df1\u7684\u6e38\u620f\u5f15\u64ce\u7684\u5e95\u5c42\u6846\u67b6</li> </ul> <p>\u5bf9\u8fd9\u4e9b\u9690\u5f0f Using \u6211\u4eec\u4e5f\u5411 <code>ItemGroup</code> \u52a0\u5165: <pre><code>&lt;Using Include=\"Celeste.Mod\"/&gt;\n&lt;Using Include=\"Celeste\"/&gt;\n&lt;Using Include=\"Monocle\"/&gt;\n&lt;Using Include=\"Microsoft.Xna.Framework\"/&gt;\n</code></pre></p> <p>\u73b0\u5728\u6253\u5f00\u4f60\u7684\u4ee3\u7801\u6587\u4ef6, \u4f60\u53ef\u4ee5\u5c06\u5934\u9876\u4e0a\u7684\u5927\u90e8\u5206 Using \u90fd\u5220\u9664\u4e86, \u8fd9\u6837, \u4f60\u7684\u4ee3\u7801\u6587\u4ef6\u53d8\u7684\u66f4\u52a0\u7684\u5e72\u51c0\u6574\u6d01: MyModModule.cs<pre><code>namespace MyCelesteMod\n{\n    public class MyModModule : EverestModule\n    {\n        public override void Load()\n        {\n\n            Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World! Hello Everest!\");\n        }\n\n        public override void Unload()\n        {\n\n        }\n    }\n}\n</code></pre></p>"},{"location":"begin/preference/#file-scoped-namespaces","title":"File Scoped Namespaces","text":"<p>\u5bf9\u4e8e namespace \u547d\u540d\u7a7a\u95f4\u6765\u8bf4\u6211\u4eec\u901a\u5e38\u4e00\u4e2a\u6587\u4ef6\u53ea\u6709\u4e00\u4e2a\u547d\u540d\u7a7a\u95f4, \u90a3\u4e48\u6700\u5916\u5c42\u7684 namespace \u7684\u7f29\u8fdb\u5c31\u6709\u4e9b\u6d6a\u8d39\u6a2a\u5411\u7a7a\u95f4, \u6240\u4ee5\u6211\u4eec\u9009\u62e9\u4f7f\u7528 <code>File Scoped Namespaces</code>, \u8fd9\u5f88\u7b80\u5355:</p> <ul> <li>\u5728 <code>namespace MyCelesteMod</code> \u540e\u52a0\u4e0a\u4e00\u4e2a\u5206\u53f7</li> <li>\u5220\u9664 namespace \u7684\u4e24\u4e2a\u5927\u62ec\u53f7</li> <li>\u56de\u9000 namespace \u4e0b\u7684\u6240\u6709\u7f29\u8fdb</li> <li>\u641e\u5b9a\u4e86, \u8d70\u4f60!</li> </ul> MyModModule.cs<pre><code>namespace MyCelesteMod;\n\npublic class MyModModule : EverestModule\n{\n    public override void Load()\n    {\n        Logger.Log(LogLevel.Info, \"MyCelesteMod\", \"Hello World! Hello Everest!\");\n    }\n\n    public override void Unload()\n    {\n\n    }\n}\n</code></pre> <p>\u5982\u679c\u4f60\u6536\u5230\u9519\u8bef <code>CS8370</code>, \u90a3\u4f60\u5c31\u9700\u8981\u5728 <code>PropertyGroup</code> \u4e0b\u6dfb\u52a0\u8fd9\u4e00\u884c: <pre><code>&lt;LangVersion&gt;preview&lt;/LangVersion&gt;\n</code></pre></p>"},{"location":"begin/preference/#_3","title":"\u65b9\u6cd5? \u51fd\u6570?","text":"<p>\u55ef\u8fd9\u4e2a\u662f\u540e\u6765\u52a0\u7684, \u56e0\u4e3a\u6211\u53d1\u73b0\u6211\u5728\u6574\u4e2a\u6587\u6863\u91cc\u90fd\u5728\u6df7\u7528\"\u65b9\u6cd5\"\u548c\"\u51fd\u6570\"\u8fd9\u4e24\u4e2a\u540d\u5b57, \u4f46\u662f\u4fee\u6539\u8d77\u6765\u6bd4\u8f83\u9ebb\u70e6\u6240\u4ee5\u6211\u8fd8\u662f\u9009\u62e9\u5728\u8fd9\u91cc\u8bf4\u51e0\u53e5: \"\u51fd\u6570\"\u662f\u6e90\u81ea\u53e4\u65e9\u7684\u9762\u5411\u8fc7\u7a0b\u8bed\u8a00\u7684\u6982\u5ff5, \u540e\u6765\u968f\u7740 OOP \u9762\u5411\u5bf9\u8c61\u601d\u60f3\u7684\u6d41\u884c, \u51fd\u6570\u9010\u6e10\u88ab\u5c01\u88c5\u5230\u7c7b\u91cc, \u800c\u7c7b\u91cc\u7684\u8fd9\u4e9b\u51fd\u6570\u5728\u4e60\u60ef\u4e0a\u6211\u4eec\u4f1a\u79f0\u4e4b\u4e3a\"\u65b9\u6cd5\", \u4f46\u662f\u4e5f\u6709\u4eba\u4ecd\u7136\u5c06\u8fd9\u4e9b\u4e1c\u897f\u79f0\u4e4b\u4e3a\"\u51fd\u6570\", \u6240\u4ee5\u5b9e\u9645\u4e0a\u5728\u9762\u5411\u5bf9\u8c61\u7684\u8bed\u8a00\u91cc\u4f60\u53ef\u4ee5\u5c06\"\u65b9\u6cd5\"\u548c\"\u51fd\u6570\"\u770b\u4e3a\u4e00\u4e2a\u4e1c\u897f, \u6216\u8005\u4ec5\u5728\u672c\u6587\u6863\u4e2d\u8fd9\u4e48\u770b.</p>"},{"location":"begin/reading_2/","title":"\u9605\u8bfb\u4ee3\u7801 II","text":"<p>\u4e00\u4e9b\u60c5\u51b5\u4e0b, \u9605\u8bfb\u7531\u53cd\u7f16\u8bd1\u5668\u751f\u6210\u7684\u4ee3\u7801\u65f6\u53ef\u80fd\u4e0d\u662f\u90a3\u4e48\u987a\u5229, \u90a3\u4e48\u8fd9\u4e00\u8282\u4f1a\u7b80\u5355\u8bf4\u4e00\u4e9b\u53cd\u7f16\u8bd1\u5668\u751f\u6210\u7684\u4ee3\u7801\u4e0e\u901a\u5e38\u7684 C# \u4ee3\u7801\u4e0d\u4e00\u6837\u7684\u5730\u65b9.</p>"},{"location":"begin/reading_2/#_1","title":"\u5947\u5947\u602a\u602a\u7684\u6635\u79f0\u4e0e\u4ee3\u7801","text":"<p>\u5728\u53cd\u7f16\u8bd1\u5668\u4e2d\u53ef\u80fd\u4f1a\u51fa\u73b0\u8fd9\u79cd\u5947\u602a\u7684\u8bed\u6cd5: Celeste.FinalBoss (\u5373 6a \u540e\u534a\u6bb5 Badeline Boss \u5b9e\u4f53)<pre><code>public void orig_ctor(EntityData e, Vector2 offset)\n{\n    this..ctor(e.Position + offset, e.NodesOffset(offset), e.Int(\"patternIndex\", 0), e.Float(\"cameraPastY\", 120f), e.Bool(\"dialog\", false), e.Bool(\"startHit\", false), e.Bool(\"cameraLockY\", true));\n}\n</code></pre></p> <p>\u55ef...\u597d\u7684, \u9996\u5148 <code>orig_ctor</code> \u8fd9\u4e2a\u540d\u5b57\u6709\u70b9\u602a\u4f46\u662f\u80fd\u63a5\u53d7, \u4f46\u662f\u63a5\u4e0b\u6765\u7684 <code>this..ctor</code> \u662f\u4ec0\u4e48? \u5b83\u751a\u81f3\u5728 <code>C#</code> \u4e2d\u662f\u4e2a\u975e\u6cd5\u8bed\u6cd5! \u5176\u5b9e\u8fd9\u5e76\u4e0d\u7f55\u89c1, \u7531\u4e8e Everest \u5bf9\u851a\u84dd\u7a0b\u5e8f\u7684\u4fee\u6539\u5e76\u4e0d\u53ea\u662f\u505c\u7559\u5728\u8868\u9762, \u800c\u66f4\u662f\u6df1\u5165\u5230\u4e86 IL \u4ee3\u7801\u5c42, \u8fd9\u662f\u4e00\u79cd\u76f8\u5bf9\u5e95\u5c42\u7684\u4ee3\u7801, \u4f60\u7684 <code>C#</code> \u4ee3\u7801\u6700\u7ec8\u90fd\u4f1a\u88ab\u7f16\u8bd1\u4e3a <code>IL</code> \u7136\u540e\u6254\u7ed9\u8fd0\u884c\u65f6(runtime)\u6765\u6267\u884c, \u540c\u6837\u5730, \u6240\u6709\u5176\u4ed6\u7684 <code>.NET</code> \u7cfb\u8bed\u8a00\u6bd4\u5982 <code>VB.NET</code> \u548c <code>F#</code> \u4e5f\u90fd\u4f1a\u88ab\u7f16\u8bd1\u4e3a IL. \u90a3\u4e48\u65e2\u7136\u8fd9\u91cc\u7684 IL \u662f\u7531 <code>C#</code> \u7f16\u8bd1\u800c\u6765\u7684, \u90a3\u4e48\u8fd9\u6837\u7684 IL \u591a\u591a\u5c11\u5c11\u4f1a\u6709\u4e00\u79cd \"C# \u5473\", \u53cd\u7f16\u8bd1\u5668\u5c31\u662f\u9760\u8fd9\u79cd\u4e00\u5b9a\u7684 \"C# \u5473\" \u6765\u9006\u63a8\u51fa\u53ef\u80fd\u7684 <code>C#</code> \u6e90\u7801.  \u4f46\u662f\u65e2\u7136\u8fd9\u91cc Everest \u76f4\u63a5\u5728 IL \u4ee3\u7801\u5c42\u8fdb\u884c\u4e86\u4fee\u6539, \u7834\u574f\u4e86\u8fd9\u79cd \"C# \u5473\", \u90a3\u81ea\u7136\u53cd\u7f16\u8bd1\u5668\u5c31\u4f1a\u751f\u6210\u5947\u5947\u602a\u602a\u7684\u4ee3\u7801.</p> <p>\u90a3\u4e48\u539f\u56e0\u8bf4\u5b8c\u4e86, \u63a5\u4e0b\u6765\u5c31\u6765\u89e3\u51b3\u8fd9\u4e9b \"\u662f\u4ec0\u4e48\" \u7684\u95ee\u9898:</p>"},{"location":"begin/reading_2/#ctor-cctor","title":".ctor / .cctor","text":"<p><code>.ctor</code> \u662f\u4e00\u79cd\u7279\u6b8a\u7684\u51fd\u6570\u540d\u79f0, \u8868\u793a\u7c7b\u7684\u6784\u9020\u51fd\u6570, \u6bd4\u5982 <code>Player..ctor(a, b)</code> \u5c31\u8868\u793a\u8fd9\u91cc\u8c03\u7528\u4e86 <code>Player..ctor</code> \u8fd9\u4e2a\u51fd\u6570, \u867d\u7136\u4f60\u81ea\u5df1\u5728 C# \u4e2d\u662f\u505a\u4e0d\u5230\u7684. \u6240\u4ee5\u6211\u4eec\u7ecf\u5e38\u4e5f\u4f1a\u7528 <code>ctor</code> \u6216\u8005 <code>.ctor</code> \u6765\u6307\u4ee3 \"\u6784\u9020\u51fd\u6570\".  </p> <p><code>.cctor</code> \u4e5f\u662f\u4e00\u79cd\u7279\u6b8a\u7684\u51fd\u6570\u540d\u79f0, \u8868\u793a\u7c7b\u7684\u9759\u6001\u6784\u9020\u51fd\u6570, \u6bd4\u5982 <code>Input..cctor()</code> \u5c31\u8868\u793a\u8c03\u7528 <code>Input</code> \u7c7b\u7684\u65e0\u53c2\u9759\u6001\u6784\u9020\u51fd\u6570. \u540c\u6837\u5730\u6211\u4eec\u901a\u5e38\u4e5f\u4f1a\u7528 <code>cctor</code> \u6216\u8005 <code>.cctor</code> \u6765\u6307\u4ee3 \"\u9759\u6001\u6784\u9020\u51fd\u6570\".</p> <p>\u8fd9\u4e00\u7c7b\u51fd\u6570\u5728 <code>IL</code> \u5c42\u6709\u4e2a\u6807\u8bb0\u53eb <code>special name</code>, \u5f53\u53cd\u7f16\u8bd1\u5668\u53d1\u73b0\u4e00\u4e2a\u65b9\u6cd5\u540d\u4e3a <code>.ctor</code> \u4e14\u5e26\u6709 <code>special name</code> \u6807\u8bb0\u7684\u65b9\u6cd5\u65f6, \u53cd\u7f16\u8bd1\u5668\u5c31\u4f1a\u8ba4\u4e3a\u5b83\u662f\u4e00\u4e2a\u6784\u9020\u51fd\u6570, \u5982\u679c\u53cd\u7f16\u8bd1\u5668\u53d1\u73b0\u8fd9\u4e2a\u65b9\u6cd5\u5728\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u5f00\u5934\u8c03\u7528\u4e86, \u90a3\u4e48\u53cd\u7f16\u8bd1\u5668\u5c31\u4f1a\u8ba4\u4e3a\u8fd9\u4e2a\u6784\u9020\u51fd\u6570\u5e26\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u94fe, \u4f46\u662f\u5982\u679c\u5b83\u7684\u8c03\u7528\u4f4d\u7f6e\u5728\u5176\u4ed6\u4f4d\u7f6e, \u540c\u65f6\u53c8\u56e0\u4e3a <code>C#</code> \u7f16\u8bd1\u5668\u662f\u4e0d\u53ef\u80fd\u7f16\u8bd1, \u90a3\u4e48\u53cd\u7f16\u8bd1\u5668\u5c31\u4f1a\u4e0d\u77e5\u6240\u63aa, \u53ea\u80fd\u65e0\u5948\u7684\u751f\u6210 <code>xxx..ctor()</code> \u8fd9\u79cd\u9519\u8bef\u7684\u8bed\u6cd5. \u8fd9\u4e5f\u662f\u6211\u4eec\u4e0a\u9762\u770b\u5230\u7684 <code>this..ctor</code> \u8fd9\u79cd\u8bed\u6cd5\u88ab\u751f\u6210\u7684\u539f\u56e0, \u56e0\u4e3a\u8fd9\u4e2a\u6784\u9020\u51fd\u6570\u8c03\u7528\u4e0d\u5728\u6784\u9020\u51fd\u6570\u91cc\u51fa\u73b0, \u800c\u662f\u5728\u4e00\u4e2a\u6b63\u5e38\u7684 <code>orig_ctor</code> \u65b9\u6cd5\u91cc\u9762!</p> <p>Info</p> <p>\u5728\u524d\u9762\u7684\u94a9\u5b50\u8282\u6211\u4eec\u6ca1\u6709\u63a2\u8ba8\u8fc7\u6784\u9020\u51fd\u6570\u5982\u4f55\u94a9\u53d6, \u5728\u8fd9\u91cc\u4f60\u53ef\u80fd\u5c31\u4f1a\u660e\u767d, \u94a9\u53d6\u540d\u5b57\u4e3a <code>ctor</code> \u7684\u51fd\u6570\u5c31\u662f\u94a9\u53d6\u4e86\u6784\u9020\u51fd\u6570, \u9759\u6001\u6784\u9020\u51fd\u6570\u540c\u7406.</p>"},{"location":"begin/reading_2/#orig_","title":"orig_*","text":"<p>\u8fd8\u6709\u4e00\u4e9b\u51fd\u6570\u4ee5 <code>orig_</code> \u5f00\u5934, \u8fd9\u5176\u5b9e\u662f everest \u81ea\u5df1\"\u94a9\u53d6\"\u7684\u51fd\u6570. \u5728\u8fd9\u91cc, \u6bd4\u5982 <code>Player.Update</code> \u65b9\u6cd5\u5c31\u88ab everest \u8fdb\u884c\u4e86\"\u94a9\u53d6\", \u800c\u94a9\u5b50\u51fd\u6570\u672c\u4f53\u5c31\u662f <code>Player.Update</code>, \u800c\u5bf9\u5e94\u6211\u4eec\u94a9\u5b50\u7684 <code>orig</code> \u59d4\u6258\u5728\u5c31\u4f53\u73b0\u4e3a <code>orig_Update</code> \u65b9\u6cd5.</p> Player.Update  (\u50cf\u94a9\u5b50\u672c\u4f53\u4e00\u6837!)<pre><code>public override void Update()\n{\n    this.orig_Update(); // \u5c31\u50cf\u5728\u6211\u4eec\u7684\u94a9\u5b50\u91cc\u8c03\u7528 orig \u59d4\u6258\u4e00\u6837\n    // \u5c31\u50cf\u5728\u6211\u4eec\u7684\u94a9\u5b50\u91cc\u5728\u51fd\u6570\u6267\u884c\u5b8c\u540e\u505a\u4e9b\u4e8b\u60c5\u4e00\u6837\n    Level level = base.Scene as Level;\n    if (level == null)\n    ......\n}\n// Player.orig_Update() \u5c31\u50cf\u6211\u4eec\u7684\u94a9\u5b50\u94a9\u53d6\u7684\u539f\u51fd\u6570!\n</code></pre> <p>Info</p> <p>\u5982\u679c\u4f60\u81ea\u884c\u94a9\u53d6 <code>Player.Update</code> \u51fd\u6570\u8fd9\u79cd\u5df2\u88ab everest \"\u94a9\u53d6\" \u7684\u51fd\u6570\u5b9e\u9645\u4e0a\u4f60\u94a9\u53d6\u7684\u662f everest \u7684\u94a9\u5b50, \u8fd9\u5bf9\u4e8e <code>On</code> \u94a9\u5b50\u53ef\u80fd\u6ca1\u6709\u5927\u5f71\u54cd, \u4f46\u662f\u5bf9\u4e8e\u540e\u9762\u6211\u4eec\u4f1a\u8bf4\u7684 <code>IL</code> \u94a9\u5b50\u6709\u5f88\u5927\u5f71\u54cd, \u4e0d\u8fc7\u8fd9\u4e9b\u6211\u4eec\u7b49\u5230\u540e\u9762\u518d\u8bf4.</p>"},{"location":"begin/reading_2/#statemachine","title":"StateMachine","text":"<p>\u8fd9\u662f Monocle \u4e2d\u7684\u4e00\u4e2a Component \u7c7b, \u662f\u4e00\u4e2a\u72b6\u6001\u673a\u7684\u5b9e\u73b0, \u5177\u4f53\u7684\u7528\u6cd5\u6211\u4f1a\u5728 \u5e38\u89c1 Celeste, Monocle \u7c7b<sub>\u5728\u5199\u4e86.jpg</sub> \u8282\u8bf4, \u8fd9\u91cc\u4ec5\u662f\u65b9\u4fbf\u4f60\u9605\u8bfb\u4e00\u4e0b\u76f8\u5173\u7684\u4ee3\u7801:</p>"},{"location":"begin/reading_2/#st","title":"<code>St*</code> \u7c7b\u5b57\u6bb5","text":"<p>\u5728\u9605\u8bfb <code>Player</code> \u7c7b\u7684\u4ee3\u7801\u65f6, \u4f60\u4f1a\u770b\u5230\u8fd9\u4e9b<code>St</code>\u5f00\u5934\u540d\u5b57\u7684\u5e38\u91cf\u4f46\u662f\u4f60\u627e\u4e0d\u5230\"\u88ab\u4f7f\u7528\"\u7684\u5730\u65b9:</p> <ul> <li>const int StNormal = 0;</li> <li>const int StClimb = 1;</li> <li>const int StDash = 2;</li> <li>const int StSwim = 3;</li> <li>const int StBoost = 4;</li> <li>......</li> </ul> <p>\u8fd9\u4e9b\u662f\u73a9\u5bb6\u72b6\u6001\u673a\u7684\u72b6\u6001\u7f16\u53f7, \u81f3\u4e8e\u4f60\u627e\u4e0d\u5230\"\u88ab\u4f7f\u7528\"\u662f\u56e0\u4e3a\u5bf9\u4e8e const \u5e38\u91cf\u6210\u5458, c# \u7f16\u8bd1\u5668\u5728\u7f16\u8bd1\u671f\u5c31\u628a\u5f15\u7528\u7684\u8fd9\u4e9b\u4e1c\u897f\u76f4\u63a5\u66ff\u6362\u4e3a\u4e86\u6570\u5b57, \u4f60\u80fd\u770b\u5230\u7684\u53ea\u6709\u4fdd\u7559\u4e0b\u6765\u7684\u8fd9\u4e9b\u5e38\u91cf\u7684\u503c\u548c\u540d\u5b57. \u90a3\u8fd9\u6837\u4ee3\u7801\u4e2d\u5c31\u4e0d\u907f\u514d\u7684\u51fa\u73b0\u4e86\u5947\u602a\u7684\u9b54\u6570, \u6bd4\u5982\u8fd9\u91cc\u7684 24: int Player.FlingBirdUpdate()<pre><code>private int FlingBirdUpdate()\n{\n    base.MoveTowardsX(this.flingBird.X, 250f * Engine.DeltaTime, null);\n    base.MoveTowardsY(this.flingBird.Y + 8f + base.Collider.Height, 250f * Engine.DeltaTime, null);\n    return 24;\n}\n</code></pre></p> <p>Info</p> <p>FlingBirdUpdate \u662f\u4e00\u4e2a\u72b6\u6001\u673a\u7684 Update \u51fd\u6570, \u6240\u6709\u8be5\u7c7b\u51fd\u6570\u7684\u8fd4\u56de\u503c\u8868\u793a\u4e0b\u4e00\u5e27\u73a9\u5bb6\u7684\u72b6\u6001\u5e94\u8be5\u662f\u4ec0\u4e48.</p> <p>\u4f60\u80af\u5b9a\u5f88\u7591\u60d1\u8fd9\u4e2a\u5947\u602a\u7684 24 \u662f\u4ec0\u4e48, \u8fd9\u91cc\u6211\u4eec\u5df2\u7ecf\u77e5\u9053\u5b83\u662f\u4e2a\u72b6\u6001\u673a\u7f16\u53f7\u4e86, \u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e0b\u8fd9\u4e2a\u7f16\u53f7\u5bf9\u5e94\u7684\u72b6\u6001. \u7ecf\u8fc7\u67e5\u8be2, \u4f60\u4f1a\u77e5\u9053\u7f16\u53f7\u4e3a 24 \u7684\u72b6\u6001\u662f <code>StFlingBird</code>, \u5373\u88ab\u9e1f\u6254\u72b6\u6001(\u7b26\u5408\u8fd9\u91cc\u7684\u51fd\u6570\u540d!):</p> <pre><code>const int StFlingBird = 24;\n</code></pre> <p>\u5728\u8fd9\u91cc\u4f1a\u7b80\u5355\u5217\u51fa\u4e00\u4e0b <code>Player</code> \u7684\u6240\u6709\u72b6\u6001\u4fbf\u4e8e\u67e5\u8be2:</p> <pre><code>const int StNormal = 0; // \u6b63\u5e38\nconst int StClimb = 1; // \u6500\u722c\nconst int StDash = 2; // \u51b2\u523a\nconst int StSwim = 3; // \u6c34\u4e2d\nconst int StBoost = 4; // \u7eff\u6ce1\u6ce1\u4e2d\nconst int StRedDash = 5; // \u7ea2\u6ce1\u6ce1\u4e2d\nconst int StHitSquash = 6; // \u88ab\u56fa\u4f53\u6324\u538b?\nconst int StLaunch = 7; // \u88ab \u5f39\u7403, \u9c7c \u5f39\u5f00\nconst int StPickup = 8; // \u6361\u8d77\u6293\u53d6\u7269\nconst int StDreamDash = 9; // \u7a7f\u679c\u51bb\nconst int StSummitLaunch = 10; // 7a, 7b \u4e0a\u5347\u8fc7\u573a\nconst int StDummy = 11; // \u5267\u60c5\u8fc7\u573a\u72b6\u6001\nconst int StIntroWalk = 12; // Walk \u7c7b\u578b\u7684 Intro (Intro \u5373\u73a9\u5bb6\u8fdb\u5165\u5173\u5361\u7684\u8868\u73b0\u65b9\u5f0f)\nconst int StIntroJump = 13; // Jump \u7c7b\u578b\u7684 Intro (1a)\nconst int StIntroRespawn = 14; // Respawn \u7c7b\u578b\u7684 Intro (\u91cd\u751f)\nconst int StIntroWakeUp = 15; // WakeUp \u7c7b\u578b\u7684 Intro (2a awake)\nconst int StBirdDashTutorial = 16; // \u5e8f\u7ae0\u6559\u51b2\u523a\u65f6\u51b2\u523a\u7ed3\u675f\u540e\u8fdb\u5165\u7684\u72b6\u6001\nconst int StFrozen = 17; // \u672a\u77e5\nconst int StReflectionFall = 18; // 6a-2 \u6389\u843d\u5267\u60c5\u6bb5\nconst int StStarFly = 19; // \u7fbd\u6bdb\u98de\u884c\nconst int StTempleFall = 20; // 5a \u955c\u5b50\u540e\u7684\u6389\u843d\u6bb5\nconst int StCassetteFly = 21; // \u6361\u5230\u78c1\u5e26\u540e\u7684\u6ce1\u6ce1\u5305\u88f9\u6bb5\nconst int StAttract = 22; // 6a badeline boss \u9760\u8fd1\u65f6\u7684\u5438\u5f15\u6bb5\nconst int StIntroMoonJump = 23; // 9a \u5f00\u573a\u4e0a\u5347\u5267\u60c5\u6bb5\nconst int StFlingBird = 24; // 9a \u9e1f\u6254\u72b6\u6001\nconst int StIntroThinkForABit = 25; // 9a Intro\n</code></pre>"},{"location":"begin/simple_entity/","title":"\u7b80\u5355\u81ea\u5b9a\u4e49\u5b9e\u4f53","text":"<p>\u5728\u77e5\u9053\u4e00\u4e9b mod \u5236\u4f5c\u4e2d\u6700\u4e3a\u57fa\u7840\u7684\u4e1c\u897f\u540e, \u6211\u4eec\u9996\u5148\u628a\u5174\u8da3\u70b9\u8f6c\u5411\u81ea\u5b9a\u4e49\u5b9e\u4f53, \u76f8\u4fe1\u76f8\u5bf9\u4e8e\u4fee\u6539\u5df2\u6709\u7684\u4e1c\u897f\u5e76\u4f34\u968f\u7740\u4e00\u5b9a\u7684\u70e7\u8111(\u6211\u8be5\u600e\u4e48\u6539? \u8fd9\u4e48\u6539\u4f1a\u4e0d\u4f1a\u7834\u574f\u5b98\u56fe\u5143\u7d20?), \u4f60\u53ef\u80fd\u66f4\u559c\u6b22\u81ea\u5df1\u5236\u4f5c\u4e00\u4e2a\u5b9e\u4f53, \u90a3\u5c31\u5bf9\u4e86! \u5728\u8fd9\u4e00\u8282, \u6211\u4eec\u4f1a\u4e86\u89e3 loenn \u7684\u57fa\u7840\u4f7f\u7528\u3001\u6dfb\u52a0\u4e00\u4e2a\u81ea\u5b9a\u4e49\u5b9e\u4f53\u7684\u901a\u7528\u6b65\u9aa4, \u4ee5\u53ca\u4e00\u4e9b\u6e38\u620f\u5e38\u7528\u7684\u65b9\u6cd5!</p>"},{"location":"begin/simple_entity/#_2","title":"\u6211\u4eec\u7684\u81ea\u5b9a\u4e49\u5b9e\u4f53\u7c7b","text":""},{"location":"begin/simple_entity/#_3","title":"\u5b83\u80fd\u5e72\u4ec0\u4e48","text":"<p>\u5728\u5f00\u59cb\u5236\u4f5c\u8fd9\u4e2a\u81ea\u5b9a\u4e49\u5b9e\u4f53\u4e4b\u524d, \u6211\u4eec\u5148\u660e\u767d\u4e00\u4e0b\u8fd9\u4e2a\u5b9e\u4f53\u505a\u51fa\u6765\u662f\u4ec0\u4e48\u6548\u679c\u7684. \u90a3\u4e48, \u4e3a\u4e86\u7b80\u5355\u8d77\u89c1, \u8fd9\u91cc\u5c31\u505a\u4e00\u4e2a\u7b80\u5355\u7684\u529f\u80fd, \u5b83\u5927\u6982\u662f:</p> <ul> <li>\u5b83\u53eb\u505a <code>PassByRefill</code></li> <li>\u957f\u5ea6\u548c\u5bbd\u5ea6\u662f\u968f\u610f\u7684</li> <li>\u5b83\u770b\u8d77\u6765\u662f\u4e2a\u900f\u660e\u7684\u7ea2\u8272\u7269\u4f53</li> <li>\u73a9\u5bb6\u4e0e\u5176\u78b0\u649e\u65f6\u4f1a\u9501\u5b9a\u4e3a\u67d0\u4e2a\u51b2\u523a\u6570</li> <li>\u8fd9\u4e2a\u51b2\u523a\u6570\u53ef\u4ee5\u5728\u4f5c\u56fe\u8f6f\u4ef6\u4e2d\u8bbe\u7f6e</li> </ul> <p>\u662f\u7684\u5c31\u8fd9\u6837\u7b80\u5355, \u90a3\u4e48\u6211\u4eec\u5f00\u59cb\u5427.</p>"},{"location":"begin/simple_entity/#_4","title":"\u58f0\u660e\u8fd9\u4e2a\u7c7b","text":"<p>Warning</p> <p>\u5728\u524d\u9762\u6211\u4eec\u94a9\u53d6\u4e86 <code>Player.Update()</code> \u5e76\u4e14\u5728\u4e00\u76f4\u4fee\u6539\u51b2\u523a\u6570\u4e3a 1! \u4e0d\u8981\u5fd8\u8bb0\u628a\u94a9\u5b50\u51fd\u6570\u4ee5\u53ca\u94a9\u53d6\u548c\u53d6\u6d88\u94a9\u53d6\u7684\u90a3\u4e9b\u4ee3\u7801\u5220\u6389, \u6700\u540e\u4f60\u7684 Module \u7c7b\u5e94\u8be5\u53ea\u5305\u542b\u4e24\u4e2a\u7a7a\u7684 <code>Load</code> \u548c <code>Unload</code> \u65b9\u6cd5!</p> <p>\u9996\u5148\u5728\u4ee3\u7801\u4e2d, \u6211\u4eec\u9700\u8981\u58f0\u660e\u8fd9\u4e2a\u7c7b, \u4e5f\u5c31\u662f\u521b\u5efa\u4e00\u4e2a .cs \u6587\u4ef6, \u7136\u540e\u547d\u4e2a\u540d. \u5728\u8fd9\u91cc\u4f60\u8fd8\u9700\u8981\u7ee7\u627f\u4e00\u4e0b <code>Entity</code>, \u5728\u524d\u9762\u6211\u4eec\u5df2\u7ecf\u4e86\u89e3\u8fc7\u4e86\u5b83\u662f <code>Monocle</code> \u7684\u4e00\u4e2a\u7c7b, \u8868\u793a\u573a\u666f\u4e2d\u7684\u5b9e\u4f53. \u90a3\u4e48\u4f60\u5e94\u8be5\u4f1a\u5199\u51fa\u5982\u4e0b\u7684\u4ee3\u7801:</p> PassByRefill.cs<pre><code>namespace MyCelesteMod;\n\npublic class PassByRefill : Entity\n{\n\n}\n</code></pre> <p>ok, \u63a5\u4e0b\u6765, \u6211\u4eec\u52a0\u4e00\u4e2a\u8868\u793a\u51b2\u523a\u6570\u7684\u5b57\u6bb5, \u7136\u540e\u641e\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u63a5\u6536\u5e76\u8d4b\u503c\u5b83: PassByRefill.cs<pre><code>public int Dashes = 0;\n\npublic PassByRefill(Vector2 position, Vector2 size, int dashes)\n{\n    Position = position;\n    Dashes = dashes;\n}\n</code></pre></p> <p>\u8fd9\u91cc\u7684 <code>position</code> \u53c2\u6570\u4f1a\u88ab\u7528\u4e8e\u8bbe\u7f6e\u5b83\u7684 <code>Position</code> \u5b57\u6bb5, \u8fd9\u4e2a\u5b57\u6bb5\u4ece <code>Monocle.Entity</code> \u7ee7\u627f\u800c\u6765, \u5b83\u8868\u793a\u8fd9\u4e2a <code>Entity</code> \u5728\u573a\u666f\u4e2d\u6240\u5728\u7684\u4f4d\u7f6e(\u4e16\u754c\u5750\u6807). <code>Vector2</code> \u662f\u4e00\u4e2a XNA \u4e2d\u7684\u7ed3\u6784\u4f53, \u5305\u542b\u4e00\u4e2a <code>X</code> \u548c\u4e00\u4e2a <code>Y</code> \u7684 <code>float</code> \u5b57\u6bb5, \u5b83\u7528\u4e8e\u63cf\u8ff0\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e, \u5c31\u50cf\u4f60\u5728\u5e73\u9762\u76f4\u89d2\u5750\u6807\u7cfb\u4e2d\u6240\u505a\u7684\u4e00\u6837! \u4e0d\u8fc7\u8fd9\u91cc\u9700\u8981\u6ce8\u610f, \u6e38\u620f\u4e2d\u7684\u5750\u6807\u7cfb\u548c\u6211\u4eec\u901a\u5e38\u6570\u5b66\u4e2d\u7684\u5750\u6807\u7cfb\u4e0d\u540c, \u5b83\u7684\u9876\u70b9\u5728\u5de6\u4e0a\u89d2, X \u8f74\u6c34\u5e73\u5411\u53f3\u4f46\u662f Y \u8f74\u7ad6\u76f4\u5411\u4e0b! \u5207\u8bb0\u4e0d\u8981\u641e\u6df7\u4e86. <code>Vector2</code> \u540c\u65f6\u4e5f\u53ef\u80fd\u8868\u793a\u5927\u5c0f, \u5373 <code>X</code> \u5b57\u6bb5\u8868\u793a\u5bbd\u5ea6, <code>Y</code> \u5b57\u6bb5\u8868\u793a\u957f\u5ea6, \u5728\u8fd9\u91cc\u6211\u4eec\u7528\u5b83\u6765\u63a5\u6536\u5b83\u7684\u5927\u5c0f. \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u6211\u4eec\u5e76\u6ca1\u6709\u7406 <code>size</code> \u8fd9\u4e2a\u8868\u793a\u5927\u5c0f\u53c2\u6570, \u7a0d\u7b49\u4e00\u4e0b, \u6211\u4eec\u5728\u672c\u8282\u540e\u8fb9\u5c31\u4f1a\u4f7f\u7528\u5b83\u4e86.</p> <p> </p> <p>\u63a5\u4e0b\u6765, \u6211\u4eec\u9700\u8981\u58f0\u660e\u4e00\u4e2a\u7279\u6b8a\u7684\u6784\u9020\u51fd\u6570, \u8fd9\u4e2a\u6784\u9020\u51fd\u6570\u7531 Everest \u53cd\u5c04\u8c03\u7528, \u7528\u4e8e\u5c06\u4f5c\u56fe\u8f6f\u4ef6\u90a3\u8fb9\u7684\u6570\u636e\u4f20\u9012\u7ed9\u6211\u4eec: PassByRefill.cs<pre><code>public PassByRefill(EntityData data, Vector2 offset) \n        : this(data.Position + offset, new Vector2(data.Width, data.Height), data.Int(\"dashes\"))\n    { }\n</code></pre> \u5728\u8fd9\u91cc, <code>EntityData data</code> \u50a8\u5b58\u4e86\u4f5c\u56fe\u8f6f\u4ef6\u4fdd\u5b58\u7684\u76f8\u5173\u6570\u636e, \u6211\u4eec\u8981\u63d0\u53d6\u5b83\u4eec\u5f88\u7b80\u5355, \u6bd4\u5982\u8bf4\u6211\u4eec\u8981\u63d0\u53d6\u4e00\u4e2a\u540d\u4e3a <code>dashes</code> \u7684 <code>int</code> \u7c7b\u578b\u7684\u6570\u636e, \u6211\u4eec\u5c31\u7b80\u5355\u5730\u8c03\u7528\u5b83\u7684\u65b9\u6cd5 <code>Int(string name)</code> \u5c31\u5f97\u5230\u4e86, \u7136\u540e\u662f\u5b83\u7684\u5927\u5c0f\u6570\u636e, \u7531\u4e8e\u5927\u5c0f\u662f\u4e2a\u7279\u6b8a\u7684\u4e1c\u897f, \u8fd9\u91cc\u6211\u4eec\u53ef\u4ee5\u76f4\u63a5\u901a\u8fc7 <code>Width</code> \u548c <code>Height</code> \u5c5e\u6027\u63d0\u53d6\u5e76 <code>new</code> \u4e00\u4e2a <code>Vector2</code> \u7ed3\u6784\u4f53\u6765\u4f20\u9012\u7ed9\u6211\u4eec\u4e0a\u9762\u7684\u6784\u9020\u51fd\u6570. \u5bf9\u4e8e\u66f4\u591a\u65b9\u6cd5\u4ee5\u53ca\u8fd9\u90e8\u5206\u6570\u636e\u8be5\u5982\u4f55\u81ea\u5b9a\u4e49\u6211\u4eec\u4f1a\u5728\u672c\u8282\u540e\u534a\u90e8\u5206\u8bf4\u660e. <code>Vector2 offset</code> \u8868\u793a\u8fd9\u4e00\u9762\u7684\u6700\u5de6\u4e0a\u89d2\u7684\u4e16\u754c\u5750\u6807, <code>EntityData</code> \u7684 <code>Position</code> \u662f\u7269\u4f53\u76f8\u5bf9\u4e8e\u8fd9\u4e00\u9762\u6700\u5de6\u4e0a\u89d2\u7684\u5750\u6807, \u6240\u4ee5\u6211\u4eec\u9700\u8981\u628a\u5b83\u76f8\u52a0\u6765\u5f97\u5230\u4e16\u754c\u5750\u6807.(\u56e0\u4e3a <code>Entity.Position</code> \u6c38\u8fdc\u53ea\u63a5\u53d7\u4e16\u754c\u5750\u6807!)</p> <p>Info</p> <p>\u8fd9\u4e2a\u6784\u9020\u51fd\u6570\u7684\u53c2\u6570\u5217\u8868\u4e5f\u80fd\u4e3a\u5176\u4ed6\u7684\u6837\u5b50, \u4f46\u662f\u6211\u4eec\u6700\u6700\u6700\u5e38\u7528\u7684\u4e00\u4e2a\u7248\u672c\u5c31\u662f\u4e0a\u9762\u8fd9\u4e2a</p>"},{"location":"begin/simple_entity/#everest","title":"\u8ba9 Everest \u627e\u5230\u5b83","text":"<p>\u73b0\u5728\u6211\u4eec\u53ea\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7c7b Everest \u90a3\u8fb9\u662f\u5565\u4e5f\u4e0d\u77e5\u9053\u7684, \u6240\u4ee5\u6211\u4eec\u5f97\u544a\u8bc9\u5b83, \u800c\u8fd9\u4e2a\u8fc7\u7a0b\u6211\u4eec\u4e00\u822c\u5c31\u53eb <code>\u6ce8\u518c</code>. \u8981\u6ce8\u518c\u4e00\u4e2a\u81ea\u5b9a\u4e49\u5b9e\u4f53\u975e\u5e38\u7b80\u5355, \u6211\u4eec\u53ea\u9700\u8981\u5c06 <code>CustomEntity</code> (\u5728\u547d\u540d\u7a7a\u95f4 <code>Celeste.Mod.Entities</code> \u4e2d) \u88c5\u9970\u5230\u6211\u4eec\u7684\u7c7b\u4e0a\u5e76\u4f20\u5165\u6211\u4eec\u5b9e\u4f53\u7684 \"\u540d\u79f0 ID\". \u5c31\u50cf: PassByRefill.cs<pre><code>[CustomEntity(\"MyCelesteMod/PassByRefill\")]\npublic class PassByRefill : Entity\n{\n......\n</code></pre> \u5728\u8fd9\u91cc \"\u540d\u79f0 ID\" \u6211\u4eec\u4e00\u822c\u63a8\u8350\u4ee5 \"{Mod\u540d}/\u8be5\u5b9e\u4f53\u7c7b\u540d\" \u8fdb\u884c\u547d\u540d, \u5c31\u50cf\u8fd9\u91cc\u4e00\u6837, Mod \u540d\u4e3a <code>MyCelesteMod</code>, \u7c7b\u540d\u4e3a <code>PassByRefill</code>, \u5b9e\u4f53 \"\u540d\u79f0 ID\" \u5c31\u662f <code>MyCelesteMod/PassByRefill</code>. \u8fd9\u91cc\u6211\u5efa\u8bae\u4f60\u8bb0\u4f4f\u5b83, \u5f85\u4f1a\u6211\u4eec\u4f1a\u5728\u4f5c\u56fe\u8f6f\u4ef6\u914d\u7f6e\u7684\u65f6\u5019\u7528\u5230.</p>"},{"location":"begin/simple_entity/#loenn","title":"Loenn","text":"<p>\u4f5c\u56fe\u8f6f\u4ef6</p> <p>\u851a\u84dd\u7684\u4f5c\u56fe\u8f6f\u4ef6\u6700\u6d41\u884c\u7684\u76ee\u524d\u6709 <code>ahorn</code> \u4e0e <code>loenn</code>, \u4e0d\u8fc7\u6211\u66f4\u63a8\u8350 <code>loenn</code>, \u56e0\u4e3a <code>ahorn</code> \u5b9e\u5728\u662f \u592a!!\u5361!!\u4e86!!</p>"},{"location":"begin/simple_entity/#_5","title":"\u57fa\u7840\u4f7f\u7528","text":"<p>Loenn \u662f\u4e00\u4e2a\u851a\u84dd\u7684\u4f5c\u56fe\u8f6f\u4ef6, \u5f53\u7136\u8fd9\u91cc\u6211\u4eec\u4f7f\u7528\u5b83\u4e0d\u662f\u5236\u4f5c\u51fa\u7cbe\u7f8e\u7684\u5730\u56fe, \u800c\u662f\u4ec5\u4ec5\u653e\u7f6e\u4e00\u4e0b\u6211\u4eec\u7684\u81ea\u5b9a\u4e49\u5b9e\u4f53! _(:\u0437\u300d\u2220)_, \u8fd9\u91cc\u6211\u4e0d\u600e\u4e48\u60f3\u91cd\u590d\u5b83\u7684\u57fa\u7840\u4f7f\u7528, \u6240\u4ee5\u6211\u63a8\u8350\u4f60\u53bb\u4ee5\u4e0b\u51e0\u4e2a\u89c6\u9891\u4e2d\u4e86\u89e3:</p> <ul> <li>Bilibili \u3010Celeste\u851a\u84dd\u3011\u7535\u7bb1\u4f5c\u56fe\u6559\u7a0b\u91cd\u7f6e\u7248 0-1 Loenn\u7684\u5b89\u88c5</li> <li>Bilibili \u3010Celeste\u851a\u84dd\u3011\u7535\u7bb1\u4f5c\u56fe\u6559\u7a0b\u91cd\u7f6e\u7248 1-1 Loenn\u7684\u4f7f\u7528</li> </ul> <p>\u7248\u672c</p> <p>\u5982\u679c\u4f60\u4e4b\u524d\u5df2\u7ecf\u4e0b\u8f7d\u4e86 Loenn, \u6211\u5efa\u8bae\u4f60\u786e\u4fdd\u5b83\u5347\u7ea7\u5230\u6700\u65b0\u7248\u4e86, \u56e0\u4e3a\u63a5\u4e0b\u6765\u7684\u67d0\u4e9b\u4e1c\u897f\u6211\u53ef\u80fd\u4e0d\u592a\u8bb0\u5f97\u662f\u54ea\u4e2a\u7248\u672c\u5f15\u5165\u7684\u4e86.</p>"},{"location":"begin/simple_entity/#loenn_1","title":"\u8ba9 Loenn \u627e\u5230\u6211\u4eec\u7684\u5b9e\u4f53","text":"<p>\u76f8\u4fe1\u4f60\u73b0\u5728\u5df2\u7ecf\u61c2\u7684 Loenn \u57fa\u672c\u7684\u4f7f\u7528\u7528\u6cd5\u4e86, \u90a3\u4e48\u73b0\u5728, \u6211\u4eec\u8981\u7ed9 Loenn \u5199\u4e00\u4e9b\u4e1c\u897f\u8ba9\u5b83\u77e5\u9053\u6211\u4eec\u8fd9\u4e2a\u5b9e\u4f53 mapper \u4eec\u80fd\u7528\u4e86. \u9996\u5148\u6211\u4eec\u5728 ModFolder \u4e0b\u65b0\u5efa\u4e00\u4e2a\u53eb <code>Loenn</code> \u7684\u6587\u4ef6\u5939, \u518d\u5728\u91cc\u9762\u65b0\u5efa\u4e00\u4e2a\u53eb <code>entities</code> \u7684\u6587\u4ef6\u5939, \u518d\u5728\u91cc\u9762\u65b0\u5efa\u4e00\u4e2a\u53eb <code>PassByRefill.lua</code> (\u4e5f\u5c31\u662f<code>{\u5b9e\u4f53\u7c7b\u540d}.lua</code>) \u7684\u6587\u672c\u6587\u4ef6. \u73b0\u5728\u4f60\u7684\u76ee\u5f55\u7ed3\u6784\u5e94\u8be5\u662f\u8fd9\u6837\u7684:</p> <ul> <li>ModFolder<ul> <li>Loenn<ul> <li>entities<ul> <li>PassByRefill.lua</li> </ul> </li> </ul> </li> </ul> </li> </ul> <p>ok, \u7136\u540e\u6211\u4eec\u6253\u5f00 <code>PassByRefill.lua</code>, \u8fd9\u662f\u4e00\u4e2a <code>lua</code> \u8bed\u8a00\u7684\u6e90\u6587\u4ef6, \u8fd9\u91cc\u6211\u4eec\u4e0d\u9700\u8981\u5f88\u591a <code>lua</code> \u77e5\u8bc6, \u76f4\u63a5\u7167\u7740\u6284\u5c31\u597d\u4e86:</p> PassByRefill.lua<pre><code>local entity = {}\n\nentity.name = \"MyCelesteMod/PassByRefill\"\nentity.placements = {\n    name = \"normal\",\n    data = {\n        width = 16,\n        height = 16,\n        dashes = 1\n    }\n}\n\nreturn entity\n</code></pre> <p>\u8fd8\u8bb0\u5f97\u6211\u4eec\u4e4b\u524d\u8bb0\u4f4f\u7684\u5b9e\u4f53 \"\u540d\u79f0 ID\" \u5417? \u5728\u8fd9\u91cc\u4f60\u5c31\u9700\u8981\u5c06\u5176\u8d4b\u503c\u7ed9 <code>entity.name</code>.  </p> <ul> <li>\u7136\u540e\u662f <code>entity</code> \u7684 <code>placements</code>, \u5b83\u8868\u793a\u8fd9\u4e2a\u5b9e\u4f53\u7684\u653e\u7f6e\u9009\u9879, \u5728\u8fd9\u91cc\u6211\u4eec\u5148\u4e0d\u7ba1, \u4f60\u5c31\u7406\u89e3\u4e3a\u4f60\u5e0c\u671b Loenn \u600e\u4e48\u628a\u4f60\u8fd9\u4e2a\u5b9e\u4f53\u62c6\u5206\u4e3a\u591a\u4e2a\u653e\u7f6e\u9009\u9879, \u8fd9\u91cc\u6211\u4eec\u7684\u5199\u6cd5\u8868\u793a\u4e0d\u5e0c\u671b Loenn \u62c6\u5206\u5b83, \u5982\u679c\u8fd9\u91cc\u7684 <code>placements</code> \u662f\u4e2a\u6570\u7ec4\u7684\u8bdd\u90a3\u4e48 Loenn \u5c31\u4f1a\u62c6\u5206\u5b83\u4e86.<ul> <li>\u7ee7\u7eed\u5230 <code>name</code> \u5c5e\u6027, \u5b83\u8868\u793a\u8fd9\u4e2a\u653e\u7f6e\u9009\u9879\u7684\u540d\u79f0, \u8fd9\u4e2a\u540d\u79f0\u662f\u4efb\u610f\u7684, \u5b83\u53ea\u88ab\u7528\u6765\u4f5c\u4e3a\u672c\u5730\u5316\u952e\u540d(\u672c\u5730\u5316\u5c31\u5305\u62ec\u6211\u4eec\u5e38\u8bf4\u7684\"\u6c49\u5316\").</li> <li>\u7136\u540e\u662f <code>data</code> \u5c5e\u6027, \u5b83\u8868\u793a\u8fd9\u4e2a\u5b9e\u4f53\u7684\u6570\u636e.<ul> <li>\u5728\u8fd9\u91cc\u6211\u4eec\u58f0\u660e\u4e86\u4e09\u4e2a\u6570\u5b57\u7c7b\u578b\u7684\u5c5e\u6027: <code>width</code>, <code>height</code>, <code>dashes</code>, \u524d\u4e24\u4e2a\u5c5e\u6027\u662f\u7279\u6b8a\u7684, \u5728\u4ee3\u7801\u4e2d\u63d0\u53d6\u53ea\u9700\u8981\u5bf9 <code>EntityData</code> \u83b7\u53d6 <code>Width</code>/<code>Height</code> \u5b57\u6bb5\u5373\u53ef.  </li> <li>\u7b2c\u4e09\u4e2a <code>dashes</code> \u5c5e\u6027\u5c31\u662f\u6211\u4eec\u7684\u81ea\u5b9a\u4e49\u5c5e\u6027</li> </ul> </li> </ul> </li> </ul> <p>\u5728 <code>data</code> \u5bf9\u8c61\u91cc\u7684\u5c5e\u6027, \u540e\u9762\u7684\u7b49\u53f7\u5c31\u8868\u793a\u5b83\u7684\u9ed8\u8ba4\u503c, \u6bd4\u5982 <code>width</code> \u9ed8\u8ba4\u4e3a 16, <code>dashes</code> \u9ed8\u8ba4\u4e3a 1.</p> <p>Note</p> <p>\u5982\u679c\u4f60\u4e0d\u58f0\u660e <code>width</code> \u548c <code>height</code> \u5c5e\u6027\u7684\u8bdd Loenn \u4f3c\u4e4e\u4f1a\u76f4\u63a5\u7981\u6b62\u4f60\u653e\u7f6e\u8fd9\u4e2a\u5b9e\u4f53.</p> <p>\u597d\u5427\u770b\u8d77\u6765\u4e0a\u9762\u8fd9\u4e00\u5768*\u975e\u5e38\u96be\u61c2*, \u4e0d\u8fc7\u6ca1\u5173\u7cfb, \u53ea\u8981\u4f60\u4f1a\u76f4\u63a5\u590d\u5236\u4e0a\u9762\u7684\u4e1c\u897f, \u6539\u4e00\u4e0b <code>entity.name</code>, \u5411 <code>data</code> \u91cc\u52a0\u4e00\u4e9b\u5c5e\u6027\u5c31\u884c\u4e86. \u5b9e\u9645\u4e0a\u6211\u4e5f\u662f\u8fd9\u4e48\u505a\u7684.  </p> <p>\u90a3\u4e48, \u91cd\u65b0\u7f16\u8bd1\u6211\u4eec\u7684\u9879\u76ee, \u8ba9 <code>msbuild</code> \u628a\u6211\u4eec\u7684\u4e1c\u897f\u590d\u5236\u8fc7\u53bb, \u8fd9\u65f6\u6253\u5f00\u6211\u4eec\u7684 Loenn (\u6216\u8005\u91cd\u542f Loenn), \u641c\u7d22\u4e00\u4e0b <code>@MyCelesteMod</code>. \u90a3\u4e48\u5217\u8868\u4e0a\u5e94\u8be5\u53ea\u4f1a\u51fa\u73b0\u4e00\u4e2a\u540d\u5b57\u5f88\u5947\u602a\u7684\u9009\u9879(\u56e0\u4e3a\u6211\u4eec\u8fd8\u6ca1\u914d\u7f6e\u672c\u5730\u5316\u76f8\u5173\u7684\u4e1c\u897f!), \u73b0\u5728\u628a\u5b83\u653e\u5230\u4efb\u4f55\u4f60\u559c\u6b22\u7684\u5730\u65b9, \u6253\u5f00\u5b83\u7684\u5c5e\u6027\u6846, \u6211\u4eec\u5c31\u80fd\u770b\u5230\u4e00\u4e2a\u5927\u5927\u7684 <code>dashes</code> \u5c5e\u6027\u5728\u4e0a\u9762\u5141\u8bb8\u6211\u4eec\u6539\u5566. \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u5b83\u662f\u5168\u767d\u7684! \u56e0\u4e3a\u6211\u4eec\u8fd8\u6ca1\u544a\u8bc9 Loenn \u5b83\u957f\u4ec0\u4e48\u6837! \u4e0d\u8fc7\u8fd9\u4e2a\u7b49\u4ee5\u540e\u6211\u4eec\u518d\u6765\u641e.</p>"},{"location":"begin/simple_entity/#_6","title":"\u56de\u5230\u4ee3\u7801","text":"<p>\u73b0\u5728\u5728\u6e38\u620f\u4e2d\u8fdb\u5165\u653e\u4e86\u6211\u4eec\u90a3\u4e2a\u5b9e\u4f53\u7684\u90a3\u5f20\u56fe, \u7136\u540e\u5230\u4e4b\u524d\u4f60\u559c\u6b22\u7684\u90a3\u4e2a\u5730\u65b9, \u7136\u540e... \u662f\u7684, \u4f60\u5565\u4e5f\u4e0d\u4f1a\u770b\u89c1, \u56e0\u4e3a\u6211\u4eec\u4e5f\u6ca1\u544a\u8bc9\u6e38\u620f\u5b83\u957f\u4ec0\u4e48\u6837! \u540c\u65f6\u4f60\u8d70\u5230\u5b83\u9644\u8fd1, \u4e5f\u4e0d\u4f1a\u53d1\u751f\u4efb\u4f55\u4e8b, \u56e0\u4e3a\u6211\u4eec\u4e5f\u6ca1\u544a\u8bc9\u6e38\u620f\u8fd9\u4e2a\u5b9e\u4f53\u5e94\u8be5\u5e72\u4ec0\u4e48!</p>"},{"location":"begin/simple_entity/#_7","title":"\u544a\u8bc9\u6e38\u620f\u5b83\u8be5\u505a\u4ec0\u4e48","text":"<p>\u90a3\u4e48, \u5c31\u50cf\u524d\u9762\u63cf\u8ff0\u7684\u4e00\u6837, \"\u73a9\u5bb6\u4e0e\u5176\u78b0\u649e\u65f6\u4f1a\u9501\u5b9a\u4e3a\u67d0\u4e2a\u51b2\u523a\u6570\", \u90a3\u4e48\u6211\u4eec\u9700\u8981\u505a\u4e00\u4e9b\u78b0\u649e. \u5728 <code>Monocle</code> \u91cc\u8fd9\u9879\u5de5\u4f5c\u5f88\u7b80\u5355, \u6211\u4eec\u9996\u5148\u5728\u6784\u9020\u51fd\u6570\u91cc\u53bb <code>new</code> \u4e00\u4e2a\u957f\u65b9\u5f62\u7684\u78b0\u649e\u7bb1: PassByRefill.PassByRefill<pre><code>public PassByRefill(Vector2 position, Vector2 size, int dashes)\n{\n    Hitbox hitbox = new(size.X, size.Y);\n}\n</code></pre></p> <p>Info</p> <p>\u6211\u4eec\u5728\u8fd9\u91cc\u7528\u5230\u4e86\u4e4b\u524d\u7684 <code>size</code> \u53c2\u6570</p> <p><code>Hitbox</code> \u5c31\u662f\u6211\u4eec\u60f3\u8981\u7684\u957f\u65b9\u5f62\u78b0\u649e\u7bb1, \u5b83\u7684\u552f\u4e00\u7684\u6784\u9020\u5668\u63a5\u6536\u56db\u4e2a\u53c2\u6570, \u524d\u4e24\u4e2a\u53c2\u6570\u4e3a\u5b83\u7684\u5bbd\u9ad8, \u540e\u4e24\u4e2a\u53c2\u6570\u4e3a\u8fd9\u4e2a\u78b0\u649e\u7bb1\u7684\u504f\u79fb(\u56e0\u4e3a\u78b0\u649e\u7bb1\u6211\u4eec\u8981\u9644\u52a0\u5230 <code>Entity</code> \u8eab\u4e0a, \u6240\u4ee5\u4f1a\u6709\u504f\u79fb\u8fd9\u4e2a\u4e1c\u897f), \u8fd9\u4e24\u4e2a\u53c2\u6570\u9ed8\u8ba4\u90fd\u4e3a 0. \u7136\u540e\u8bbe\u7f6e\u5230 <code>Entity</code> \u8eab\u4e0a: PassByRefill.PassByRefill<pre><code>Collider = hitbox;\n</code></pre> <code>Collider</code> \u662f <code>Entity</code> \u7684\u4e00\u4e2a\u5c5e\u6027, \u5b83\u8868\u793a\u8fd9\u4e2a <code>Entity</code> \u81ea\u8eab\u7684\u78b0\u649e\u7bb1. <code>Collider</code> \u5c5e\u6027\u662f <code>Collider</code> \u7c7b\u578b\u7684, \u5b83\u662f\u4e00\u4e2a\u62bd\u8c61\u7c7b\u8868\u793a\u4e00\u4e2a\u78b0\u649e\u4f53, \u8fd9\u91cc\u6211\u4eec\u7684 <code>Hitbox</code> \u5c31\u662f\u5b83\u7684\u4e00\u4e2a\u5b9e\u73b0, \u4e5f\u5c31\u662f\u4e00\u79cd\u957f\u65b9\u5f62\u7684\u5b9e\u73b0.  </p> <p>\u78b0\u649e\u7bb1\u8bbe\u7f6e\u5b8c\u540e, \u6211\u4eec\u5c31\u8be5\u5728 <code>Update()</code> \u68c0\u6d4b\u78b0\u649e\u4e86, \u8fd9\u5f88\u7b80\u5355~ PassByRefill.Update()<pre><code>public override void Update()\n{\n    base.Update();\n    // \u83b7\u53d6 Player \u5b9e\u4f8b (\u522b\u5bb3\u6015!)\n    var player = Scene.Tracker.GetEntity&lt;Player&gt;();\n\n    // \u68c0\u6d4b\u662f\u5426\u4e0e\u73a9\u5bb6\u78b0\u649e\n    if (player is not null &amp;&amp; this.CollideCheck(player))\n    {\n        // \u5982\u679c\u78b0\u649e\u4e86, \u90a3\u4e48\u8bbe\u7f6e\u5b83\u7684\u51b2\u523a\u6570\n        player.Dashes = this.Dashes;\n    }\n}\n</code></pre></p> <p>\u76f8\u4fe1\u4f60\u770b\u5230\u7b2c\u4e94\u884c\u4e00\u5b9a\u4f1a\u88ab\u5413\u4e00\u8df3! \u76f8\u4fe1\u90a3\u4e00\u4e32\u4e1c\u897f\u5bf9\u4e8e\u65b0\u4eba\u6765\u8bf4\u4e00\u5b9a\u5f88\u590d\u6742, \u4e0d\u8fc7\u6ca1\u5173\u7cfb, \u4f60\u53ea\u9700\u8981\u77e5\u9053\u90a3\u4e00\u4e32\u4f1a\u8fd4\u56de\u5728\u573a\u7684\u90a3\u4e2a\u73a9\u5bb6\u5c31\u884c(\u4e0d\u5728\u573a\u65f6\u4e3a null). \u7136\u540e\u6211\u4eec\u7528 <code>Entity</code> \u7684 <code>CollideCheck</code> \u68c0\u67e5\u6211\u4eec\u6709\u6ca1\u6709\u4e0e\u73a9\u5bb6\u53d1\u751f\u78b0\u649e, \u5982\u679c\u6709\u5219\u5f3a\u5236\u8bbe\u7f6e\u5b83\u7684\u51b2\u523a\u6570. \u7531\u4e8e\u6211\u4eec\u6bcf\u4e00\u5e27\u90fd\u5728\u68c0\u67e5, \u90fd\u5728\u8bbe\u7f6e, \u6240\u4ee5\u6700\u7ec8\u7684\u6548\u679c\u5c31\u662f\u73a9\u5bb6\u4e00\u65e6\u8fdb\u5165\u8fd9\u4e2a\u533a\u57df, \u51b2\u523a\u6570\u88ab\u9501\u5b9a\u4e3a <code>Dashes</code>.</p> <p>Info</p> <p>\u5b9e\u9645\u4e0a\u8fd9\u91cc\u6709\u66f4\u597d\u7684\u65b9\u6cd5\u6765\u5355\u72ec\u68c0\u6d4b\u4e0e\u73a9\u5bb6\u7684\u78b0\u649e, \u4e3a\u4e86\u7b80\u5355\u8d77\u89c1\u8fd9\u91cc\u6ca1\u6709\u91c7\u7528. \u4e0d\u8fc7\u6211\u4eec\u4f9d\u7136\u4f1a\u5728\u540e\u9762\u63d0\u5230(\"\u5e38\u89c1 Celeste, Monocle \u7c7b\"\u8282). \u7b2c\u4e00\u884c\u7684 <code>base.Update()</code> \u4f1a\u904d\u5386\u8c03\u7528\u8be5 <code>Entity</code> \u7684\u6240\u6709 <code>Component</code> \u7684 <code>Update()</code>, \u901a\u5e38\u6211\u4eec\u9700\u8981\u5728\u5f00\u5934\u5c31\u8c03\u7528\u5b83. \u540e\u9762\u7684 <code>Render()</code> \u4e5f\u662f.</p> <p>Info</p> <p>\u5728\u73a9\u5bb6\u6b7b\u4ea1\u540e\u7684\"\u70df\u82b1\"\u5e76\u4e0d\u662f <code>Player</code> \u5b9e\u4f8b, \u6240\u4ee5\u6b64\u65f6\u6211\u4eec\u4f1a\u5f97\u5230\u4e00\u4e2a <code>null</code> \u7684\u7ed3\u679c, \u5982\u679c\u4f60\u4e0d\u60f3\u8ba9\u4f60\u7684\u6e38\u620f\u5d29\u6e83\u7684\u8bdd\u8bb0\u5f97\u68c0\u67e5\u5b83\u662f\u5426\u4e3a <code>null</code>.</p>"},{"location":"begin/simple_entity/#_8","title":"\u544a\u8bc9\u6e38\u620f\u5b83\u957f\u4ec0\u4e48\u6837","text":"<p>\u90a3\u4e48, \u529f\u80fd\u505a\u597d\u540e, \u7684\u8ba9\u73a9\u5bb6\u770b\u89c1, \u4e3a\u4e86\u7b80\u5355\u8d77\u89c1\u8fd9\u91cc\u6211\u4eec\u4e0d\u6253\u7b97\u4f7f\u7528\u56fe\u7247, \u53ea\u662f\u50cf\u524d\u9762\u63cf\u8ff0\u7684\u4e00\u6837, \u5b83\u662f\u4e2a\"\u900f\u660e\u7684\u7ea2\u8272\u7269\u4f53\", \u5728\u8fd9\u91cc\u6211\u4eec\u9700\u8981\u91cd\u5199 <code>Entity</code> \u7684 <code>Render()</code> \u65b9\u6cd5\u6765\u7ed8\u5236\u4e00\u4e2a\u7eaf\u8272\u957f\u65b9\u5f62, \u5b83\u4f1a\u5728\u6e38\u620f\u4e2d\u6bcf\u5e27\u90fd\u4f1a\u88ab\u8c03\u7528, \u5c31\u50cf <code>Update()</code> \u4e00\u6837, \u4e0d\u8fc7\u5207\u8bb0\u4e0d\u8981\u5728\u8fd9\u4e24\u4e2a\u65b9\u6cd5\u91cc\u5e72\u4e0d\u76f8\u5173\u7684\u4e8b! \u4f60\u5e94\u8be5\u5728 <code>Update()</code> \u91cc\u53ea\u66f4\u65b0\u4f60\u7684\u903b\u8f91, \u800c\u5728 <code>Render()</code> \u91cc\u53ea\u505a\u7ed8\u5236. \u8fd9\u91cc\u6211\u4eec\u9009\u62e9\u7ed8\u5236\u4e00\u4e2a\u900f\u660e\u7684\u7ea2\u8272\u957f\u65b9\u5f62, \u6211\u4eec\u9700\u8981\u501f\u52a9\u8fd9\u4e2a\u51fd\u6570: Monocle.Draw.Rect<pre><code>Draw.Rect(Vector2 position, float width, float height, Color color)\n</code></pre> - \u7b2c\u4e00\u4e2a\u53c2\u6570\u662f\u6211\u4eec\u5e0c\u671b\u7ed8\u5236\u7684\u4f4d\u7f6e(\u4e16\u754c\u5750\u6807) - \u7b2c\u4e8c\u4e2a\u53c2\u6570\u662f\u6211\u4eec\u5e0c\u671b\u7ed8\u5236\u7684\u5bbd\u5ea6  - \u7b2c\u4e09\u4e2a\u53c2\u6570\u662f\u6211\u4eec\u5e0c\u671b\u7ed8\u5236\u7684\u9ad8\u5ea6 - \u7b2c\u56db\u4e2a\u53c2\u6570\u662f\u6211\u4eec\u5e0c\u671b\u7ed8\u5236\u7684\u989c\u8272</p> <p>\u6211\u4eec\u5728\u8fd9\u91cc\u4f1a\u8fd9\u6837\u7528\u5b83:</p> PassByRefill.Render()<pre><code>base.Render();\nColor c = Color.Red;\nc.A = 127;\nDraw.Rect(Position, Width, Height, c);\n</code></pre> <p>\u9996\u5148\u6211\u4eec\u83b7\u53d6\u4e00\u4e2a\u7ea2\u8272\u7684 <code>Color</code>, \u7136\u540e\u8bbe\u7f6e\u900f\u660e\u5ea6\u4e3a <code>127</code>, \u7136\u540e\u8c03\u7528\u8fd9\u4e2a\u65b9\u6cd5\u7ed8\u5236. \u4f60\u53ef\u80fd\u6ce8\u610f\u5230 <code>Width</code> \u548c <code>Height</code> \u8fd9\u4e24\u4e2a\u4e1c\u897f, \u5b83\u662f <code>Entity</code> \u7684\u4e24\u4e2a\u5c5e\u6027, \u9ed8\u8ba4\u5b83\u4eec\u90fd\u662f 0, \u5728\u4f60\u52a0\u5165\u78b0\u649e\u7bb1\u7684\u77ac\u95f4\u4ed6\u4eec\u4f1a\u53d8\u6210\u78b0\u649e\u7bb1\u7684\u5bbd\u548c\u9ad8, \u5728\u8fd9\u91cc\u5b83\u4eec\u7684\u503c\u5c31\u662f\u6211\u4eec\u4e4b\u524d\u8bbe\u7f6e\u7684 <code>Hitbox</code> \u7684\u5bbd\u9ad8.</p>"},{"location":"begin/simple_entity/#_9","title":"\u51c6\u5907\u5c31\u7eea","text":"<p>\u90a3\u4e48, \u4e00\u5207\u5c31\u7eea, \u7f16\u8bd1\u4f60\u7684\u9879\u76ee, \u5230\u90a3\u4e2a\u5730\u65b9, \u5728\u534a\u900f\u660e\u7ea2\u8272\u7684\u533a\u57df\u91cc\u4eab\u53d7\u9501\u5b9a\u51b2\u523a\u6570\u7684\u5feb\u4e50\u5427!</p> <p></p> <p>\u5982\u679c\u4f60\u9047\u5230\u4e86\u56f0\u96be, \u4f60\u53ef\u4ee5\u5bf9\u6bd4\u4e00\u4e0b\u6700\u7ec8\u7684\u4ee3\u7801: PassByRefill.cs<pre><code>using Celeste.Mod.Entities;\n\nnamespace MyCelesteMod;\n\n[CustomEntity(\"MyCelesteMod/PassByRefill\")]\npublic class PassByRefill : Entity\n{\n    public int Dashes = 0;\n\n    public PassByRefill(Vector2 position, Vector2 size, int dashes)\n    {\n        Dashes = dashes;\n        Position = position;\n        Hitbox hitbox = new(size.X, size.Y);\n        Collider = hitbox;\n    }\n\n    public PassByRefill(EntityData data, Vector2 offset)\n        : this(data.Position + offset, new Vector2(data.Width, data.Height), data.Int(\"dashes\"))\n    { }\n\n    public override void Update()\n    {\n        base.Update();\n        var player = Scene.Tracker.GetEntity&lt;Player&gt;();\n        if (player is not null &amp;&amp; this.CollideCheck(player))\n        {\n            player.Dashes = this.Dashes;\n        }\n    }\n\n    public override void Render()\n    {\n        base.Render();\n        Color c = Color.Red;\n        c.A = 127;\n        Draw.Rect(Position, Width, Height, c);\n    }\n}\n</code></pre></p>"},{"location":"begin/simple_entity/#_10","title":"\u66f4\u591a","text":""},{"location":"begin/simple_entity/#loenn-dashes","title":"\u5728 Loenn \u4e2d\u7981\u6b62\u8bbe\u7f6e dashes \u4e3a\u5c0f\u6570","text":"<p>\u5728 Loenn \u4e2d\u5982\u679c\u4f60\u6ca1\u6709\u663e\u5f0f\u6307\u5b9a\u67d0\u4e2a\u6570\u5b57 data \u7684\u7c7b\u578b\u7684\u8bdd\u5b83\u9ed8\u8ba4\u4f1a\u662f\u6d6e\u70b9\u6570, \u4e5f\u5c31\u662f\u4f60\u80fd\u8f93\u5165\u5c0f\u6570, \u4e0d\u8fc7\u8fd9\u4e0d\u4f1a\u5f88\u5f71\u54cd(\u8fd8\u662f\u6709\u7684!)\u4ee3\u7801\u90a3\u8fb9, \u6240\u4ee5\u6211\u4eec\u5f97\u8ddf Loenn \u8bf4\u4e00\u4e0b\u5b83\u662f\u4e2a\u6574\u6570! \u90a3\u4e48\u6211\u4eec\u5728\u4ee3\u7801\u7684 return \u4e4b\u524d\u8fd9\u6837\u8bbe\u7f6e\u4e00\u4e0b: PassByRefill.lua<pre><code>entity.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n</code></pre> \u5728\u8fd9\u91cc\u6211\u4eec\u8bbe\u7f6e\u4e86\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027 <code>fieldInformation</code>, \u7136\u540e\u5728\u91cc\u9762\u544a\u8bc9 Loenn \u6211\u4eec\u7684 <code>dashes</code> \u8fd9\u4e2a\u5c5e\u6027\u7684 <code>fieldType</code> \u662f <code>integer</code>, \u4e5f\u5c31\u662f\u6574\u6570. \u90a3\u4e48\u73b0\u5728\u518d\u91cd\u65b0\u7f16\u8bd1, \u91cd\u542f Loenn, \u4f60\u5e94\u8be5\u4f1a\u770b\u5230 Loenn \u53ea\u5141\u8bb8\u4f60\u8f93\u5165\u6574\u6570\u4e86.</p>"},{"location":"begin/simple_entity/#loenn_2","title":"\u4e3a Loenn \u4fa7\u914d\u7f6e\u672c\u5730\u5316","text":"<p>\u73b0\u5728\u6211\u4eec\u5728 Loenn \u4fa7\u6211\u4eec\u7684\u5b9e\u4f53\u653e\u7f6e\u9009\u62e9\u7684\u540d\u79f0\u975e\u5e38\u5947\u602a! \u8fd9\u80af\u5b9a\u4e0d\u662f\u4f60\u60f3\u8981\u7684\u7ed3\u679c, \u6240\u4ee5\u8fd9\u91cc\u6211\u4eec\u5c06\u4e3a\u5176\u914d\u7f6e\u672c\u5730\u5316. \u90a3\u4e48, \u5e38\u89c4\u5730, \u6211\u4eec\u9700\u8981\u5728 <code>ModFolder/Loenn</code> \u8fd9\u4e2a\u6587\u4ef6\u5939\u4e0b\u518d\u65b0\u5efa\u4e00\u4e2a\u53eb <code>lang</code> \u6587\u4ef6\u5939, \u7136\u540e\u5728\u91cc\u9762\u521b\u5efa\u4e00\u4e2a\u53eb <code>en_gb.lang</code> \u7684\u7a7a\u6587\u4ef6,  \u5b83\u662f Loenn \u9ed8\u8ba4\u8bfb\u53d6\u7684\u672c\u5730\u5316\u6587\u4ef6. \u73b0\u5728\u4f60\u7684\u76ee\u5f55\u7ed3\u6784\u5e94\u8be5\u50cf:</p> <ul> <li>ModFolder<ul> <li>Loenn<ul> <li>entities<ul> <li>PassByRefill.lua</li> </ul> </li> <li>lang<ul> <li>en_gb.lang</li> </ul> </li> </ul> </li> </ul> </li> </ul> <p>\u5728 <code>en_gb.lang</code> \u6587\u4ef6\u91cc, \u6211\u4eec\u5199\u4e0b:</p> <pre><code>entities.MyCelesteMod/PassByRefill.placements.name.normal=PassByRefill\n</code></pre> <p>\u554a, \u8fd9\u4e00\u4e32\u53ef\u80fd\u6709\u4ebf\u70b9\u957f, \u6211\u4eec\u6162\u6162\u6765\u89e3\u91ca\u4e00\u4e0b: \u9996\u5148\u8fd9\u662f\u4e00\u4e2a\u5b9e\u4f53, \u6240\u4ee5\u4ee5 <code>entities</code> \u5f00\u5934, \u7136\u540e\u6211\u4eec\u9700\u8981\u952e\u5165\u5b9e\u4f53\u7684\"\u540d\u79f0 ID\", \u7136\u540e\u518d\u4f9d\u6b21\u952e\u5165 <code>placements</code> \u548c <code>name</code>, \u8fd9\u8868\u793a\u6211\u4eec\u60f3\u672c\u5730\u5316\u7684\u5185\u5bb9\u662f\u90a3\u4e2a\u5b9e\u4f53\u7684\u653e\u7f6e\u9009\u9879\u7684\u540d\u79f0, \u6700\u540e\u952e\u5165\u653e\u7f6e\u9009\u9879\u7684\u540d\u5b57 \"normal\"(\u5b83\u5e94\u8be5\u4f1a\u5728\u4f60\u7684 lua \u7684\u7b2c\u4e94\u884c\u9644\u8fd1). ok \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6307\u5b9a\u4e86\u6211\u4eec\u60f3\u672c\u5730\u5316\u4ec0\u4e48\u4e1c\u897f\u4e86, \u90a3\u4e48\u63a5\u4e0b\u6765\u7b80\u5355\u7684 <code>={\u5185\u5bb9}</code>, \u5728\u8fd9\u91cc\u662f <code>PassByRefill</code>. \u6700\u540e, \u7f16\u8bd1\u590d\u5236, \u91cd\u542f Loenn, \u4f60\u5e94\u8be5\u5c31\u4f1a\u770b\u5230\u6211\u4eec\u7684\u5b9e\u4f53\u7ec8\u4e8e\u6709\u4e2a\u6b63\u5e38\u540d\u5b57\u4e86:</p> <p></p> <p>Info</p> <p>\u5bf9\u4e8e\u5b83\u7684\u8d34\u56fe\u6211\u4eec\u4e4b\u540e\u518d\u8bf4, \u6211\u77e5\u9053\u4f60\u5f88\u6025\u4f46\u662f\u4f60\u5148\u522b\u6025.</p>"},{"location":"begin/simple_texturing/","title":"\u7b80\u5355\u8d34\u56fe","text":"<p>\u55ef... \u90a3\u4e48\u5230\u8fd9\u4e00\u7ae0\u6211\u4eec\u8be5\u7ed9\u6211\u4eec\u5b9e\u4f53\u4e0a\u70b9\u8d34\u56fe\u4e86, \u4ee5\u53ca\u8fd8\u6709 Loenn \u4fa7\u7684\u8d34\u56fe, \u90a3\u4e48\u7ed3\u675f\u8fd9\u4e00\u7ae0\u540e\u4f60\u5e94\u8be5\u4f1a\u89c9\u5f97\u6211\u4eec\u7684\u5b9e\u4f53\u662f\u4e2a\"\u50cf\u6837\"\u7684\u5b9e\u4f53\u4e86. \u8fd9\u91cc\u6211\u4eec\u4f1a\u4f7f\u7528\u8fd9\u4e2a 64x64 \u7684\u8d85\u7ea7\u4e11\u964b\u7684\u8d34\u56fe(\u753b\u753b\u4e00\u70b9\u4e0d\u4f1aqwq):  </p> <p> </p> \u554a\u5b83\u771f\u7684\u592a\u4e11\u964b\u4e86 <p>\u4f60\u53ef\u4ee5\u5728\u8fd9\u91cc\u4e0b\u8f7d\u5b83: fucking_ugly_texture.png</p>"},{"location":"begin/simple_texturing/#_2","title":"\u7981\u6b62\u6211\u4eec\u7684\u5b9e\u4f53\u7f29\u653e","text":"<p>\u5728\u8fd9\u91cc\u6211\u4eec\u7684\u8d34\u56fe\u662f\u6b63\u65b9\u5f62\u7684, \u6240\u4ee5\u8fd9\u91cc\u4e3a\u4e86\u65b9\u4fbf\u8d77\u89c1\u6682\u65f6\u8ba9\u6211\u4eec\u7684\u5b9e\u4f53\u4e0d\u80fd\u7f29\u653e, \u90a3\u4e48\u5728\u4ee3\u7801\u8fd9\u8fb9\u7684\u8868\u73b0\u5c31\u662f\u76f4\u63a5\u5220\u53bb\u4e0e Size \u6709\u5173\u7684\u4e1c\u897f\u5e76\u5c06\u78b0\u649e\u7bb1\u786c\u7f16\u7801\u6210 64x64 \u5927\u5c0f:</p> AfterBefore PassByRefill.cs<pre><code>public PassByRefill(Vector2 position, int dashes)\n{\n    Dashes = dashes;\n    Position = position;\n    Hitbox hitbox = new(64, 64);\n    Collider = hitbox;\n}\n\npublic PassByRefill(EntityData data, Vector2 offset)\n    : this(data.Position + offset, data.Int(\"dashes\"))\n{ }\n</code></pre> PassByRefill.cs<pre><code>public PassByRefill(Vector2 position, Vector2 size, int dashes)\n{\n    Dashes = dashes;\n    Position = position;\n    Hitbox hitbox = new(size.X, size.Y);\n    Collider = hitbox;\n}\n\npublic PassByRefill(EntityData data, Vector2 offset)\n    : this(data.Position + offset, new Vector2(data.Width, data.Height), data.Int(\"dashes\"))\n{ }\n</code></pre> <p>Info</p> <p>\u5728 Loenn \u90a3\u8fb9\u6211\u4eec\u5f85\u4f1a\u518d\u8bf4, \u5982\u679c\u4f60\u73b0\u5728\u5c31\u5220\u9664 width \u548c height \u5c5e\u6027\u7684\u8bdd\u4f60\u4f1a\u53d1\u73b0\u4f60\u653e\u7f6e\u4e0d\u4e86\u8fd9\u4e2a\u5b9e\u4f53</p>"},{"location":"begin/simple_texturing/#monocleimage","title":"\u8d34\u56fe\u4ee5\u53ca Monocle.Image","text":""},{"location":"begin/simple_texturing/#_3","title":"\u851a\u84dd\u4fa7","text":"<p>ok \u90a3\u4e48\u73b0\u5728\u6211\u4eec\u8be5\u5728\u4ee3\u7801\u8fd9\u8fb9\u6765\u70b9\u8d34\u56fe\u4e86, \u8fd9\u91cc\u6211\u4eec\u4f1a\u7528\u5230\u4e4b\u524d\u63d0\u5230\u7684 <code>Component</code> \u7684\u6982\u5ff5\u53ca\u5bf9\u5e94\u7684\u4e00\u4e2a\u65b0\u7684\u7c7b <code>Monocle.Image</code>, \u5b83\u7684\u4f5c\u7528\u5c31\u662f\u7ed8\u5236\u8d34\u56fe. \u9996\u5148\u6211\u4eec\u5f97\u8ba9\u6e38\u620f\u627e\u5230\u5e76\u52a0\u8f7d\u5230\u6211\u4eec\u7684\u8d34\u56fe, \u8fd9\u4e00\u6b65\u5f88\u7b80\u5355\u5e76\u7c7b\u4f3c, \u53ea\u9700\u8981\u5957\u51e0\u5c42\u6587\u4ef6\u5939:</p> <ul> <li>ModFolder<ul> <li>Atlases<ul> <li>Graphics<ul> <li>Gameplay<ul> <li><code>MyCelesteMod</code><ul> <li>pass_by_refill.png</li> </ul> </li> </ul> </li> </ul> </li> </ul> </li> </ul> </li> </ul> <p><code>pass_by_refill.png</code> \u5373\u6211\u4eec\u7684\u8d34\u56fe, \u5982\u679c\u4f60\u540c\u65f6\u4e5f\u662f\u4e00\u4f4d mapper \u7684\u8bdd\u4f60\u4e00\u5b9a\u5f88\u719f\u6089\u8fd9\u4e2a\u6587\u4ef6\u5939\u5957\u5957\u4e50! \u5728\u4ee3\u7801\u8fd9\u8fb9, \u6211\u4eec\u4f7f\u7528 <code>GFX.Game[\"MyCelesteMod/pass_by_refill\"]</code> \u6765\u83b7\u53d6\u8fd9\u4e2a\u8d34\u56fe, \u5b83\u662f\u4e00\u4e2a <code>MTexture</code> \u7c7b\u578b\u7684\u5b9e\u4f8b, \u5728\u83b7\u53d6\u5230\u8fd9\u4e2a\u8d34\u56fe\u540e, \u6211\u4eec <code>new</code> \u4e00\u4e2a <code>Monocle.Image</code>, \u7136\u540e\u5728\u6784\u9020\u51fd\u6570\u4e2d\u4f20\u5165\u5b83, \u7136\u540e\u4f7f\u7528 <code>this.Add</code> \u51fd\u6570\u6302\u8f7d\u5230\u6211\u4eec\u7684\u8fd9\u4e2a\u5b9e\u4f53\u4e0a, \u603b\u7684\u4ee3\u7801\u5e94\u8be5\u662f\u8fd9\u6837\u7684: PassByRefill.cs<pre><code>public PassByRefill(Vector2 position, int dashes)\n{\n    Dashes = dashes;\n    Position = position;\n    Hitbox hitbox = new(64, 64);\n    Collider = hitbox;\n\n    MTexture tex = GFX.Game[\"MyCelesteMod/pass_by_refill\"];\n    Image image = new(tex);\n    this.Add(image);\n}\n</code></pre></p> <p>Info</p> <p><code>GFX</code> \u662f\u851a\u84dd\u4e2d\u7684\u4e00\u4e2a\u7ba1\u7406\u8d34\u56fe\u7684\u7c7b, \u6211\u4eec\u7528\u5b83\u83b7\u53d6\u5230\u4e00\u4e2a\u8d34\u56fe\u7ec4 <code>Game</code>, \u7136\u540e\u5411\u5b83\u68c0\u7d22\u4e00\u4e2a\u540d\u4e3a <code>MyCelesteMod/pass_by_refill</code> \u7684\u8d34\u56fe, \u4f60\u53ef\u80fd\u4f1a\u7591\u60d1\u4e3a\u4ec0\u4e48\u8fd9\u91cc\u7684\u8def\u5f84\u53ea\u9700\u8981\u540e\u534a\u90e8\u5206, \u8fd9\u662f\u56e0\u4e3a <code>GFX.Game</code> \u53ea\u4f1a\u68c0\u7d22 <code>Atlases/Graphics/Gameplay</code> \u4e2d\u7684\u5185\u5bb9. \u540c\u6837\u7684, <code>GFX.Portraits</code> \u53ea\u4f1a\u68c0\u7d22 <code>Atlases/Graphics/Portraits</code> \u4e2d\u7684\u5185\u5bb9.</p> <p>\u987a\u4fbf\u8bb0\u5f97\u5220\u6389\u6211\u4eec\u91cd\u5199\u7684 <code>Render</code> \u51fd\u6570, \u6211\u4eec\u4e0d\u518d\u9700\u8981\u5b83\u4e86. \u603b\u7684\u7c7b\u5e94\u8be5\u662f\u8fd9\u6837\u7684: PassByRefill.cs<pre><code>[CustomEntity(\"MyCelesteMod/PassByRefill\")]\n[Tracked]\npublic class PassByRefill : Entity\n{\n    public int Dashes = 0;\n\n    public PassByRefill(Vector2 position, int dashes)\n    {\n        Dashes = dashes;\n        Position = position;\n        Hitbox hitbox = new(64, 64);\n        Collider = hitbox;\n\n        MTexture tex = GFX.Game[\"MyCelesteMod/pass_by_refill\"];\n        Image image = new(tex);\n        this.Add(image);\n    }\n\n    public PassByRefill(EntityData data, Vector2 offset)\n        : this(data.Position + offset, data.Int(\"dashes\"))\n    { }\n\n    public override void Update()\n    {\n        base.Update();\n        var player = Scene.Tracker.GetEntity&lt;Player&gt;();\n        if (this.CollideCheck(player))\n        {\n            player.Dashes = this.Dashes;\n        }\n    }\n}\n</code></pre></p>"},{"location":"begin/simple_texturing/#loenn","title":"Loenn \u4fa7","text":"<p>\u5728 Loenn \u4fa7\u8fd9\u8fb9\u4e5f\u975e\u5e38\u7b80\u5355, \u9996\u5148\u6211\u4eec\u5148\u5927\u80c6\u7684\u5220\u6389 width \u548c height \u5c5e\u6027:</p> AfterBefore PassByRefill.lua<pre><code>local entity = {}\n\nentity.name = \"MyCelesteMod/PassByRefill\"\nentity.placements = {\n    name = \"normal\",\n    data = {\n        dashes = 2\n    }\n}\n\nentity.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n\nreturn entity\n</code></pre> PassByRefill.lua<pre><code>local entity = {}\n\nentity.name = \"MyCelesteMod/PassByRefill\"\nentity.placements = {\n    name = \"normal\",\n    data = {\n        width = 16,\n        height = 16,\n        dashes = 2\n    }\n}\n\nentity.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n\nreturn entity\n</code></pre> <p>\u7136\u540e\u8bbe\u7f6e entity \u7684 <code>texture</code> \u5c5e\u6027, \u8fd9\u4f1a\u8ba9 Loenn \u4e3a\u5176\u8bbe\u7f6e\u8d34\u56fe: <pre><code>entity.texture = \"MyCelesteMod/pass_by_refill\"\n</code></pre> \u8fd9\u91cc\u7684\u8def\u5f84\u4e0e\u6211\u4eec\u4e4b\u524d\u5728\u4ee3\u7801\u4e2d\u7684\u7c7b\u4f3c. \u90a3\u4e48\u73b0\u5728\u603b\u4f53\u4e0a\u770b\u4e0a\u53bb\u5e94\u8be5\u662f\u8fd9\u6837\u7684: <pre><code>local entity = {}\n\nentity.name = \"MyCelesteMod/PassByRefill\"\nentity.placements = {\n    name = \"normal\",\n    data = {\n        dashes = 2\n    }\n}\n\nentity.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n\nentity.texture = \"MyCelesteMod/pass_by_refill\"\n\nreturn entity\n</code></pre></p>"},{"location":"begin/simple_texturing/#_4","title":"\u6700\u540e","text":"<p>\u6700\u540e\u7f16\u8bd1\u6211\u4eec\u7684\u9879\u76ee, \u6253\u5f00\u6216\u8005\u91cd\u542f Loenn, \u4f60\u5c31\u4f1a\u770b\u5230\u6211\u4eec\u7684\u5b9e\u4f53\u6709\u7740\u4e00\u4e2a\u4e0d\u600e\u4e48\u597d\u770b\u7684\u8d34\u56fe\u4e86! \u73b0\u5728\u8fdb\u5165\u5230\u6e38\u620f\u4e2d\u4f60\u4e5f\u4f1a\u770b\u5230\u8fd9\u4e2a\u4e0d\u600e\u4e48\u597d\u770b\u7684\u8d34\u56fe\u4e86!</p>"},{"location":"begin/simple_trigger/","title":"\u7b80\u5355\u81ea\u5b9a\u4e49 Trigger","text":"<p>\u5982\u679c\u4f60\u662f\u4e00\u4f4d Mapper \u7684\u8bdd\u90a3\u4f60\u4e00\u5b9a\u77e5\u9053 Trigger \u662f\u591a\u4e48\u91cd\u8981\u7684\u5b58\u5728. \u5728\u8fd9\u91cc\u53ef\u80fd\u4e0d\u662f\u5f88\u80fd\u5728\u77ed\u7bc7\u5e45\u5185\u8bf4\u660e Trigger \u7684\u91cd\u8981\u6027, \u8fd9\u91cc\u53ea\u7b80\u5355\u4e3e\u51e0\u4e2a\u4f8b\u5b50:</p> <ul> <li>\u7edd\u5927\u90e8\u5206\u955c\u5934\u7684\u79fb\u52a8\u4e0e\u504f\u79fb</li> <li>\u5267\u60c5\u7684\u89e6\u53d1, \u65e0\u5355\u53cc\u51b2\u7684\u5207\u6362</li> <li>\u98ce\u7684\u6539\u53d8</li> <li>\u91cd\u751f\u70b9\u7684\u8bbe\u7f6e</li> <li>\u97f3\u4e50\u53c2\u6570\u7684\u8bbe\u7f6e</li> <li>\u80cc\u666f\u7684\u6e10\u53d8, \u524d\u666f\u7684\u5404\u79cd\u53d8\u6362</li> </ul> <p>\u4ee5\u4e0a\u51e0\u4e2a\u4f8b\u5b50\u4e0d\u8bf4\u7edd\u5927\u90e8\u5206, \u4e5f\u6709\u5f88\u5927\u7684\u5360\u6bd4\u90fd\u662f\u7531 Trigger \u5b8c\u6210\u7684. Trigger \u662f Entity \u7684\u5b50\u7c7b, \u5b83\u5e26\u6709\u4e00\u4e2a\u957f\u65b9\u5f62\u7684\u78b0\u649e\u7bb1, \u901a\u5e38\u5b83\u662f\u5bf9\u73a9\u5bb6\u4e0d\u53ef\u89c1\u7684, \u5f53\u73a9\u5bb6 <code>\u8fdb\u5165(OnEnter)</code>, <code>\u4fdd\u6301(OnStay)</code>, <code>\u79bb\u5f00(OnLeave)</code> \u4f1a\u5206\u522b\u6267\u884c\u4e0d\u540c\u7684\u52a8\u4f5c, \u6bd4\u5982\u8bf4\u5f53\u73a9\u5bb6 <code>\u8fdb\u5165</code> \u6539\u53d8\u98ce\u7684 Trigger \u65f6\u4f1a\u6539\u53d8\u573a\u4e0a\u7684\u98ce\u7684\u60c5\u51b5, \u5f53\u73a9\u5bb6 <code>\u4fdd\u6301</code> \u5728\u955c\u5934\u504f\u79fb\u6539\u53d8 Trigger \u91cc\u65f6\u4f1a\u4fdd\u6301\u955c\u5934\u76f8\u5bf9\u4e8e\u73a9\u5bb6\u7684\u504f\u79fb\u4e8e\u4e00\u4e2a\u503c.</p> <p>Info</p> <p>\u5728\u5b98\u56fe\u7b2c\u4e5d\u7ae0\u5047\u5fc3\u9644\u8fd1\u7684 Trigger \u770b\u4e0a\u53bb\u5c31\u50cf:  \u5728\u8fd9\u91cc, \u5de6\u8fb9\u6709\u4e2a\u8bbe\u7f6e\u91cd\u751f\u70b9\u7684 Trigger, \u4e2d\u95f4\u6709\u4e2a\u4fdd\u6301\u955c\u5934\u4f4d\u7f6e\u7684 Trigger, \u800c\u5728\u53f3\u8fb9\u6709\u4e2a\u66f4\u6539\u80cc\u666f\u7684 Trigger.</p> <p>\u90a3\u4e48, \u662f\u65f6\u5019\u5236\u4f5c\u4e00\u4e2a\u5c5e\u4e8e\u6211\u4eec\u81ea\u5df1\u7684 Trigger \u4e86, \u7b80\u5355\u8d77\u89c1\u8fd9\u91cc\u6211\u4eec\u53ea\u505a\u51e0\u4e2a\u6700\u7b80\u5355\u7684\u529f\u80fd:</p> <ul> <li>\u5b83\u53eb <code>SetPassByRefillDashesTrigger</code></li> <li>\u73a9\u5bb6\u8fdb\u5165\u540e\u4fee\u6539\u573a\u4e0a\u6240\u6709\u6211\u4eec\u4e4b\u524d\u7684 <code>PassByRefill</code> \u5b9e\u4f53\u7684\u51b2\u523a\u6570</li> <li>\u6ca1\u4e86, \u662f\u7684, \u5c31\u662f\u8fd9\u4e48\u7b80\u5355!</li> </ul>"},{"location":"begin/simple_trigger/#entity","title":"\u50cf\u5bf9 Entity \u4e00\u6837\u5730\u505a\u51c6\u5907\u5de5\u4f5c","text":"<p>\u9996\u5148\u5728\u4ee3\u7801\u4e2d\u51c6\u5907\u6211\u4eec\u7684\u7c7b, \u4e0d\u8fc7\u8fd9\u6b21\u6211\u4eec\u7ee7\u627f\u7684\u662f <code>Trigger</code>. \u54e6\u5bf9\u4e86, \u5b83\u8fd8\u4f1a\u8981\u6c42\u58f0\u660e\u4e00\u4e2a\u5e26\u53c2\u7684\u6784\u9020\u51fd\u6570, \u56e0\u4e3a <code>Trigger</code> \u57fa\u7c7b\u6ca1\u6709\u65e0\u53c2\u6784\u9020\u5668, \u6240\u4ee5\u4f60\u53ef\u80fd\u9700\u8981\u50cf\u5982\u4e0b\u4e00\u6837\u58f0\u660e\u4e00\u4e0b: SetPassByRefillDashesTrigger.cs<pre><code>[CustomEntity(\"MyCelesteMod/SetPassByRefillDashesTrigger\")]\npublic class SetPassByRefillDashesTrigger : Trigger\n{\n    public SetPassByRefillDashesTrigger(EntityData data, Vector2 offset)\n        : base(data, offset)\n    {\n\n    }\n}\n</code></pre> \u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5176\u5b9e\u5b83\u8981\u6c42\u7684\u5c31\u662f Everest \u8981\u6c42\u6211\u4eec\u5b9a\u4e49\u7684\u90a3\u4e2a! \u90a3\u521a\u597d\u6211\u4eec\u5c31\u4e0d\u7528\u518d\u989d\u5916\u5b9a\u4e49\u4e00\u4e2a\u4e86. \u7136\u540e\u6211\u4eec\u7a0d\u4f5c\u66f4\u6539, \u4ee5\u8ba9\u5b83\u4e5f\u80fd\u63d0\u53d6\u5230\u4e00\u4e2a\u53eb <code>dashes</code> \u7684\u6570\u636e: SetPassByRefillDashesTrigger.cs<pre><code>public int Dashes;\n\npublic SetPassByRefillDashesTrigger(EntityData data, Vector2 offset)\n    : base(data, offset)\n{\n    Dashes = data.Int(\"dashes\");\n}\n</code></pre></p> <p>\u6784\u9020\u51fd\u6570\u94fe</p> <p>\u5f62\u5982 <code>: base(data, offset)</code> <code>: this(position)</code> \u7684\u8fd9\u79cd\u8bed\u6cd5\u53eb\u505a\u6784\u9020\u51fd\u6570\u94fe, \u8fd9\u4e00\u90e8\u5206\u4f3c\u4e4e\u5f88\u591a C# \u6559\u7a0b\u6ca1\u6709\u7279\u522b\u63d0\u53ca, \u5982\u679c\u4f60\u5bf9\u6b64\u4e0d\u662f\u5f88\u4e86\u89e3\u7684\u8bdd\u6211\u63a8\u8350\u4f60\u53bb\u67e5\u9605\u4e86\u89e3\u8be5\u8bed\u6cd5.</p> <p>\u4f60\u53ef\u80fd\u6ce8\u610f\u5230 Trigger \u4e00\u822c\u90fd\u662f\u6709\u5bbd\u5ea6\u548c\u9ad8\u5ea6\u7684, \u5728\u8fd9\u91cc\u6211\u4eec\u5e76\u6ca1\u6709\u7528 <code>EntityData data</code> \u53bb\u83b7\u53d6, \u800c\u4e14\u6211\u4eec\u4e5f\u6ca1\u8bbe\u7f6e\u5b83\u7684 <code>Position</code>! \u5b9e\u9645\u4e0a\u5f53\u4f60 <code>: base(data, offset)</code> \u65f6\u8fd9\u4e9b\u4e8b\u60c5\u5df2\u7ecf\u7531\u7236\u7c7b Trigger \u7684\u6784\u9020\u51fd\u6570\u505a\u4e86, \u5982\u679c\u4f60\u597d\u5947\u53ef\u4ee5\u7ffb\u9605 <code>Trigger</code> \u6784\u9020\u51fd\u6570\u9644\u8fd1\u7684\u4ee3\u7801.</p> Trigger.Trigger(EntityData data, Vector2 offset) <pre><code>/// .......\npublic Trigger(EntityData data, Vector2 offset)\n    : base(data.Position + offset)\n{\n    base.Collider = new Hitbox(data.Width, data.Height);\n    Visible = false;\n}\n/// .......\n</code></pre>"},{"location":"begin/simple_trigger/#trigger_1","title":"Trigger \u7684\u5b9e\u9645\u529f\u80fd","text":"<p>ok \u73b0\u5728\u8ba9\u6211\u4eec\u60f3\u60f3\u6211\u4eec\u7684 Trigger \u7684\u529f\u80fd\u5982\u4f55\u5b9e\u73b0. \u5b83\u5927\u6982\u5c31\u662f:</p> <ul> <li>\u68c0\u6d4b\u73a9\u5bb6\u662f\u5426\u8fdb\u5165<ul> <li>\u8bbe\u7f6e\u573a\u4e0a\u6240\u6709 <code>PassByRefill</code> \u7684 <code>Dashes</code> \u5b57\u6bb5</li> </ul> </li> <li>\u6ca1\u4e86</li> </ul> <p>\u5728\u8fd9\u91cc\u6211\u4eec\u4f1a\u4f7f\u7528 Trigger \u7684 <code>OnEnter</code> \u865a\u51fd\u6570, \u5b83\u4f1a\u5728\u73a9\u5bb6\u9996\u6b21\u8fdb\u5165\u76841\u5e27\u88ab\u8c03\u75281\u6b21. SetPassByRefillDashesTrigger.cs<pre><code>public override void OnEnter(Player player)\n{\n    base.OnEnter(player);\n}\n</code></pre></p> <p>Note</p> <p>\u851a\u84dd\u5185\u90e8\u5927\u90e8\u5206\u865a\u51fd\u6570\u91cd\u5199\u65f6\u6700\u597d\u5728\u5f00\u5934\u8c03\u7528\u4e00\u904d\u57fa\u7c7b\u7684\u5b9e\u73b0, \u9664\u975e\u4f60\u771f\u7684\u77e5\u9053\u5b83\u505a\u4e86\u4ec0\u4e48\u5e76\u4e14\u4f60\u771f\u7684\u4e0d\u9700\u8981\u5b83.</p> <p>\u7136\u540e\u662f\u83b7\u53d6\u573a\u4e0a\u6240\u6709\u7684 <code>PassByRefill</code>, \u4ee5\u4fbf\u6211\u4eec\u80fd\u8bbe\u7f6e\u5b83\u4eec\u7684 <code>Dashes</code>. \u8fd9\u91cc\u6211\u4eec\u4f1a\u642c\u51fa\u4e00\u4e2a\u4f60\u53ef\u80fd\u773c\u719f\u7684\u4e00\u4e32: SetPassByRefillDashesTrigger.OnEnter(Player player)<pre><code>// \u83b7\u53d6\u6240\u6709\u7684 PassByRefill\nvar refills = Scene.Tracker.GetEntities&lt;PassByRefill&gt;();\n</code></pre></p> <p>\u5728\u8fd9\u91cc\u6216\u8bb8\u8be5\u4ecb\u7ecd\u4ecb\u7ecd\u8fd9\u4e00\u4e32\u662f\u4ec0\u4e48\u4e86, \u9996\u5148\u6211\u4eec\u901a\u8fc7 <code>Scene</code> \u5c5e\u6027\u83b7\u53d6\u81ea\u8eab\u6240\u5728\u7684\u573a\u666f, \u7136\u540e\u83b7\u53d6\u5b83\u7684 <code>Tracker</code>. Tracker \u662f\u851a\u84dd\u573a\u666f\u5185\u7684\u4e00\u4e2a\u8f85\u52a9\u7c7b, \u5b83\u53ef\u4ee5\u5f88\u5feb\u7684\u5e2e\u4f60\u7b5b\u9009\u51fa\u573a\u4e0a\u7684\u5b9e\u4f53, \u5728\u8fd9\u91cc\u6211\u4eec\u4f7f\u7528\u5b83\u7684 <code>GetEntities&lt;T&gt;</code> \u6765\u7b5b\u9009\u51fa\u6240\u6709\u7c7b\u578b\u4e3a <code>T</code>, \u4e5f\u5c31\u662f <code>PassByRefill</code> \u7684\u5b9e\u4f53. \u90e8\u5206\u5b9e\u4f53\u5728\u573a\u4e0a\u53ef\u80fd\u6c38\u8fdc\u53ea\u6709\u4e00\u4e2a\u5b9e\u4f8b\u65f6, \u6bd4\u5982\u8bf4\u6211\u4eec\u7684 <code>Player</code>, \u9664\u975e\u4f60\u5b89\u88c5\u4e86\u5947\u5947\u602a\u602a\u7684 mod, \u5426\u5219\u5b83\u6c38\u8fdc\u53ea\u6709\u4e00\u4e2a\u5b9e\u4f8b, \u8fd9\u79cd\u60c5\u51b5\u4e0b\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 <code>GetEntity</code>, \u5b83\u53ea\u4f1a\u8fd4\u56de\u4e00\u4e2a\u5b9e\u4f8b. \u90a3\u4e48\u4f60\u73b0\u5728\u5e94\u8be5\u61c2\u5f97\u4e4b\u524d\u6211\u4eec\u5199\u4e0b\u7684 <code>Scene.Tracker.GetEntity&lt;Player&gt;()</code> \u662f\u4ec0\u4e48\u610f\u601d\u4e86: \"\u4f7f\u7528\u573a\u666f\u7684 Tracker \u83b7\u53d6\u573a\u4e0a\u552f\u4e00\u7684\u90a3\u4e2a Player \u5b9e\u4f8b\".  </p> <p>\u54e6\u5bf9\u4e86, \u6211\u4eec\u8fd8\u5f97\u5728\u6211\u4eec\u60f3\u8981 Tracker \u83b7\u53d6\u7684\u5b9e\u4f53\u7684\u7c7b\u4e0a\u52a0\u4e00\u4e2a <code>Tracked</code> \u7279\u6027, \u5c31\u50cf: PassByRefill.cs<pre><code>[CustomEntity(\"MyCelesteMod/PassByRefill\")]\n[Tracked]\npublic class PassByRefill : Entity\n{\n</code></pre> \u8fd9\u4e00\u6b65\u5176\u5b9e\u5f88\u5bb9\u6613\u88ab\u5fd8\u8bb0, \u5c31\u50cf\u6211\u5199\u5b8c\u521d\u7a3f\u5e76\u505a\u5230\u6700\u540e\u4e00\u6b65\u6e38\u620f\u5d29\u6e83\u65f6\u624d\u60f3\u8d77\u6765(\u4e50).</p> <p>\u597d\u7684\u7136\u540e\u6211\u4eec\u8be5\u8bbe\u7f6e <code>PassByRefill</code> \u4eec\u7684 <code>Dashes</code>... \u989d\u7b49\u7b49! \u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u8fd9\u91cc\u7684 <code>refills</code> \u5c40\u90e8\u53d8\u91cf\u5176\u5b9e\u662f\u4e2a <code>List&lt;Entity&gt;</code> \u7c7b\u578b, \u8fd9\u4e2a\u6211\u4e0d\u592a\u6e05\u695a\u4e3a\u4ec0\u4e48, \u4f30\u8ba1\u662f\u4e00\u4e2a <code>Monocle</code> \u5728\u5b9e\u73b0\u4e2d\u7684\u4e00\u4e2a\u5c0f\u9519\u8bef, \u4e3a\u4e86\u7ea0\u6b63\u5b83\u8fd9\u91cc\u6211\u4f1a\u4f7f\u7528 <code>Linq</code> \u7684 <code>Cast</code> \u6765\u8f6c\u6362\u4e00\u4e0b\u7c7b\u578b:</p> SetPassByRefillDashesTrigger.OnEnter(Player player)<pre><code>var refills = Scene.Tracker.GetEntities&lt;PassByRefill&gt;().Cast&lt;PassByRefill&gt;();\n</code></pre> <p>ok, \u73b0\u5728\u6211\u4eec\u5c31\u53ef\u4ee5\u5f00\u59cb\u904d\u5386\u5e76\u8bbe\u7f6e\u4e86: SetPassByRefillDashesTrigger.OnEnter(Player player)<pre><code>foreach(var refill in refills)\n{\n    refill.Dashes = this.Dashes;\n}\n</code></pre></p> <p>\u6700\u540e, \u4f60\u7684\u4ee3\u7801\u5e94\u8be5\u603b\u4f53\u4e0a\u662f\u8fd9\u4e2a\u6837\u5b50: SetPassByRefillDashesTrigger.cs<pre><code>using Celeste.Mod.Entities;\n\nnamespace MyCelesteMod;\n\n[CustomEntity(\"MyCelesteMod/SetPassByRefillDashesTrigger\")]\npublic class SetPassByRefillDashesTrigger : Trigger\n{\n    public int Dashes;\n\n    public SetPassByRefillDashesTrigger(EntityData data, Vector2 offset)\n        : base(data, offset)\n    {\n        Dashes = data.Int(\"dashes\");\n    }\n\n    public override void OnEnter(Player player)\n    {\n        base.OnEnter(player);\n        var refills = Scene.Tracker.GetEntities&lt;PassByRefill&gt;().Cast&lt;PassByRefill&gt;();\n        foreach(var refill in refills)\n        {\n            refill.Dashes = this.Dashes;\n        }\n    }\n}\n</code></pre></p>"},{"location":"begin/simple_trigger/#loenn","title":"Loenn \u914d\u7f6e","text":"<p>ok \u6211\u4eec\u7684 Trigger \u7684\u4ee3\u7801\u5df2\u7ecf\u5199\u597d\u4e86, \u63a5\u4e0b\u6765\u5199\u4e00\u4e2a Loenn \u914d\u7f6e\u5c31\u597d\u4e86, \u8fd9\u4e00\u6b65\u4e0e Entity \u7684\u5f88\u50cf, \u4e0d\u8fc7\u4f60\u9700\u8981\u628a\u5b83\u653e\u5230 triggers \u6587\u4ef6\u5939\u5185:</p> <ul> <li>ModFolder<ul> <li>Loenn<ul> <li>entities<ul> <li>PassByRefill.lua</li> </ul> </li> <li>triggers<ul> <li>SetPassByRefillDashesTrigger.lua</li> </ul> </li> </ul> </li> </ul> </li> </ul> <p>\u5185\u5bb9\u5927\u540c\u5c0f\u5f02:</p> SetPassByRefillDashesTrigger.lua<pre><code>local trigger = {}\n\ntrigger.name = \"MyCelesteMod/SetPassByRefillDashesTrigger\"\ntrigger.placements = {\n    name = \"normal\",\n    data = {\n        width = 16,\n        height = 16,\n        dashes = 2\n    }\n}\n\ntrigger.fieldInformation = \n{\n    dashes = {\n        fieldType = \"integer\"\n    }\n}\n\nreturn trigger\n</code></pre> <p>\u6700\u540e\u8bb0\u5f97\u5199\u4e2a\u672c\u5730\u5316\u4fe1\u606f, \u4e0d\u7136\u5b83\u7684\u540d\u5b57\u80af\u5b9a\u4f1a\u5f88\u4e11! \u8fd9\u4e00\u6b65\u4e5f\u662f\u5f88\u7c7b\u4f3c\u7684: <pre><code>entities.MyCelesteMod/PassByRefill.placements.name.normal=PassByRefill\ntriggers.MyCelesteMod/SetPassByRefillDashesTrigger.placements.name.normal=SetPassByRefillDashesTrigger\n</code></pre></p> <p>Note</p> <p>\u522b\u5fd8\u4e86\u7f16\u8bd1, \u4e0d\u8981\u50cf\u6211\u4e00\u6837\u5bf9\u7740 Loenn \u7591\u60d1\u6211\u7684 trigger/\u5b9e\u4f53 \u600e\u4e48\u4e0d\u89c1\u4e86(</p>"},{"location":"begin/simple_trigger/#_1","title":"\u6548\u679c","text":"<p>\u73b0\u5728\u5728\u4f60\u7684\u5730\u56fe\u4e0a\u6446\u653e\u8fd9\u4e2a trigger \u4ee5\u53ca\u51e0\u4e2a <code>PassByRefill</code>. \u6211\u5728\u8fd9\u91cc\u4f1a\u6446\u51e0\u4e2a\u80cc\u666f\u7816\u6765\u5e2e\u6211\u4eec\u8fa8\u8bc6\u8fd9\u4e2a trigger \u5728\u54ea, \u56e0\u4e3a trigger \u901a\u5e38\u90fd\u662f\u4e0d\u53ef\u89c1\u7684.  \u90a3\u4e48\u89c1\u8bc1\u4f60\u7684\u6770\u4f5c\u5427! </p> <p>\u8fdb\u5165 trigger \u524d (PassByRefill \u7684 Dashes \u8bbe\u7f6e\u4e3a 2): \u8fdb\u5165 trigger \u540e (\u88ab\u8bbe\u7f6e\u4e3a 1 \u4e86): </p>"},{"location":"extra_luacs/","title":"\u989d\u5916 - LuaCutscene","text":""},{"location":"extra_luacs/#_1","title":"\u524d\u8a00","text":"<p>\u6b22\u8fce\u6765\u5230\u8fd9\u4e2a\u989d\u5916\u7ae0\u8282, \u867d\u7136\u5b83\u88ab\u6211\u6254\u5230\u4e86 code mod \u6559\u7a0b\u4e4b\u4e2d, \u4f46\u662f\u5b83\u5b9e\u9645\u4e0a\u4e0d\u9700\u8981\u592a\u591a\u7684 C# \u80fd\u529b. \u5728\u8fd9\u91cc\u4f1a\u4e3b\u8981\u5305\u542b\u4e00\u4e9b LuaCutscene \u672c\u8eab\u4ee5\u53ca\u4f7f\u7528\u5176\u8c03\u7528 C# \u4ee3\u7801\u5b9e\u73b0\u7684\u6709\u8da3\u7684\u6548\u679c, \u5982\u679c\u4f60\u60f3\u8981\u4f60\u7684\u5267\u60c5\u62e5\u6709\u66f4\u591a\u7684\u70ab\u9177\u6548\u679c, \u800c\u4e0d\u662f\u5c40\u9650\u4e8e\u53ea\u6709\u5bf9\u8bdd\u6846\u548c Madeline \u65e0\u804a\u7684\u8d70\u52a8, \u6bd4\u5982\u70ab\u9177\u7684\u955c\u5934\u7f13\u52a8, \u5468\u8fb9\u5b9e\u4f53\u7684\u82b1\u6837\u8868\u6f14, \u751a\u81f3\u662f\u62e5\u6709\u6539\u53d8 gp \u80fd\u529b\u7684\u5267\u60c5! \u90a3\u4e48\u6216\u8bb8\u8fd9\u91cc\u521a\u597d\u5c31\u9002\u5408\u4f60. \u90a3\u4e48\u73b0\u5728\u5c31\u5f00\u59cb\u5427.  </p>"},{"location":"extra_luacs/#_2","title":"\u914d\u7f6e\u73af\u5883","text":"<p>\u8fd9\u4e00\u6b65\u4e8b\u5b9e\u4e0a\u662f\u53ef\u9009\u7684, \u4e0d\u8fc7\u4e3a\u4e86\u66f4\u6109\u5feb\u7684 lua \u4ee3\u7801\u7684\u4e66\u5199, \u6211\u4e2a\u4eba\u8fd8\u662f\u89c9\u5f97\u633a\u6709\u5fc5\u8981\u7684. \u5728\u8fd9\u91cc\u6211\u4f1a\u63a8\u8350\u4f7f\u7528 VSCode \u914d\u4e0a Lua(sumneko.lua) \u63d2\u4ef6. </p> <p>Note</p> <p>\u6211\u4e2a\u4eba\u4e0d\u592a\u4f1a\u914d\u7f6e\u8fd9\u79cd lua \u73af\u5883, \u6240\u4ee5\u5982\u679c\u4f60\u9047\u5230\u4e86\u5927\u91cf\u7684\u672a\u5b9a\u4e49\u8b66\u544a\u4f60\u53ef\u4ee5\u9009\u62e9\u5728\u8bbe\u7f6e\u4e2d\u641c\u7d22 <code>Lua.diagnostics.enable</code> \u5e76\u5c06\u5176\u5173\u95ed.</p>"},{"location":"extra_luacs/#hello-world","title":"Hello World","text":"<p>\u90a3\u4e48, \u8001\u4f20\u7edf. \u73b0\u5728, \u5728\u4f60\u7684\u5730\u56fe\u4e2d\u653e\u7f6e\u4e00\u4e2a <code>LuaCutscene</code> \u7684 <code>LuaCutscene/LuaCutsceneTrigger</code>, \u7136\u540e\u8bbe\u7f6e\u5176 <code>Filename</code> \u53c2\u6570\u4e3a\u4e00\u4e2a lua \u6587\u4ef6\u7684\u8def\u5f84\u6bd4\u5982 <code>Luas/testlua</code>(\u6ce8\u610f\u6ca1\u6709\u540e\u7f00.lua), \u7136\u540e Save Changes. \u7136\u540e\u6211\u4eec\u6839\u636e\u521a\u624d\u8bbe\u7f6e\u7684\u8def\u5f84\u6b63\u786e\u653e\u7f6e\u6211\u4eec\u7684 lua \u6587\u4ef6:</p> <ul> <li>&lt;\u4f60\u7684 mod \u540d\u5b57&gt;<ul> <li>Luas<ul> <li>testlua.lua</li> </ul> </li> </ul> </li> </ul> <p>\u7136\u540e\u5199\u4e0a\u6211\u4eec\u7684 Hello World!</p> <pre><code>function onBegin()\n    print(\"[Cutscene] Hello from the Cutscene!\")\nend\n</code></pre> <p>\u4fdd\u5b58\u540e\u6309\u4e0b F3 \u952e\u91cd\u8f7d\u4f60\u7684\u5730\u56fe, \u7136\u540e\u8d70\u8fdb\u4f60\u6446\u653e\u7684 trigger \u5185, \u4e4b\u540e, \u68c0\u67e5\u4f60\u7684\u63a7\u5236\u53f0, \u6216\u8005\u68c0\u67e5\u4f60\u6700\u65b0\u7684 log.txt, \u4f60\u5e94\u8be5\u4f1a\u5728\u832b\u832b\u65e5\u5fd7\u6d77\u4e2d\u770b\u5230\u8fd9\u4e00\u884c\u8f93\u51fa:</p> <pre><code>(12/03/2023 10:36:35) [Everest] [Info] [LevelLoader] Loading Saplonily/FunnyButFuckingMaps/MaybeAFunnyMap\n(12/03/2023 10:36:35) [Everest] [Warn] [Content] CONFLICT in C:\\Program Files (x86)\\Steam\\steamapps\\common\\Celeste\\Mods\\MaxHelpingHand v1.28.3.zip\\Graphics\\Sprites.xml: Overriding element player_playback.\n[Cutscene] Hello from the Cutscene!\n(12/03/2023 10:36:45) [Everest] [Info] [LevelLoader] Loading Saplonily/FunnyButFuckingMaps/MaybeAFunnyMapOverriding element player_playback.\n</code></pre> <p>\u9ad8\u4eae\u884c\u4fbf\u662f\u6211\u4eec\u7684 lua \u4ee3\u7801\u6253\u5370\u51fa\u6765\u7684.</p> <p>Info</p> <p>\u5728\u4e4b\u540e\u7684\u8fc7\u7a0b\u4e2d\u867d\u7136\u4f60\u53ef\u4ee5\u53cd\u590d\u7ffb\u770b log.txt \u6765\u77e5\u6653\u4f60\u7684 lua \u4ee3\u7801\u7684\u8fd0\u884c\u60c5\u51b5, \u4e0d\u8fc7\u8fd9\u663e\u7136\u4e0d\u5982\u4f60\u6709\u4e00\u4e2a\u63a7\u5236\u53f0\u7a97\u53e3\u76f4\u63a5\u80fd\u770b\u5230\u8f93\u51fa. \u5bf9\u4e8e\u5728 windows \u4e0a, \u4f60\u53ef\u4ee5\u5411\u851a\u84dd\u6839\u76ee\u5f55\u4e0b\u7684\u6587\u4ef6 <code>everest-launch.txt</code> \u65b0\u52a0\u5165\u4e00\u884c <code>--console</code> \u6765\u5728\u851a\u84dd\u6bcf\u6b21\u542f\u52a8\u65f6\u9644\u5e26\u4e00\u4e2a\u63a7\u5236\u53f0\u7a97\u53e3.</p>"},{"location":"extra_luacs/#hello-world_1","title":"\u5bf9\u8bdd Hello World","text":"<p>\u5f53\u7136, \u5728\u63a7\u5236\u53f0\u91cc\u770b\u65e0\u804a\u7684\u65e5\u5fd7\u6253\u5370\u662f\u6ca1\u610f\u601d\u7684, \u6240\u4ee5\u73b0\u5728\u6211\u4eec\u5411\u5b83\u52a0\u5165\u51e0\u6761\u5bf9\u8bdd. \u9996\u5148\u4e3a\u4f60\u8fd9\u4e00\u6bb5\u5bf9\u8bdd\u8d77\u4e00\u6bb5\u540d\u5b57, \u6bd4\u5982 <code>TESTDIALOG_HELLO</code>, \u901a\u5e38\u6211\u4eec\u5efa\u8bae\u524d\u7f00\u662f\u4f60\u7684\u5730\u56fe\u540d\u4ee5\u9632\u547d\u540d\u51b2\u7a81, \u540e\u7f00\u4f60\u53ef\u4ee5\u6839\u636e\u4f60\u7684\u7231\u597d\u6765\u53d6, \u6bd4\u5982\u52a0\u4e0a\u5267\u60c5\u6240\u5728\u9762\u540d, \u6216\u8005\u5e72\u8106\u662f\u5267\u60c5\u7684\u81ea\u589e\u5e8f\u53f7. \u7136\u540e\u65b0\u5efa\u4e00\u4e2a <code>Simplified Chinese.txt</code>, \u4e5f\u5c31\u662f\u5bf9\u8bdd\u6587\u4ef6:</p> <ul> <li>&lt;\u4f60\u7684 mod \u540d\u5b57&gt;<ul> <li>Dialog<ul> <li>Simplified Chinese.txt</li> </ul> </li> </ul> </li> </ul> <p>\u4ee5\u53ca\u5b83\u7684\u5185\u5bb9:</p> <pre><code>TESTDIALOG_HELLO=\n    [MADELINE left normal]\n    \u6211\u662f {+MADELINE}.\n</code></pre> <p>\u7136\u540e\u66f4\u6539 lua \u4ee3\u7801:</p> <pre><code>function onBegin()\n    say(\"TESTDIALOG_HELLO\")\nend\n</code></pre> <p>\u73b0\u5728\u91cd\u8f7d\u8d44\u6e90, \u8fdb\u5165 trigger, \u4f60\u5c31\u80fd\u770b\u5230 Madeline <sub>~\u5fae\u7b11</sub>~\u7740\u8bf4 \"\u6211\u662f &lt;\u4f60\u7684\u5b58\u6863\u540d&gt;.\" \u4e86. \u5728\u8fd9\u91cc\u5bf9\u8bdd\u72b6\u6001\u65f6\u73a9\u5bb6\u4f9d\u7136\u80fd\u52a8, \u53ef\u4ee5\u901a\u8fc7\u5c06 lua \u4ee3\u7801\u6539\u6210\u8fd9\u6837\u6765\u5728\u5bf9\u8bdd\u8fdb\u884c\u65f6\u7981\u6b62\u79fb\u52a8:</p> <pre><code>function onBegin()\n    disableMovement()\n    say(\"TESTDIALOG_HELLO\")\n    enableMovement()\nend\n</code></pre>"},{"location":"extra_luacs/#_3","title":"\u57fa\u7840\u6982\u5ff5","text":"<p>\u76f8\u4fe1\u5728\u524d\u9762\u7684\u9605\u8bfb\u4e2d\u4f60\u80af\u5b9a\u662f\u4e00\u5934\u96fe\u6c34\u7684, \u56e0\u4e3a\u4f60\u5bf9 lua \u4ee3\u7801\u901a\u5e38\u4f9d\u7136\u662f\u4e00\u65e0\u6240\u77e5\u7684, \u90a3\u5c31\u5bf9\u4e86, \u73b0\u5728\u6211\u4eec\u5c31\u6765\u4ecb\u7ecd\u51e0\u4e2a\u7b80\u5355\u7684\u6982\u5ff5.</p>"},{"location":"extra_luacs/#_4","title":"\u51fd\u6570","text":"<p>\u5728\u6211\u4eec\u521a\u521a\u7684 lua \u4ee3\u7801\u4e2d, \u6700\u5916\u56f4\u7684\u7531 <code>function</code> \u5230 <code>end</code> \u56f4\u8d77\u6765\u7684\u4e1c\u897f\u6211\u4eec\u5c31\u53eb\u4e00\u4e2a\u51fd\u6570:</p> <pre><code>function onBegin()\n    disableMovement()\n    say(\"TESTDIALOG_HELLO\")\n    enableMovement()\nend\n</code></pre> <p><code>function</code> \u548c <code>end</code> \u8fd9\u79cd\u5173\u7cfb\u5230\u4ee3\u7801\u7ed3\u6784\u7684\u4e1c\u897f\u6211\u4eec\u5c31\u53eb\u5b83 '\u5173\u952e\u5b57', <code>function</code> \u5173\u952e\u5b57\u540e\u9762\u5230\u5de6\u62ec\u53f7\u4e4b\u5185\u7684\u5185\u5bb9\u5c31\u662f\u8fd9\u4e2a\u51fd\u6570\u7684\u51fd\u6570\u540d, \u5728\u8fd9\u91cc\u5373 <code>onBegin</code>, \u5728\u8fd9\u91cc\u8fd9\u4e2a\u51fd\u6570\u540d\u662f\u7279\u6b8a\u7684, \u5b83\u4f1a\u88ab LuaCutscene \u5728\u73a9\u5bb6\u8fdb\u5165 trigger \u65f6\u4e14\u5267\u60c5\u53ef\u4ee5\u64ad\u653e\u65f6 '\u8c03\u7528'. \u62ec\u53f7\u5185\u7684\u5185\u5bb9\u6211\u4eec\u53eb\u53c2\u6570, \u8fd9\u91cc LuaCutscene \u8981\u6c42\u6211\u4eec <code>onBegin</code> \u8fd9\u4e2a\u7279\u6b8a\u51fd\u6570\u4e0d\u80fd\u5e26\u53c2\u6570\u6216\u8005\u5e26\u4e00\u4e2a\u53c2\u6570, \u8fd9\u91cc\u6211\u4eec\u6682\u65f6\u7f6e\u7a7a, \u4e5f\u5c31\u662f\u53ea\u6709\u4e00\u5bf9\u62ec\u53f7, \u4e0d\u5e26\u53c2\u6570. \u800c\u8fd9\u4e4b\u4e2d\u7684\u5185\u5bb9\u4fbf\u662f\u51fd\u6570\u7684\u5185\u5bb9\u7269, \u4e5f\u5373\u4e3b\u4f53, \u5b83\u4f1a\u4ece\u4e0a\u5230\u4e0b\u987a\u5e8f\u6267\u884c\u6211\u4eec\u7684\u4ee3\u7801.  </p> <p>\u901a\u5e38\u4e3b\u4f53\u662f\u6211\u4eec\u6240\u805a\u7126\u7684\u4e1c\u897f, \u5728\u8fd9\u91cc, \u6211\u4eec\u7684\u4e3b\u4f53\u5305\u542b\u4e09\u884c\u4ee3\u7801. \u7b2c\u4e00\u884c\u4ee3\u7801\u662f <code>disableMovement()</code>, \u4e5f\u5c31\u662f\u4e00\u4e2a\u540d\u79f0\u52a0\u4e0a\u4e00\u5bf9\u62ec\u53f7, \u5b83\u8868\u793a\u8c03\u7528\u4e00\u4e2a\u540d\u4e3a <code>disableMovement</code> \u7684\u51fd\u6570, \u5e76\u4e14\u4e0d\u5e26\u53c2\u6570, \u8fd9\u548c\u521a\u624d\u51fd\u6570\u7684\u58f0\u660e\u6709\u70b9\u76f8\u50cf, <code>disableMovement</code> \u662f\u4e00\u4e2a LuaCutscene \u4e3a\u6211\u4eec\u63d0\u524d\u51c6\u5907\u597d\u7684, \u4e5f\u5373 '\u5b9a\u4e49' \u597d\u7684\u51fd\u6570, \u5b83\u7684\u4f5c\u7528\u662f\u7981\u6b62\u73a9\u5bb6\u7684\u79fb\u52a8, \u4e0e\u4e4b\u76f8\u5bf9\u7684\u5c31\u662f <code>enableMovement</code> \u51fd\u6570, \u5b83\u4f1a\u5141\u8bb8\u73a9\u5bb6\u79fb\u52a8. \u4e2d\u95f4\u7684\u7b2c\u4e8c\u884c\u4ee3\u7801\u8c03\u7528\u4e86 <code>say</code> \u8fd9\u4e2a\u51fd\u6570, \u5b83\u8868\u793a\u64ad\u653e\u4e00\u4e2a\u5bf9\u8bdd, \u90a3\u4e48\u8fd9\u91cc\u5bf9\u8bdd\u540d\u5c31\u9700\u8981\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u4e86, \u6240\u4ee5\u6211\u4eec\u5728\u62ec\u53f7\u4e2d\u5199\u5165\u521a\u624d\u6211\u4eec\u7684\u5bf9\u8bdd\u540d <code>TESTDIALOG_HELLO</code>, \u8bb0\u4f4f\u8981\u5e26\u53cc\u5f15\u53f7, \u56e0\u4e3a\u5b83\u662f\u4e00\u4e2a '\u5b57\u7b26\u4e32'.  </p> <p>Info</p> <p><code>disableMovement</code> \u4e0e <code>enableMovement</code> \u51fd\u6570\u90fd\u662f\u77ac\u95f4\u6267\u884c\u5b8c\u6bd5\u7684, \u51fd\u6570\u4f1a\u9a6c\u4e0a\u7ee7\u7eed\u6267\u884c\u4e0b\u9762\u7684\u4ee3\u7801, \u800c <code>say</code> \u51fd\u6570\u8c03\u7528\u540e\u76f4\u5230\u73a9\u5bb6\u770b\u5b8c\u5bf9\u8bdd\u624d\u4f1a\u7ee7\u7eed\u6267\u884c\u4e0b\u9762\u7684\u4ee3\u7801. \u5bf9\u4e8e\u540e\u8005\u6211\u4eec\u7279\u522b\u5730\u79f0\u4e3a <code>\u534f\u7a0b\u51fd\u6570</code>.</p>"},{"location":"extra_luacs/#if","title":"\u53d8\u91cf, \u8fd4\u56de\u503c, if","text":"<p>\u73b0\u5728, \u6211\u4eec\u89c2\u5bdf\u4e0b\u9762\u4ee3\u7801:</p> <pre><code>function onBegin()\n    local hasFlag = getFlag(\"MY_AWESOME_FLAG\")\n    if hasFlag then\n        disableMovement()\n        say(\"TESTDIALOG_HELLO\")\n        enableMovement()\n    end\nend\n</code></pre> <p>\u5728\u51fd\u6570\u5f00\u5934\u6211\u4eec\u4f7f\u7528\u4e86 <code>local a = b()</code> \u8fd9\u79cd\u8bed\u6cd5, \u5f00\u5934\u7684 <code>local</code> \u5173\u952e\u5b57\u8868\u793a\u6211\u4eec\u8981\u58f0\u660e\u4e00\u4e2a\u53d8\u91cf, \u7d27\u8ddf\u7684 <code>hasFlag</code> \u8868\u793a\u8fd9\u4e2a\u53d8\u91cf\u7684\u540d\u79f0, \u968f\u540e\u518d\u6b21\u8ddf\u4e0a\u4e00\u4e2a <code>=</code> \u53f7, \u8fd9\u8868\u793a\u6211\u4eec\u60f3\u4ee5 <code>=</code> \u53f7\u540e\u8fb9\u7684\u503c\u4f5c\u4e3a\u8fd9\u4e2a\u53d8\u91cf\u7684\u503c, \u5728\u8fd9\u91cc\u5b83\u662f <code>getFlag</code> \u8fd9\u4e2a\u9884\u5148\u5b9a\u4e49\u7684\u51fd\u6570\u7684\u8fd4\u56de\u503c, \u51fd\u6570\u901a\u5e38\u7528\u4e8e\u505a\u4e00\u4e9b\u4e8b\u60c5, \u800c\u5b83\u7684\u8fd4\u56de\u503c\u5c31\u8868\u793a\u8fd9\u4ef6\u4e8b\u505a\u7684\u5982\u4f55, \u5728\u8fd9\u91cc <code>getFlag</code> \u51fd\u6570\u7528\u4e8e\u68c0\u6d4b\u5b83\u7684\u53c2\u6570\u6307\u4ee3\u7684\u90a3\u4e2a flag \u662f\u5426\u5b58\u5728, \u5f53\u68c0\u6d4b\u5230 flag \u5b58\u5728\u65f6\u5b83\u4f1a\u8fd4\u56de <code>true</code>, \u5426\u4e4b\u5219\u8fd4\u56de <code>false</code>. \u8fd9\u91cc\u8fd9\u4e2a\u8fd4\u56de\u503c\u7684 '\u7c7b\u578b' \u662f <code>bool</code>, \u5b83\u53ea\u6709\u521a\u624d\u63d0\u5230\u7684\u4e24\u4e2a\u503c, \u6240\u4ee5\u540c\u6837\u5730 <code>hasFlag</code> \u8fd9\u4e2a\u53d8\u91cf\u7684\u7c7b\u578b\u662f <code>bool</code>.  </p> <p>\u5f53\u6211\u4eec\u4ece <code>getFlag</code> \u5f97\u5230\u4e86\u5bf9\u5e94 flag \u662f\u5426\u5b58\u5728\u7684\u4fe1\u606f\u540e, \u6211\u4eec\u4f7f\u7528 if \u8bed\u53e5\u6765\u68c0\u6d4b\u5b83, \u9996\u5148\u6211\u4eec\u4ee5 <code>if</code> \u5f00\u5934, \u7136\u540e\u7d27\u8ddf\u4e00\u4e2a <code>bool</code> \u7c7b\u578b\u7684\u503c, \u4e5f\u5c31\u662f\u8fd9\u91cc\u7684 <code>hasFlag</code> \u53d8\u91cf, \u7136\u540e\u518d\u8ddf\u4e0a\u4e00\u4e2a <code>then</code> \u5173\u952e\u5b57, \u968f\u540e\u518d\u6b21\u8ddf\u4e0a\u4e00\u5c0f\u6bb5\u4ee3\u7801, \u968f\u540e\u4ee5 <code>end</code> \u7ed3\u675f, \u8fd9\u91cc\u7684\u610f\u601d\u5c31\u662f\u6211\u4eec\u5e0c\u671b <code>then</code> \u5230 <code>end</code> \u6240\u5305\u56f4\u8d77\u6765 '\u4ee3\u7801\u5757' \u4ec5\u5728 <code>hasFlag</code> \u4e3a <code>true</code>, \u4e5f\u5373 <code>getFlag</code> \u8fd4\u56de <code>true</code>, \u4e5f\u5373 flag <code>MY_AWESOME_FLAG</code> \u5b58\u5728\u65f6\u6267\u884c. \u73b0\u5728\u4f60\u53ef\u4ee5\u8bd5\u8bd5\u590d\u5236\u4e0a\u8ff0\u7684\u4ee3\u7801, \u7136\u540e\u5728\u4f60\u7684\u5730\u56fe\u4e2d\u653e\u7f6e\u4e24\u4e2a flag Trigger, \u4e00\u4e2a\u5f00\u542f <code>MY_AWESOME_FLAG</code> \u8fd9\u4e2a flag, \u4e00\u4e2a\u5173\u95ed flag, \u7136\u540e\u5206\u522b\u5c1d\u8bd5\u8d70\u8fdb\u5267\u60c5 trigger, \u4f60\u5f88\u5bb9\u6613\u4f1a\u53d1\u73b0\u4ec5\u5728 <code>MY_AWESOME_FLAG</code> flag \u5f00\u542f\u65f6\u5267\u60c5\u624d\u4f1a\u88ab\u64ad\u653e, \u4e5f\u5c31\u662f\u64ad\u653e\u5267\u60c5\u7684\u90a3\u4e09\u884c\u4ee3\u7801\u624d\u4f1a\u88ab\u6267\u884c.  </p> <p>\u5b9e\u9645\u4e0a\u65e2\u7136 <code>if</code> \u5230 <code>then</code> \u4e4b\u95f4\u53ea\u9700\u8981\u4e00\u4e2a\u7c7b\u578b\u4e3a <code>bool</code> \u7684\u503c, \u90a3\u4e48\u8fd9\u91cc\u5176\u5b9e\u4e0d\u9700\u8981 <code>hasFlag</code> \u8fd9\u4e2a\u53d8\u91cf\u4f5c\u4e3a\u8fc7\u6e21:</p> <pre><code>function onBegin()\n    if getFlag(\"MY_AWESOME_FLAG\") then\n        disableMovement()\n        say(\"TESTDIALOG_HELLO\")\n        enableMovement()\n    end\nend\n</code></pre> <p>\u8fd9\u884c\u4ee3\u7801\u4e0e\u4e0a\u9762\u662f\u7b49\u6548\u7684.  </p> <p>\u901a\u5e38\u6709\u65f6\u5019\u6211\u4eec\u5e0c\u671b flag \u62e5\u6709\u60c5\u51b5\u4e0d\u4e00\u7684\u65f6\u5019\u64ad\u653e\u4e0d\u540c\u7684\u5267\u60c5, \u6bd4\u5982\u4e0a\u9762\u62e5\u6709 <code>MY_AWESOME_FLAG</code> flag \u65f6\u64ad\u653e\u5267\u60c5 A, \u800c\u6ca1\u6709\u65f6\u64ad\u653e\u5267\u60c5 B. \u9996\u5148\u6211\u4eec\u5148\u66f4\u65b0\u6211\u4eec\u7684\u5bf9\u8bdd\u6587\u4ef6:</p> <pre><code>TESTDIALOG_HELLO=\n    [MADELINE left normal]\n    \u62e5\u6709 flag\n\nTESTDIALOG_HELLO_NOFLAG=\n    [MADELINE left normal]\n    \u6ca1\u6709 flag\n</code></pre> <p>\u7136\u540e\u66f4\u65b0 lua \u4ee3\u7801:</p> <pre><code>function onBegin()\n    if getFlag(\"MY_AWESOME_FLAG\") then\n        disableMovement()\n        say(\"TESTDIALOG_HELLO\")\n        enableMovement()\n    else\n        disableMovement()\n        say(\"TESTDIALOG_HELLO_NOFLAG\")\n        enableMovement()\n    end\nend\n</code></pre> <p>\u73b0\u5728\u5728\u6e38\u620f\u4e2d\u5c1d\u8bd5\u4e00\u4e0b, \u7b26\u5408\u6211\u4eec\u7684\u671f\u671b: \u6ca1\u6709 flag \u65f6\u64ad\u653e <code>TESTDIALOG_HELLO_NOFLAG</code> \u8fd9\u4e2a\u5bf9\u8bdd, \u62e5\u6709 flag \u65f6\u64ad\u653e <code>TESTDIALOG_HELLO</code> \u8fd9\u4e2a\u5bf9\u8bdd.  </p> <p>\u89c2\u5bdf\u4e0a\u8ff0\u4ee3\u7801, \u6211\u4eec\u53d1\u73b0\u7981\u6b62\u548c\u5141\u8bb8\u79fb\u52a8\u7684\u90a3\u4e00\u5bf9\u51fd\u6570\u8c03\u7528\u6ca1\u5fc5\u8981\u91cd\u590d\u4e24\u904d\u5199\u5728 if \u91cc, \u56e0\u4e3a\u65e0\u8bba if \u7684\u6761\u4ef6\u662f\u5426\u6210\u7acb\u5b83\u4eec\u90fd\u662f\u5148\u7981\u6b62\u79fb\u52a8, \u7136\u540e\u518d\u5141\u8bb8\u79fb\u52a8, \u6240\u4ee5\u6211\u4eec\u5c06\u90a3\u4e00\u5bf9\u4ee3\u7801\u62bd\u79bb\u5e76\u653e\u7f6e\u5728\u6700\u4e0a\u4e0b:</p> <pre><code>function onBegin()\n    disableMovement()\n    if getFlag(\"MY_AWESOME_FLAG\") then\n        say(\"TESTDIALOG_HELLO\")\n    else\n        say(\"TESTDIALOG_HELLO_NOFLAG\")\n    end\n    enableMovement()\nend\n</code></pre> <p>\u5f53\u7136, \u6548\u679c\u662f\u4e00\u6837\u7684, \u4f46\u662f\u6211\u4eec\u7684\u4ee3\u7801\u7b80\u6d01\u4e86\u4e0d\u5c11.</p>"},{"location":"extra_luacs/#_5","title":"\u66f4\u591a\u51fd\u6570","text":"<p>\u73b0\u5728, \u56de\u5fc6\u4e00\u4e0b\u6211\u4eec\u5df2\u7ecf\u4e86\u89e3\u5230\u4e86\u54ea\u4e9b\u51fd\u6570:</p> <ul> <li>\u4e00\u4e2a\u6700\u4e0a\u9762\u4f7f\u7528\u8fc7\u7684\u51fd\u6570 <code>print</code>, \u4f5c\u7528\u4e3a\u5c06\u5b83\u7684\u53c2\u6570\u5185\u5bb9\u8f93\u51fa\u51fa\u6765</li> <li><code>disableMovement</code>, \u6ca1\u6709\u53c2\u6570, \u4f5c\u7528\u4e3a\u7981\u6b62\u73a9\u5bb6\u7684\u79fb\u52a8</li> <li><code>enableMovement</code>, \u6ca1\u6709\u53c2\u6570, \u4f5c\u7528\u4e3a\u5141\u8bb8\u73a9\u5bb6\u7684\u79fb\u52a8</li> <li><code>say</code>, \u4f5c\u7528\u4e3a\u64ad\u653e\u53c2\u6570\u6240\u6307\u7684\u5bf9\u8bdd</li> <li><code>getFlag</code>, \u4f5c\u7528\u4e3a\u68c0\u6d4b\u53c2\u6570\u6240\u6307\u7684 flag \u662f\u5426\u5b58\u5728, \u5e76\u4e14\u8fd4\u56de\u8be5\u503c</li> </ul> <p>\u5f53\u7136, \u51fd\u6570\u7684\u53c2\u6570\u4e0d\u53ef\u80fd\u53ea\u6709\u4e00\u4e2a, \u6bd4\u5982 <code>cassetteFly</code> \u51fd\u6570:</p> <pre><code>function onBegin()\n    disableMovement()\n    cassetteFly(-100, -100)\n    -- cassetteFly \u8c03\u7528\u5b8c\u540e\u5e76\u4e0d\u4f1a\u7b49\u5f85...\n    enableMovement()\nend\n</code></pre> <p>Info</p> <p>-- \u5e76\u52a0\u4e0a\u7a7a\u683c\u8d77\u5934\u7684\u4e00\u884c\u8868\u793a\u4e00\u884c\u6ce8\u91ca, \u5f53\u4ee3\u7801\u6267\u884c\u5230\u8fd9\u65f6\u4f1a\u76f4\u63a5\u5ffd\u7565\u8fd9\u4e00\u884c, \u6b64\u5916\u8fd8\u6709\u5757\u6ce8\u91ca, \u5373\u5ffd\u7565\u5757\u6240\u5305\u56f4\u7684\u4e00\u6574\u5757\u4ee3\u7801: <pre><code>function onBegin()\n    --[[\n        \u5728\u8fd9\u91cc\n        \u5199\n        \u4efb\u610f\n        \u591a\n        \u7684\u6ce8\u91ca!\n    ]]--\n    say(\"SOMETHING_INTERESTING\")\nend\n</code></pre></p> <p><code>cassetteFly</code> \u51fd\u6570\u4f5c\u7528\u4e3a\u4e58\u5750\u6ce1\u6ce1\u98de\u884c\u4e00\u6bb5\u8ddd\u79bb(\u6536\u96c6\u78c1\u5e26\u540e\u7684\u52a8\u4f5c), \u5b83\u9700\u8981\u63a5\u6536\u4e24\u4e2a\u53c2\u6570, \u5b83\u4eec\u5747\u4e3a <code>number</code> \u7c7b\u578b, \u8868\u793a\u4e00\u4e2a\u6570\u5b57, \u591a\u4e2a\u53c2\u6570\u4e4b\u95f4\u4f7f\u7528 <code>,</code> \u9017\u53f7\u5206\u9694\u5f00\u6765, \u6ce8\u610f\u8fd9\u91cc\u53c2\u6570\u7c7b\u578b\u662f\u6570\u5b57, \u6240\u4ee5\u4e0d\u9700\u8981\u52a0\u4e0a\u53cc\u5f15\u53f7\u8868\u793a\u4e3a\u5b57\u7b26\u4e32. \u7b2c\u4e00\u4e2a\u53c2\u6570\u8868\u793a\u6a2a\u5411\u7684\u76f8\u5bf9\u98de\u884c\u8ddd\u79bb, \u5355\u4f4d px, \u6b63\u503c\u5411\u53f3, \u8d1f\u503c\u5411\u5de6, \u7b2c\u4e8c\u4e2a\u53c2\u6570\u8868\u793a\u7eb5\u5411\u7684\u76f8\u5bf9\u98de\u884c\u8ddd\u79bb, \u6b63\u503c\u5411\u4e0b, \u8d1f\u503c\u5411\u4e0a.  </p> <p>\u4e0d\u8fc7\u4e0d\u592a\u597d\u7684\u662f <code>cassetteFly</code> \u4e0d\u662f\u534f\u7a0b\u51fd\u6570, \u8fd9\u4f1a\u9020\u6210\u8c03\u7528\u4e86\u8be5\u51fd\u6570\u540e\u9a6c\u4e0a\u8c03\u7528 <code>enableMovement</code> \u51fd\u6570, \u8fd9\u4f1a\u6253\u65ad\u6ce1\u6ce1\u98de\u884c\u7684\u8fc7\u7a0b, \u6240\u4ee5\u6211\u4eec\u5148\u6682\u65f6\u5220\u6389 <code>enableMovement</code> \u7684\u8c03\u7528, \u4e0d\u8fc7\u4e0d\u8981\u62c5\u5fc3, \u6ce1\u6ce1\u98de\u884c\u7ed3\u675f\u540e\u4f1a\u81ea\u52a8\u5e2e\u6211\u4eec\u5141\u8bb8\u79fb\u52a8:</p> <pre><code>function onBegin()\n    disableMovement()\n    cassetteFly(-100, -100)\nend\n</code></pre> <p>\u7136\u540e\u5230\u6e38\u620f\u4e2d\u89c2\u5bdf\u8fd9\u4e2a\u6ce1\u6ce1\u98de\u884c\u8fdb\u884c\u6240\u9700\u7684\u5927\u6982\u65f6\u95f4, \u53d1\u73b0\u5927\u6982\u662f 1.5 \u79d2, \u6240\u4ee5\u6211\u4eec\u5728\u6ce1\u6ce1\u98de\u884c\u7684\u8c03\u7528\u540e\u9762\u7d27\u8ddf\u4e00\u4e2a <code>wait</code> \u7684\u8c03\u7528:</p> <pre><code>function onBegin()\n    disableMovement()\n    cassetteFly(-100, -100)\n    wait(1.5)\nend\n</code></pre> <p>\u987a\u4fbf, \u6ce1\u6ce1\u98de\u884c\u7ed3\u675f\u540e\u4f1a\u81ea\u52a8\u5141\u8bb8\u79fb\u52a8, \u6240\u4ee5\u6211\u4eec\u8fd8\u5f97\u518d\u6b21\u7981\u6389\u79fb\u52a8:</p> <pre><code>function onBegin()\n    disableMovement()\n    cassetteFly(-100, -100)\n    wait(1.5)\n    disableMovement()\nend\n</code></pre> <p>\u4ee5\u53ca, \u6211\u4eec\u8fd8\u5e0c\u671b\u5728\u8fd9\u4e2a\u8fc7\u7a0b\u4e4b\u540e\u518d\u64ad\u653e\u4e00\u6bb5\u5bf9\u8bdd:</p> <pre><code>function onBegin()\n    disableMovement()\n    cassetteFly(-100, -100)\n    wait(1.5)\n    disableMovement()\n    say(\"TESTDIALOG_FLY\")\nend\n</code></pre> <p>\u8fd9\u662f\u5bf9\u5e94\u7684 dialog:</p> <pre><code>TESTDIALOG_FLY=\n    [MADELINE left normal]\n    \u563f\u6211\u521a\u624d\u5b8c\u6210\u4e86\u4e00\u6b21\u6ce1\u6ce1\u98de\u884c\u54ce\n</code></pre> <p>\u987a\u4fbf\u4e0d\u8981\u5fd8\u4e86\u518d\u5141\u8bb8\u79fb\u52a8:</p> <pre><code>function onBegin()\n    disableMovement()\n    cassetteFly(-100, -100)\n    wait(1.5)\n    disableMovement()\n    say(\"TESTDIALOG_FLY\")\n    enableMovement()\nend\n</code></pre> <p>\u73b0\u5728\u5728\u6e38\u620f\u91cc\u8bd5\u4e00\u4e0b, \u662f\u4e0d\u662f\u5148\u5411\u5de6\u4e0a\u89d2\u8fdb\u884c\u4e00\u4e2a (-100, -100) \u7684\u6ce1\u6ce1\u98de\u884c, \u7136\u540e\u8fc7\u4e86 1.5 \u79d2\u540e\u51c6\u65f6\u64ad\u653e <code>TESTDIALOG_FLY</code> \u8fd9\u4e2a\u5bf9\u8bdd, \u7136\u540e\u4ec5\u5728\u5bf9\u8bdd\u7ed3\u675f\u540e\u624d\u80fd\u79fb\u52a8?</p> <p>\u9664\u4e86\u4f7f\u7528 flag trigger \u8bbe\u7f6e flag \u4ee5\u5916, \u8fd8\u53ef\u4ee5\u5728 lua \u4e2d\u8bbe\u7f6e flag:</p> <pre><code>function onBegin()\n    setFlag(\"FLAG_FROM_LUA\", true)\nend\n</code></pre> <p><code>setFlag</code> \u51fd\u6570\u63a5\u6536\u4e24\u4e2a\u53c2\u6570, \u7b2c\u4e00\u4e2a\u53c2\u6570\u4e3a string \u7c7b\u578b, \u6307\u4ee3\u4e00\u4e2a flag, \u7b2c\u4e8c\u4e2a\u53c2\u6570\u4e3a bool \u7c7b\u578b, \u8868\u793a\u8981\u8bbe\u7f6e\u4e3a\u5f00\u542f\u8fd8\u662f\u5173\u95ed. \u90a3\u4e48\u663e\u800c\u6613\u89c1, \u6548\u679c\u5c31\u662f\u7ecf\u8fc7\u8fd9\u4e2a \"\u5267\u60c5\" trigger \u65f6 <code>FLAG_FROM_LUA</code> \u8fd9\u4e2a flag \u4f1a\u88ab\u5f00\u542f. \u4f60\u53ef\u4ee5\u627e\u4e00\u4e9b\u5176\u4ed6\u7684 flag \u9a71\u52a8\u7684\u5b9e\u4f53\u6765\u9a8c\u8bc1\u4e00\u4e0b.  </p> <p>\u987a\u4fbf\u6211\u4eec\u8fd8\u53ef\u4ee5\u505a\u4e00\u4e2a\u6709\u8da3\u7684\u6548\u679c, \u7ecf\u8fc7 trigger \u65f6\u53cd\u8f6c\u5f00\u542f\u72b6\u6001:</p> <pre><code>function onBegin()\n    setFlag(\"FLAG_FROM_LUA\", not getFlag(\"FLAG_FROM_LUA\"))\nend\n</code></pre> <p><code>getFlag</code> \u8fd4\u56de\u4e86\u4e00\u4e2a bool \u7c7b\u578b\u7684\u503c, \u7136\u540e\u6211\u4eec\u5728\u8fd9\u4e2a\u503c, \u5728\u8fd9\u91cc\u662f\u51fd\u6570\u8c03\u7528\u7684\u8fd4\u56de\u503c\u5de6\u4fa7\u5199\u4e00\u4e2a not, \u5b83\u8868\u793a\u7ffb\u8f6c bool \u7684\u503c, \u5373 true -&gt; false, false -&gt; true, \u90a3\u4e48\u5728\u8fd9\u91cc\u5c31\u662f\u6bcf\u6b21\u89e6\u53d1 trigger \u65f6 <code>FLAG_FROM_LUA</code> \u7684\u5f00\u542f\u72b6\u6001\u88ab\u53cd\u8f6c.  </p>"},{"location":"extra_luacs/#_6","title":"\u903b\u8f91\u8fd0\u7b97\u7b26","text":"<p>\u5bf9\u4e8e\u8fd9\u4e9b lua \u901a\u7528\u5185\u5bb9\u5c31\u76f4\u63a5\u4e22\u4e2a w3c \u7684\u94fe\u63a5\u4e86: Lua \u8fd0\u7b97\u7b26 w3cschool - https://www.w3cschool.cn/...</p> <p>\u8fd0\u7528\u4e0a\u9762\u7684\u77e5\u8bc6\u4f60\u53ef\u4ee5\u5199\u4e00\u4e2a if \u4f7f\u5f97\u4ec5\u5728\u4e24\u4e2a flag \u540c\u65f6\u6210\u7acb\u65f6\u624d\u6267\u884c\u5185\u90e8\u7684\u4ee3\u7801:</p> <pre><code>function onBegin()\n    local flagA = getFlag(\"MY_FLAG_A\")\n    local flagB = getFlag(\"MY_FLAG_B\")\n\n    if flagA and flagB then\n        print(\"\u540c\u65f6\u6210\u7acb!\")\n    end\nend\n</code></pre>"},{"location":"extra_luacs/#_7","title":"\u5176\u4ed6\u7279\u6b8a\u51fd\u6570","text":"<p>\u9664\u4e86\u4e0a\u6587\u63d0\u5230\u7684 <code>onBegin</code> \u8fd9\u4e2a\u7279\u6b8a\u51fd\u6570\u5916, \u8fd8\u6709\u53e6\u5916\u4e00\u4e2a\u7ecf\u5e38\u7528\u5230\u7684 <code>onEnd</code> \u51fd\u6570, \u987e\u540d\u601d\u4e49, \u5c31\u662f\u5267\u60c5\u7ed3\u675f\u65f6\u88ab\u8c03\u7528\u7684\u51fd\u6570, \u5b83\u901a\u5e38\u4f1a\u5e26\u4e24\u4e2a\u53c2\u6570:</p> <pre><code>function onEnd(room, wasSkipped)\n    -- \u505a\u4e00\u4e9b\u6e05\u7406\u5de5\u4f5c...\nend\n</code></pre> <p>\u901a\u5e38\u6211\u4eec\u53ea\u4f1a\u5728 <code>onEnd</code> \u8c03\u7528\u4e2d\u505a\u6e05\u7406\u5de5\u4f5c, \u6bd4\u5982\u8bf4\u5220\u6389\u5267\u60c5\u4e2d\u51fa\u73b0\u7684\u989d\u5916\u5b9e\u4f53, \u8bbe\u7f6e\u73a9\u5bb6\u7684\u4f4d\u7f6e\u5230\u6700\u7ec8\u4f4d\u7f6e\u7b49\u7b49, \u6ce8\u610f\u7684\u662f, \u8df3\u8fc7\u5267\u60c5\u8fd9\u4e2a\u52a8\u4f5c\u5b9e\u9645\u4e0a\u4f1a\u76f4\u63a5\u6253\u65ad <code>onBegin</code> \u7684\u6267\u884c, \u5e76\u4e14\u4e5f\u4f1a\u8c03\u7528 <code>onEnd</code>, \u8fd9\u4e2a\u6253\u65ad\u4f4d\u7f6e\u662f\u4e0d\u53ef\u9884\u77e5. \u5176\u4e2d\u7b2c\u4e00\u4e2a\u53c2\u6570\u662f <code>Level</code> \u7c7b\u578b\u7684\u503c, \u5b83\u662f\u4e00\u4e2a\u851a\u84dd\u4ee3\u7801\u4e2d\u7684\u7c7b\u578b, \u8fd9\u91cc\u6211\u4eec\u6682\u65f6\u5ffd\u7565, \u6765\u5173\u6ce8\u7b2c\u4e8c\u4e2a\u53c2\u6570, \u5b83\u662f\u4e00\u4e2a <code>bool</code> \u7c7b\u578b\u7684\u503c, \u5b83\u8868\u793a\u8fd9\u4e2a\u5267\u60c5\u662f\u81ea\u7136\u7ed3\u675f\u7684\u8fd8\u662f\u88ab\u8df3\u8fc7\u7684, \u6bd4\u5982\u5728\u4e00\u4e9b\u79fb\u52a8\u8f83\u591a\u7684\u5267\u60c5\u4e2d<sub>~(\u591a\u52a8\u75c7)</sub>~, \u5176 <code>onEnd</code> \u5c31\u4f1a\u901a\u5e38\u662f\u8bbe\u7f6e\u73a9\u5bb6\u7684\u4f4d\u7f6e\u5230\u6700\u7ec8\u4f4d\u7f6e, \u987a\u5e26\u4e00\u63d0, \u5b98\u56fe\u4e2d\u6709\u4e9b\u5267\u60c5\u7684\u4f4d\u7f6e\u8bbe\u7f6e\u53ea\u8bbe\u7f6e\u4e86\u6a2a\u5750\u6807, \u6240\u4ee5\u6bd4\u5982 5a \u8fdb\u5165\u5185\u90e8\u90a3\u6bb5\u8def\u7684\u5728\u534a\u7a7a\u4e2d\u8df3\u8fc7\u5267\u60c5\u6765\u76f4\u63a5\u6a2a\u5411\u79fb\u52a8\u5230\u6309\u94ae\u4e0a\u7684\u901f\u901a\u6280\u5de7\u624d\u5f97\u4ee5\u5b9e\u73b0.  </p> <p>\u6ce8\u610f\u7684\u662f, <code>onEnd</code> \u51fd\u6570\u4e2d\u4e0d\u80fd\u4f7f\u7528\u534f\u7a0b\u51fd\u6570, \u5982\u679c\u4f60\u8fd9\u4e48\u505a\u4e86\u4f60\u4f1a\u5f97\u5230\u4e00\u4e2a <code>attempt to yield from outside a coroutine</code> \u7684\u62a5\u9519, \u8fd9\u662f\u56e0\u4e3a <code>onBegin</code> \u51fd\u6570\u672c\u8eab\u4e5f\u662f\u4e00\u4e2a\u534f\u7a0b\u51fd\u6570, \u8fd9\u624d\u5141\u8bb8\u4f60\u5728\u5185\u90e8\u4f7f\u7528\u534f\u7a0b\u51fd\u6570.</p>"},{"location":"extra_luacs/#_8","title":"\u5176\u4ed6\u51fd\u6570","text":"<p>\u9664\u4e86\u4e0a\u8ff0\u63d0\u5230\u7684 <code>say</code>, <code>getFlag</code>, <code>setFlag</code> \u7b49\u5916, \u8fd8\u6709\u975e\u5e38\u591a\u9884\u5148\u5b9a\u4e49\u597d\u7684\u51fd\u6570, \u4f60\u53ef\u4ee5\u5728\u4e0b\u9762\u8fd9\u4e2a\u94fe\u63a5\u4e2d\u627e\u5230: Lua Cutscenes Documentaion - https://maddie480.ovh/... </p> <p>\u5728\u4e0a\u9762\u8fd9\u4e2a\u6587\u6863\u4e2d\u6bd4\u5982\u8fd9\u4e2a\u51fd\u6570:</p> Function Description helpers.die([direction={0, 0}[, evenIfInvincible=false[, registerDeathInStats=true]]]) Kills the player. <p>\u5176\u4e2d helpers.die \u8bf4\u660e\u8fd9\u4e2a\u51fd\u6570\u540d\u662f die, \u540e\u9762\u5706\u62ec\u53f7\u56f4\u8d77\u6765\u7684\u8868\u793a\u5b83\u7684\u53c2\u6570, \u4e00\u5c42\u5c42\u4e2d\u62ec\u53f7\u56f4\u8d77\u6765\u7684\u8868\u793a\u53ef\u9009\u53c2\u6570, \u53c2\u6570\u540d\u540e\u9762\u52a0\u7b49\u4e8e\u53f7\u8868\u793a\u8be5\u53ef\u9009\u53c2\u6570\u7684\u9ed8\u8ba4\u503c, \u6bd4\u5982\u4e0a\u8ff0\u51fd\u6570\u7684\u8c03\u7528\u53ef\u4ee5\u6709:</p> \u8c03\u7528\u65b9\u5f0f \u7b49\u6548\u8c03\u7528\u65b9\u5f0f die() die(vector2(0, 0), false, true) die(vector2(1, 1)) die(vector2(1, 1), false, true) die(vector2(1, 1), true) die(vector2(1, 1), true, true) die(vector2(1, 1), true, false) die(vector2(1, 1), true, false) <p>\u987a\u4fbf, \u5176\u4e2d\u7b2c\u4e00\u4e2a\u53c2\u6570\u7684\u7c7b\u578b\u662f\u4e2a <code>Vector2</code>, \u8868\u793a\u4e00\u4e2a\u4e8c\u7ef4\u5411\u91cf, \u8fd9\u79cd\u7c7b\u578b\u7684\u503c\u4f60\u53ef\u4ee5\u8c03\u7528 <code>vector2(1, 1)</code> \u51fd\u6570\u6765\u4ece\u8fd4\u56de\u503c\u5f97\u5230, \u987e\u540d\u601d\u4e49\u5b83\u7684\u7b2c\u4e00\u4e2a\u53c2\u6570\u662f x \u5750\u6807, y \u5750\u6807. \u8fd9\u91cc\u5b83\u7684\u542b\u4e49\u662f\u73a9\u5bb6\u6b7b\u4ea1\u65f6\u7684\u7279\u6548\u65b9\u5411.</p>"},{"location":"extra_luacs/#c","title":"C# \u4ea4\u4e92","text":"<p>// TODO</p>"},{"location":"other/xml-speedrun/","title":"XML \u7b80\u5355\u4ecb\u7ecd","text":"<p>\u8fd9\u91cc\u4e3a\u4e86\u65b9\u4fbf\u67d0\u4e9b\u6ca1\u542c\u8bf4\u8fc7 XML \u7684\u4eba\u5feb\u901f\u4e86\u89e3 XML \u7684\u5927\u81f4\u8bed\u6cd5\u662f\u4ec0\u4e48, \u6240\u4ee5\u5f88\u591a\u7ec6\u8282\u65b9\u9762\u7684\u95ee\u9898\u6211\u4f1a\u76f4\u63a5\u5ffd\u7565, \u90a3\u4e48, \u5c31\u6b64\u5f00\u59cb\u5427:</p>"},{"location":"other/xml-speedrun/#_1","title":"\u5b9a\u4e49","text":"<p>\u8fd9\u91cc\u6458\u6284\u4e00\u4e0b:</p> <p>XML \u6307\u53ef\u6269\u5c55\u6807\u8bb0\u8bed\u8a00(eXtensible Markup Language). XML \u88ab\u8bbe\u8ba1\u7528\u6765\u4f20\u8f93\u548c\u5b58\u50a8\u6570\u636e, \u4e0d\u7528\u4e8e\u8868\u73b0\u548c\u5c55\u793a\u6570\u636e, HTML \u5219\u7528\u6765\u8868\u73b0\u6570\u636e.</p> <p>XML \u662f\u4e00\u79cd\u4ee5\u683c\u5f0f\u5316\u50a8\u5b58\u6570\u636e\u7684\u8bed\u8a00, \u5728 <code>msbuild</code> \u4e2d\u5b83\u5c31\u88ab\u7528\u6765\u4ee5\u683c\u5f0f\u5316\u7684\u65b9\u5f0f\u63cf\u8ff0\u6574\u4e2a\u9879\u76ee\u7684\u4fe1\u606f.</p>"},{"location":"other/xml-speedrun/#_2","title":"\u8282\u70b9, \u7279\u6027","text":"<p>\u4e00\u6bb5\u5f88\u57fa\u7840\u7684 XML \u53ef\u80fd\u662f\u8fd9\u4e2a\u6837\u5b50\u7684:</p> <pre><code>&lt;books&gt;\n    &lt;book id=\"123\"&gt;\u8fd9\u662f\u7b2c\u4e00\u672c\u4e66&lt;/book&gt;\n    &lt;book id=\"456\"&gt;\u8fd9\u662f\u7b2c\u4e8c\u672c\u4e66&lt;/book&gt;\n    &lt;book id=\"114\"&gt;\u8fd9\u662f\u7b2c\u4e09\u672c\u4e66&lt;/book&gt;\n    &lt;book id=\"514\"&gt;\u8fd9\u662f\u4e0d\u77e5\u9053\u7b2c\u51e0\u672c\u4e66&lt;/book&gt;\n&lt;/books&gt;\n</code></pre> <p>\u8fd9\u6bb5 XML \u7528\u4e2d\u6587\u89e3\u91ca\u8d77\u6765\u662f\u8fd9\u6837\u7684:</p> <p>\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u4e86\u4e00\u4e2a\u8282\u70b9, \u5b83\u7684\u540d\u5b57\u53eb\u505a \"books\", \u5b83\u6709\u5f88\u591a\u5b50\u8282\u70b9, \u5206\u522b\u662f:</p> <ul> <li>\u4e00\u4e2a \"book\" \u8282\u70b9, \u5b83\u7684 id \u7279\u6027\u662f 123, \u5b83\u7684\u5185\u5bb9\u662f \"\u8fd9\u662f\u7b2c\u4e00\u672c\u4e66\"</li> <li>\u4e00\u4e2a \"book\" \u8282\u70b9, \u5b83\u7684 id \u7279\u6027\u662f 456, \u5b83\u7684\u5185\u5bb9\u662f \"\u8fd9\u662f\u7b2c\u4e8c\u672c\u4e66\"</li> <li>\u4e00\u4e2a \"book\" \u8282\u70b9, \u5b83\u7684 id \u7279\u6027\u662f 114, \u5b83\u7684\u5185\u5bb9\u662f \"\u8fd9\u662f\u7b2c\u4e09\u672c\u4e66\"</li> <li>\u4e00\u4e2a \"book\" \u8282\u70b9, \u5b83\u7684 id \u7279\u6027\u662f 514, \u5b83\u7684\u5185\u5bb9\u662f \"\u8fd9\u662f\u4e0d\u77e5\u9053\u7b2c\u51e0\u672c\u4e66\"</li> </ul> <p>\u5728\u8fd9\u91cc, \u6700\u5916\u5c42\u7684 \"books\" \u4ee5\u53ca\u91cc\u9762\u7684 \"book\" \u90fd\u79f0\u4e3a\u8282\u70b9, \u5176\u4e2d \"books\" \u8282\u70b9\u5185\u90e8\u6709\u5f88\u591a \"book\" \u8282\u70b9, \u800c \"book\" \u8282\u70b9\u5185\u90e8\u53ea\u6709\u4e00\u4e32\u6587\u672c. \u6bcf\u4e2a \"book\" \u8282\u70b9\u90fd\u6709\u4e00\u4e2a\u53eb\u505a id \u7684\u7279\u6027(\u6709\u65f6\u4e5f\u53eb\u505a\u5c5e\u6027, \u4e0d\u8fc7\u6ce8\u610f\u522b\u4e0e C# \u7684\u5c5e\u6027/\u7279\u6027\u76f8\u6df7\u6dc6).  </p> <p>\u5728\u8bed\u6cd5\u5c42\u9762\u4e0a, \u4e00\u4e2a\u8282\u70b9\u4ee5 &lt;\u540d\u5b57&gt; \u5f00\u59cb\u58f0\u660e, \u5728\u53d9\u8ff0\u5b8c\u5b83\u7684\u5185\u5bb9\u540e\u4ee5 &lt;/\u540d\u5b57&gt; \u7ed3\u675f. \u5c5e\u6027\u5219\u5728\u8282\u70b9\u540d\u79f0\u4e4b\u540e\u4ee5\u7a7a\u683c\u5206\u9694\u6392\u5217: &lt;\u540d\u5b57 \u5c5e\u60271=\"\u503c1\" \u5c5e\u60272=\"\u503c2\"&gt;, \u5c5e\u6027\u7684\u503c\u9700\u8981\u7531 <code>\"</code> \u5305\u88f9. \u5bf9\u4e8e\u4e00\u4e9b\u6ca1\u6709\u5185\u90e8\u5185\u5bb9\u7684\u8282\u70b9, \u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u81ea\u7ed3\u675f\u8bed\u6cd5: <pre><code>&lt;columns&gt;\n    &lt;column id=\"xxx\"/&gt;\n    &lt;column qwq=\"6\" awa=\"4\"/&gt;\n    &lt;column/&gt;\n    &lt;column/&gt;\n    &lt;column/&gt;\n&lt;/columns&gt;\n</code></pre></p> <p>XML \u5141\u8bb8\u4ee5\u4efb\u610f\u6df1\u5ea6\u6765\u5d4c\u5957, \u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u6765\u7ec4\u88c5\u4e00\u4e2a\u5f88\u590d\u6742\u7684 XML:</p> <pre><code>&lt;books&gt;\n    &lt;book id=\"123\"&gt;\n        &lt;bookmarks page=\"1\"&gt;114514&lt;/bookmarks&gt;\n        &lt;bookmarks page=\"2\"&gt;2333&lt;/bookmarks&gt;\n        &lt;bookmarks page=\"123\"&gt;838&lt;/bookmarks&gt;\n    &lt;/book&gt;\n    &lt;book id=\"456\"&gt;\n        &lt;bookmarks page=\"1\"&gt;\n            &lt;picture src=\"http://example.com\"&gt;\n                this is alt\n            &lt;/picture&gt;\n            &lt;text content=\"text here!\"/&gt;\n        &lt;/bookmarks&gt;\n        &lt;bookmarks page=\"2\"&gt;2333&lt;/bookmarks&gt;\n    &lt;/book&gt;\n&lt;/books&gt;\n</code></pre>"},{"location":"trans/adv_hooks/","title":"IL \u94a9\u5b50\u4e0e\u968f\u610f\u94a9\u53d6","text":""},{"location":"trans/adv_hooks/#il_1","title":"IL \u94a9\u5b50","text":""},{"location":"trans/adv_hooks/#il_2","title":"\u63d2\u5165 IL","text":"<p>\u73b0\u5728, \u4f60\u5df2\u7ecf\u4e86\u89e3\u4e86\u57fa\u672c\u7684 IL \u77e5\u8bc6, \u7a0d\u5fae\u4f1a\u4f7f\u7528 <code>System.Reflection.Emit</code> \u5e93\u4e86, \u90a3\u4e48\u6211\u4eec\u5c31\u53ef\u4ee5\u5f00\u59cb\u4f7f\u7528 IL \u94a9\u5b50\u4e86. IL \u94a9\u5b50\u5141\u8bb8\u4f60\u4fee\u6539\u851a\u84dd\u7684\u4ee3\u7801, \u8fd9\u662f\u4e00\u4e2a\u5f88\u5f3a\u5927\u7684\u529f\u80fd, \u90a3\u4e48\u81ea\u7136\u800c\u7136, \u5b83\u7684\u4f7f\u7528\u4e5f\u4f1a\u53d8\u5f97\u66f4\u52a0\u590d\u6742.  </p> <p>IL \u94a9\u5b50\u4e0e On \u94a9\u5b50\u7684\u4e8b\u4ef6\u8ba2\u9605\u65b9\u5f0f\u5f88\u76f8\u50cf, \u53ea\u4e0d\u8fc7\u662f\u6362\u6210\u4e86 IL \u547d\u540d\u7a7a\u95f4, \u4e0d\u8fc7\u8981\u6ce8\u610f\u7684\u662f, \u65b9\u6cd5\u7684\u53c2\u6570\u4e0d\u518d\u662f\u539f\u51fd\u6570\u59d4\u6258\u52a0\u4e0a\u5176\u5bf9\u5e94\u53c2\u6570\u4e86, \u800c\u662f\u4e00\u4e2a <code>ILContext</code> \u7c7b\u578b\u7684\u503c, \u540c\u65f6, \u65b9\u6cd5\u4e5f\u4e0d\u662f\u6bcf\u6b21\u8c03\u7528\u88ab\u94a9\u65b9\u6cd5\u65f6\u8c03\u7528, \u800c\u662f\u4ec5\u5728\u6e38\u620f\u542f\u52a8\u65f6\u8c03\u7528. \u4f8b\u5982, \u94a9\u53d6\u73a9\u5bb6\u7684 <code>SuperWallJump</code> \u65b9\u6cd5(\u5728\u73a9\u5bb6\u505a\u51fa\u4e86\u4e00\u4e2a\u8e6d\u5899\u65f6\u8c03\u7528):</p> <pre><code>public override void Load()\n{\n    IL.Celeste.Player.SuperWallJump += Player_SuperWallJump;\n}\n\nprivate void Player_SuperWallJump(ILContext il)\n{\n\n}\n\npublic override void Unload()\n{\n    IL.Celeste.Player.SuperWallJump -= Player_SuperWallJump;\n}\n</code></pre> <p>\u73b0\u5728, \u6211\u4eec\u83b7\u53d6\u5230\u4e86\u4e00\u4e2a <code>ILContext</code>, \u5b83\u8868\u793a\u8fd9\u4e2a\u65b9\u6cd5\u7684 <code>IL</code> \u4e0a\u4e0b\u6587, \u4e0d\u8fc7\u5728\u8fd9\u91cc\u4f60\u4e0d\u9700\u8981\u77e5\u9053\u8fd9\u662f\u4ec0\u4e48, \u6211\u4eec\u901a\u5e38\u8981\u7684\u53ea\u662f\u4f7f\u7528\u5176\u521b\u5efa\u4e00\u4e2a <code>ILCursor</code>:</p> <pre><code>ILCursor cur = new(il);\n</code></pre> <p>\u987e\u540d\u601d\u4e49, \u8fd9\u662f\u4e00\u4e2a \"IL \u6307\u9488\", \u5b83 \"\u6307\u5411\" \u8fd9\u4e2a\u65b9\u6cd5\u7684 IL \u4ee3\u7801\u7684\u67d0\u4e00\u884c, \u5b83\u62e5\u6709\u5f88\u591a\u65b9\u6cd5\u4ee5\u5141\u8bb8\u6211\u4eec\u5728\u5b83\u6307\u5411\u7684\u4f4d\u7f6e\u4e0b\u6dfb\u52a0, \u4fee\u6539, \u5220\u9664 IL, \u81ea\u7136, \u5b83\u4e5f\u5e26\u6709\u5f88\u591a\u65b9\u6cd5\u6765\u79fb\u52a8\u5b83\u7684\u6307\u5411, \u6700\u5e38\u7528\u7684\u65b9\u6cd5\u4e4b\u4e00\u662f <code>TryGotoNext</code>, \u5b83\u7684\u53c2\u6570\u5217\u8868\u5305\u542b\u4e00\u7cfb\u5217\u7684 <code>predicates</code>(\u8fd9\u8bcd\u4f3c\u4e4e\u6ca1\u4e2a\u7edf\u4e00\u7684\u7ffb\u8bd1, \u4e0d\u8fc7\u7406\u89e3\u5b83\u5f88\u7b80\u5355).  </p> <p>\u73b0\u5728, \u5047\u8bbe\u6211\u4eec\u7684\u76ee\u7684\u662f\u4fee\u6539\u73a9\u5bb6\u8e6d\u5899\u8df3\u65f6\u7684\u7ad6\u76f4\u901f\u5ea6\u4e3a 2 \u500d, \u90a3\u4e48\u6211\u4eec\u627e\u5230 <code>SuperWallJump</code> \u65b9\u6cd5, \u6ce8\u610f\u5230\u7ad6\u76f4\u901f\u5ea6\u662f\u5728\u8fd9\u91cc\u8bbe\u7f6e\u7684:</p> Celeste.Player.SuperWallJump()<pre><code>...\nthis.wallSlideTimer = 1.2f;\nthis.wallBoostTimer = 0f;\nthis.Speed.X = 170f * (float)dir;\nthis.Speed.Y = -160f;\nthis.Speed += this.LiftBoost;\nthis.varJumpSpeed = this.Speed.Y;\nthis.launched = true;\n...\n</code></pre> <p>\u90a3\u4e48\u6211\u4eec\u67e5\u770b\u5b83\u9644\u8fd1 IL, \u7136\u540e\u67e5\u627e\u8fd9\u90e8\u5206 IL \u7684\u4e00\u4e2a\u7279\u5f81\u4ee5\u65b9\u4fbf\u6211\u4eec\u8fdb\u884c\u5b9a\u4f4d:</p> Celeste.Player.SuperWallJump()<pre><code>IL_0075: ldarg.1\nIL_0076: conv.r4\nIL_0077: mul\nIL_0078: stfld     float32 [FNA]Microsoft.Xna.Framework.Vector2::X\nIL_007D: ldarg.0\nIL_007E: ldflda    valuetype [FNA]Microsoft.Xna.Framework.Vector2 Celeste.Player::Speed\nIL_0083: ldc.r4    -160\nIL_0088: stfld     float32 [FNA]Microsoft.Xna.Framework.Vector2::Y\nIL_008D: ldarg.0\nIL_008E: ldarg.0\n</code></pre> <p>\u6211\u4eec\u53d1\u73b0\u8fd9\u91cc\u6709\u4e00\u4e2a\u5f88\u7279\u6b8a\u7684 -160 \u6d6e\u70b9\u6570\u7684\u538b\u5165, \u5e76\u4e14\u7d27\u968f\u5176\u540e\u7684\u662f\u4e00\u4e2a <code>Vector2::Y</code> \u5b57\u6bb5\u7684\u5b58\u5165, \u90a3\u4e48\u8fd9\u6837\u6211\u4eec\u5c31\u53ef\u4ee5\u4f7f\u7528\u8fd9\u4e2a\u7279\u5f81\u5c06 IL \u6307\u9488\u6307\u5411\u8fd9\u91cc:</p> <pre><code>if (cur.TryGotoNext(ins =&gt; ins.MatchLdcR4(-160f), ins =&gt; ins.MatchStfld&lt;Vector2&gt;(\"Y\")))\n{\n    // \u6307\u9488\u4f4d\u4e8e ldc.r4 \u6307\u4ee4\u4e86\n}\n</code></pre> <p>\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u6211\u4eec\u8981\u6c42 IL \u6307\u9488\u5411\u4e0b\u67e5\u627e, \u76f4\u5230\u627e\u5230\u4e00\u4e2a\u4f4d\u7f6e\u4f7f\u5f97 IL \u662f <code>ldc.r4 -160f</code> \u5e76\u4e14\u4e0b\u4e00\u884c\u662f\u50a8\u5b58\u5230 <code>Vector2</code> <code>Y</code> \u5b57\u6bb5. \u5982\u679c\u6ca1\u627e\u5230\u5219\u8fd4\u56de <code>false</code>. \u73b0\u5728, \u6211\u4eec\u7684\u6307\u9488\u5df2\u7ecf\u6307\u5411 <code>ldc.r4</code> \u4e86, \u4f46\u662f\u6b64\u65f6\u5728\u8fd9\u4e2a\u4f4d\u7f6e\u52a0\u5165 IL \u4ee3\u7801\u5b9e\u9645\u4e0a\u4f1a\u52a0\u5230\u8fd9\u4e00\u884c\u4e0a\u9762\u53bb, \u6240\u6709\u6211\u4eec\u5f97\u5148\u8ba9\u5b83\u518d\u5411\u4e0b\u79fb\u52a8\u4e00\u884c, \u7136\u540e\u4f7f\u7528\u6211\u4eec\u7684 IL \u77e5\u8bc6, \u5c06\u5b83\u4e58\u4ee5\u4e2a 2: <pre><code>if (cur.TryGotoNext(ins =&gt; ins.MatchLdcR4(-160f), ins =&gt; ins.MatchStfld&lt;Vector2&gt;(\"Y\")))\n{\n    cur.Index++;\n    cur.Emit(OpCodes.Ldc_R4, 2.0f);\n    cur.Emit(OpCodes.Mul);\n}\n</code></pre></p> <p>Warning</p> <p>\u6ce8\u610f OpCodes \u4f4d\u4e8e <code>Mono.Cecil.Cil</code> \u800c\u4e0d\u662f <code>System.Reflection.Emit</code> \u547d\u540d\u7a7a\u95f4\u4e0b.</p> <p>\u73b0\u5728\u7f16\u8bd1\u8fd0\u884c, \u4f60\u5e94\u8be5\u80fd\u89c2\u5bdf\u5230\u8e6d\u5899\u8df3\u7684\u7ad6\u76f4\u901f\u5ea6\u53d8\u7684\u5f88\u5927!  </p> <p>\u6ce8\u610f\u7684\u662f, IL \u94a9\u5b50\u5f88\u5f3a\u5927, \u4f46\u4f7f\u7528\u5b83\u7684\u98ce\u9669\u4e5f\u5f88\u5927, \u7a0d\u6709\u4e0d\u614e\u5c31\u4f1a\u4f7f\u6574\u4e2a\u6e38\u620f\u76f4\u63a5\u5d29\u6e83. \u4f8b\u5982, \u5728\u4e0a\u9762\u7684\u4ee3\u7801\u4e2d, \u5982\u679c\u4f60\u5fd8\u8bb0\u4e86\u5411\u4e0b\u79fb\u52a8\u4e00\u884c, \u6211\u4eec\u5e0c\u671b\u63d2\u5165\u7684 IL \u4ee3\u7801\u5c31\u4f1a\u9519\u8bef\u5730\u88ab\u63d2\u5165\u81f3 ldc.r4 \u7684\u4e0a\u4e00\u884c, \u901a\u5e38\u8fd9\u4f1a\u5bfc\u81f4\u975e\u6cd5\u7684 IL \u4ee5\u5bfc\u81f4 JIT \u7f16\u8bd1\u5f02\u5e38, \u6216\u8005\u5176\u4ed6\u4e0d\u53ef\u9884\u77e5\u7684\u884c\u4e3a, \u4e0d\u8fc7\u5728\u8fd9\u91cc\u5b83\u4f1a\u5bfc\u81f4\u4e00\u4e2a\u66f4\u52a0\u4e25\u91cd\u7684\u95ee\u9898, \u5b83\u4f1a\u76f4\u63a5\u5d29\u6e83\u6389\u4f60\u7684\u6e38\u620f\u5e76\u4e14\u4e0d\u52a0\u4efb\u4f55 log.txt \u7684\u8f93\u51fa\u548c error_log.txt \u7684\u5f39\u51fa! \u4f60\u53ef\u4ee5\u81ea\u5df1\u5c1d\u8bd5\u4e00\u4e0b\u6765\u611f\u53d7\u5982\u679c IL \u94a9\u5b50\u4f7f\u7528\u5931\u8bef\u7684\u60c5\u51b5.  </p> <p>\u901a\u5e38\u66f4\u5e38\u89c1\u5730, \u6211\u4eec\u5e0c\u671b\u8fd9\u4e2a\u7cfb\u6570\u662f\u53ef\u4ee5\u968f\u65f6\u4fee\u6539\u7684, \u76f8\u4fe1\u4f60\u5f88\u5feb\u5c31\u80fd\u60f3\u5230\u6bd4\u5982\u50a8\u5b58\u5230\u5b57\u6bb5\u91cc, \u7136\u540e\u63d2\u5165\u4e00\u4e9b\u590d\u6742\u7684\u5b57\u6bb5\u8bfb\u53d6\u4ee3\u7801\u6216\u8005\u590d\u6742\u7684\u65b9\u6cd5\u8c03\u7528\u4ee3\u7801, \u4e0d\u8fc7 MonoMod \u4e3a\u6211\u4eec\u63d0\u4f9b\u4e86\u4e00\u4e2a\u66f4\u7b80\u5355\u7684\u65b9\u6cd5: <code>EmitDelegate</code>, \u5b83\u80fd\u4e00\u952e\u751f\u6210\u8fd9\u4e9b\u590d\u6742\u7684\u65b9\u6cd5\u83b7\u53d6\u548c\u8c03\u7528.  </p> <p>\u4f8b\u5982\u4f60\u6709\u4e00\u4e2a\u9759\u6001\u65b9\u6cd5 <code>GetFactorOfWallJumpYSpeed</code>, \u5b83\u4f1a\u6839\u636e\u4e00\u4e9b\u60c5\u51b5\u8fd4\u56de\u4e0d\u540c\u7684\u503c, \u4f8b\u5982\u5728\u8fd9\u91cc\u68c0\u6d4b\u6309\u8df3\u65f6\u662f\u5426\u540c\u65f6\u6309\u4e0b\u6293\u952e, \u662f\u5219\u7ffb\u500d\u7ad6\u76f4\u901f\u5ea6, \u5426\u5219\u4e0d\u53d8:</p> <pre><code>public static float GetFactorOfWallJumpYSpeed()\n{\n    if (Input.Grab.Pressed)\n        return 2.0f;\n    else\n        return 1.0f;\n}\n</code></pre> <p>\u4e0a\u9762\u5bf9\u5e94\u7684\u4ee3\u7801:</p> <pre><code>if (cur.TryGotoNext(ins =&gt; ins.MatchLdcR4(-160f), ins =&gt; ins.MatchStfld&lt;Vector2&gt;(\"Y\")))\n{\n    cur.Index++;\n    // as easy as pi!\n    cur.EmitDelegate(GetFactorOfWallJumpYSpeed);\n    cur.Emit(OpCodes.Mul);\n}\n</code></pre>"},{"location":"trans/adv_hooks/#il_3","title":"\u79fb\u9664 IL","text":"<p>\u901a\u5e38\u9664\u4e86\u63d2\u5165, \u6211\u4eec\u8fd8\u9700\u8981\u79fb\u9664 IL, \u5bf9\u4e8e\u4fee\u6539 IL \u7684\u60c5\u51b5\u6211\u4eec\u53ea\u9700\u8981\u5148\u79fb\u9664\u518d\u63d2\u5165\u5373\u53ef. \u8981\u79fb\u9664\u4e00\u884c IL, \u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 <code>Remove</code> \u65b9\u6cd5, <code>Remove</code> \u65b9\u6cd5\u4f1a\u79fb\u9664\u6307\u9488\u6240\u6307\u7684 IL \u884c, \u4f8b\u5982\u6211\u4eec\u4f9d\u7136\u4fee\u6539\u73a9\u5bb6\u7684\u8e6d\u5899\u8df3\u7ad6\u76f4\u901f\u5ea6, \u4f46\u662f\u5728\u8fd9\u91cc\u6211\u4eec\u76f4\u63a5\u8986\u76d6\u6211\u4eec\u7684\u65b0\u503c:</p> <pre><code>if (cur.TryGotoNext(ins =&gt; ins.MatchLdcR4(-160f), ins =&gt; ins.MatchStfld&lt;Vector2&gt;(\"Y\")))\n{\n    // \u6ce8\u610f\u6ca1\u6709cur.Index++;\u4e86, \u8bb0\u4f4f Emit \u65f6\u65b0\u4ee3\u7801\u88ab\u6dfb\u52a0\u5230\u4e0a\u4e00\u884c, \u800c Remove \u65f6\u5219\u79fb\u9664\u5f53\u524d\u884c\n    cur.Remove();\n    // \u5f53\u524d\u4e00\u884c\u7684 IL \u5df2\u7ecf\u88ab\u79fb\u9664\u4e86, \u73b0\u5728\u6307\u9488\u5b9e\u9645\u4e0a\u6307\u5411\u4e4b\u524d\u7684\u4e0b\u4e00\u884c, \u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u76f4\u63a5 Emit\n    cur.Emit(OpCodes.Ldc_R4, -300.0f);\n}\n</code></pre> <p>Note</p> <p>\u5728\u63d2\u5165 IL, \u4fee\u6539 IL, \u66f4\u6539 IL \u6307\u9488\u6307\u5411\u65f6\u52a1\u5fc5\u6e05\u695a\u63d2\u5165\u4f4d\u7f6e, \u5220\u9664\u76ee\u6807, \u4ee5\u53ca\u64cd\u4f5c\u5b8c\u6210\u540e\u7684\u6307\u9488\u6307\u5411.</p>"},{"location":"trans/adv_hooks/#_1","title":"\u4efb\u610f\u94a9\u53d6","text":"<p>\u76f8\u4fe1\u4f60\u5df2\u7ecf\u53d1\u73b0\u4e86, \u6709\u4e9b\u65b9\u6cd5\u6bd4\u5982\u53eb\u505a <code>orig_xxx</code> \u7684\u65b9\u6cd5, \u4ee5\u53ca\u5c5e\u6027\u7684 getter \u548c setter \u4f60\u90fd\u65e0\u6cd5\u5728 On. \u548c IL. \u8fd9\u4e24\u4e2a\u547d\u540d\u7a7a\u95f4\u4e2d\u627e\u5230, \u540c\u65f6, \u94a9\u53d6\u522b\u7684 helper \u7684\u65b9\u6cd5\u4f3c\u4e4e\u4e5f\u65e0\u6cd5\u5b8c\u6210.  </p> <p>\u8fd9\u91cc\u6211\u4eec\u5f15\u5165\u4e24\u4e2a\u65b0\u7c7b: <code>Hook</code> \u4e0e <code>ILHook</code>, \u524d\u8005\u8868\u793a\u4e00\u4e2a On \u94a9\u5b50, \u540e\u8005\u8868\u793a\u4e00\u4e2a IL \u94a9\u5b50.</p> <p>Info</p> <p><code>Hook</code> \u4e0e <code>ILHook</code> \u4f4d\u4e8e <code>MonoMod.RuntimeDetour</code> \u7a0b\u5e8f\u96c6\u4e2d, \u5728\u65e7\u6a21\u677f\u91cc\u5b83\u6ca1\u6709\u88ab\u9ed8\u8ba4\u5f15\u7528\u8fdb\u6765, \u8fd9\u662f\u4e00\u4e2a\u6211\u4e2a\u4eba\u7684\u5931\u8bef, \u5982\u679c\u4f60\u786e\u5b9e\u65e0\u6cd5\u5f15\u7528\u8fd9\u4e24\u4e2a\u7c7b\u7684\u8bdd\u4f60\u53ef\u4ee5\u5728 <code>CelesteMod.props</code> \u91cc\u7684\u6700\u5e95\u4e0b\u7684\u90a3\u4e2a <code>ItemGroup</code> \u4e2d\u52a0\u5165\u8fd9\u4e00\u6761: <pre><code>&lt;Reference Include=\"MonoMod.RuntimeDetour\"&gt;\n    &lt;HintPath&gt;$(CelesteAssemblyPath)/MonoMod.RuntimeDetour.dll&lt;/HintPath&gt;\n    &lt;Private&gt;False&lt;/Private&gt;\n&lt;/Reference&gt;\n</code></pre></p> <p><code>Hook</code> \u7684\u6784\u9020\u51fd\u6570\u62e5\u6709\u975e\u5e38\u591a\u91cd\u8f7d, \u5728\u8fd9\u91cc\u6211\u4eec\u53ea\u9700\u8981\u90a3\u4e2a <code>(MethodBase method, Delegate to)</code> \u7684\u91cd\u8f7d, \u5b83\u8868\u793a\u6211\u4eec\u5e0c\u671b\u94a9\u53d6\u7b2c\u4e00\u4e2a\u53c2\u6570\u6307\u5b9a\u7684\u65b9\u6cd5, \u94a9\u5b50\u65b9\u6cd5\u662f\u7b2c\u4e8c\u4e2a\u53c2\u6570\u6307\u5b9a\u7684\u59d4\u6258.  </p> <p>\u4f8b\u5982, \u6211\u4eec\u5e0c\u671b\u94a9\u53d6 <code>Player.Inventory</code> \u8fd9\u4e2a\u5c5e\u6027\u7684 <code>get</code> \u65b9\u6cd5, \u4f7f\u5176\u603b\u662f\u8fd4\u56de <code>PlayerInventory.TheSummit</code>, \u4e5f\u5c31\u662f\u603b\u662f\u5177\u6709\u80cc\u5305, \u53cc\u51b2\u7b49:</p> <pre><code>// \u50a8\u5b58\u6211\u4eec\u7684 hook, \u4ee5\u4fbf\u6211\u4eec\u5728 Unload \u4e2d\u91ca\u653e\u5b83\nprivate Hook playerInventory_get_hook;\n\npublic override void Load()\n{\n    // \u5148\u4f7f\u7528\u53cd\u5c04\u627e\u5230 Player.Inventory \u5c5e\u6027\u7684 getter\n    var playerInventory_get = typeof(Player).GetProperty(\"Inventory\").GetGetMethod();\n    // \u4f7f\u7528\u5176\u521b\u5efa\u4e00\u4e2a On \u94a9\u5b50\n    playerInventory_get_hook = new(playerInventory_get, PlayerInventoryHook);\n}\n\n// \u6211\u4eec\u9700\u8981\u624b\u52a8\u58f0\u660e orig \u65b9\u6cd5\u7684\u59d4\u6258, \u56e0\u4e3a\u8fd9\u91cc\u4e0d\u518d\u662f\u65b9\u4fbf\u7684\u4e8b\u4ef6\u8ba2\u9605\u4e86\npublic delegate PlayerInventory PlayerInventory_get_orig(Player self);\npublic static PlayerInventory PlayerInventoryHook(PlayerInventory_get_orig orig, Player self)\n{\n    // \u76f4\u63a5\u5ffd\u7565 orig \u65b9\u6cd5\u7684\u8c03\u7528, \u5f3a\u5236\u8fd4\u56de 7a/b/c \u7684 Inventory\n    return PlayerInventory.TheSummit;\n}\n\npublic override void Unload()\n{\n    // \u8bb0\u5f97\u9500\u6bc1\u94a9\u5b50\n    playerInventory_get_hook.Dispose();\n}\n</code></pre> <p>\u56e0\u4e3a\u4e0d\u518d\u662f\u4e4b\u524d\u65b9\u4fbf\u7684\u4e8b\u4ef6\u8ba2\u9605, \u6240\u4ee5\u94a9\u5b50\u7684 orig \u53c2\u6570\u7684\u59d4\u6258\u539f\u578b\u4f60\u5fc5\u987b\u5f97\u81ea\u5df1\u58f0\u660e, \u6ce8\u610f\u94a9\u5b50\u65b9\u6cd5\u548c\u94a9\u5b50 orig \u53c2\u6570\u7684\u53c2\u6570\u5217\u8868\u4e00\u5b9a\u8981\u5c0f\u5fc3\u51c6\u786e\u7684\u586b\u5199, \u5426\u5219\u4f1a\u76f4\u63a5\u9020\u6210\u6e38\u620f\u5d29\u6e83. \u4e0a\u8ff0\u4ee3\u7801\u7684\u6548\u679c\u5e94\u8be5\u662f\u4f60\u65e0\u8bba\u5982\u4f55\u90fd\u4f1a\u62e5\u6709 7a/b/c \u7684 Inventory, \u4e5f\u5927\u6982\u5373\u53cc\u51b2, \u5e26\u80cc\u5305.  </p> <p>\u73b0\u5728, \u62e5\u6709\u4e86\u94a9\u5b50\u51fd\u6570, \u4f60\u53ef\u4ee5\u505a\u4efb\u4f55\u4f60\u4e4b\u524d\u4f7f\u7528\u8ba2\u9605\u4e8b\u4ef6\u6765\u521b\u5efa\u94a9\u5b50\u4e00\u6837\u7684\u4e8b. \u987a\u4fbf, \u4f7f\u7528\u8fd9\u79cd\u65b9\u6cd5\u4e5f\u5141\u8bb8\u4f60\u94a9\u53d6\u522b\u7684 helper \u7684\u65b9\u6cd5, \u751a\u81f3\u662f\u94a9\u53d6\u522b\u7684 helper \u7684\u94a9\u5b50\u65b9\u6cd5. \u4e0d\u8fc7\u5728\u6b64\u4e4b\u524d\u4f60\u9700\u8981\u4e3a\u4f60\u7684 mod \u58f0\u660e\u4f9d\u8d56\u6216\u8005\u53ef\u9009\u4f9d\u8d56, \u58f0\u660e\u53ef\u9009\u4f9d\u8d56\u540e\u53c8\u9700\u8981\u68c0\u6d4b\u5bf9\u5e94 mod \u662f\u5426\u52a0\u8f7d\u7b49\u7b49, \u8fd9\u90e8\u5206\u5185\u5bb9\u6211\u4eec\u4e4b\u540e\u518d\u8bf4.  </p> <p>\u540c\u6837\u5730, IL \u94a9\u5b50\u7684\u521b\u5efa\u4e5f\u4e0e On \u94a9\u5b50\u76f8\u540c:</p> <pre><code>private ILHook playerInventory_get_ilhook;\n\npublic override void Load()\n{\n    var playerInventory_get = typeof(Player).GetProperty(\"Inventory\").GetGetMethod();\n    playerInventory_get_ilhook = new(playerInventory_get, PlayerInventoryILHook);\n}\n\npublic static void PlayerInventoryILHook(ILContext context)\n{\n    // \u50cf\u4e4b\u524d\u4e00\u6837\u505a\u4f60\u5728 IL \u94a9\u5b50\u4e2d\u505a\u7684\u4e8b...\n}\n\npublic override void Unload()\n{\n    playerInventory_get_ilhook.Dispose();\n}\n</code></pre> <p>\u4e0d\u8fc7\u4e0d\u518d\u9700\u8981\u624b\u52a8\u58f0\u660e orig \u59d4\u6258, \u56e0\u4e3a IL \u94a9\u5b50\u7684\u94a9\u5b50\u65b9\u6cd5\u53c2\u6570\u5217\u8868\u662f\u56fa\u5b9a\u7684.</p> <p>Note</p> <p>\u5173\u4e8e\u534f\u7a0b\u51fd\u6570\u7684\u94a9\u53d6\u4e0e\u4e0a\u8ff0\u6b65\u9aa4\u622a\u7136\u4e0d\u540c, \u8fd9\u4e00\u70b9\u6211\u4eec\u4f1a\u5728\u4e0b\u4e00\u8282\u63a2\u8ba8.</p>"},{"location":"trans/common1/","title":"Alarm, Tween, Coroutine","text":""},{"location":"trans/common1/#tween","title":"Tween","text":"<p>Tween \u662f\u4e00\u4e2a\u5728 Monocle \u4e2d\u7528\u6765\u5b9e\u73b0\u7f13\u52a8\u7684 <code>Component</code>, \u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u8fdb\u884c\u6240\u6709 easings.net \u4e0a\u7684\u7f13\u52a8, \u5b83\u7684\u4f7f\u7528\u65b9\u6cd5\u5f88\u7b80\u5355: \u4f7f\u7528 Tween<pre><code>// \u9996\u5148\u4f7f\u7528\u9759\u6001\u65b9\u6cd5 Tween.Create \u6765\u521b\u5efa\nTween tw = Tween.Create(Tween.TweenMode.Oneshot, Ease.BackIn, 1f, false);\n</code></pre></p> <p>\u8fd9\u91cc\u53c2\u6570\u53ef\u80fd\u76f8\u5bf9\u8f83\u591a:</p> <ul> <li>\u7b2c\u4e00\u4e2a\u53c2\u6570 <code>mode</code>: \u5b83\u8868\u793a\u7f13\u52a8\u7684\u7c7b\u578b, \u53ef\u7528\u7684\u6709:<ul> <li><code>Persist</code>: \u7f13\u52a8\u7ed3\u675f\u540e\u8be5\u7ec4\u4ef6\u4f1a\u5931\u6d3b, \u76f4\u5230\u518d\u6b21\u88ab\u8c03\u7528 <code>Start</code></li> <li><code>Oneshot</code>: \u7f13\u52a8\u7ed3\u675f\u540e\u8be5\u7ec4\u4ef6\u4f1a\u79fb\u9664\u81ea\u8eab</li> <li><code>Looping</code>: \u7f13\u52a8\u7ed3\u675f\u4e00\u6b21\u540e\u4f1a\u7acb\u523b\u518d\u6b21\u5f00\u59cb\u540c\u4e00\u4e2a\u7f13\u52a8, \u5e76\u5faa\u73af</li> <li><code>YoyoOneshot</code>: \u7f13\u52a8\u7ed3\u675f\u540e\u4f1a\u7acb\u523b\u8fdb\u884c\u4e00\u6b21\u53cd\u5411\u7684\u7f13\u52a8, \u7ed3\u675f\u540e\u79fb\u9664\u81ea\u8eab</li> <li><code>YoyoLooping</code>: \u540c <code>YoyoOneshot</code>, \u4f46\u662f\u4f1a\u5faa\u73af\u800c\u4e0d\u662f\u79fb\u9664\u81ea\u8eab</li> </ul> </li> <li>\u7b2c\u4e8c\u4e2a\u53c2\u6570 <code>easer</code>: \u5b83\u8868\u793a\u8be5\u7f13\u52a8\u7684 <code>Easer</code>, \u901a\u5e38\u6211\u4eec\u4f7f\u7528 <code>Ease</code> \u7c7b\u4e2d\u7684\u5df2\u6709\u9759\u6001\u5b57\u6bb5\u4e2d\u63d0\u4f9b\u7684\u5c31\u884c\u4e86,  \u540c\u6837\u5730\u4f60\u53ef\u4ee5\u5728 easings.net \u611f\u53d7\u5e76\u68c0\u7d22\u4f60\u6240\u9700\u8981\u7684\u7f13\u52a8\u7c7b\u578b.</li> <li>\u7b2c\u4e09\u4e2a\u53c2\u6570 <code>duration</code>: \u8868\u793a\u8be5\u7f13\u52a8\u8fdb\u884c\u7684\u65f6\u95f4(\u5355\u4f4d\u79d2), \u5bf9\u4e8e\u7279\u6b8a\u7684\u7f13\u52a8\u7c7b\u578b\u6765\u8bf4\u5b83\u6307\u4e00\u6b21\u6b63\u5411\u7f13\u52a8\u6216\u8005\u4e00\u6b21\u53cd\u5411\u7f13\u52a8\u6240\u9700\u65f6\u95f4.</li> <li>\u7b2c\u56db\u4e2a\u53c2\u6570 <code>start</code>: \u662f\u5426\u7acb\u5373\u5f00\u59cb\u8fd9\u4e2a <code>Tween</code>, \u5426\u5219\u6211\u4eec\u5f97\u9700\u8981\u624b\u52a8\u8c03\u7528 <code>Start</code> \u65b9\u6cd5</li> </ul> <p>\u5728\u521b\u5efa\u5b8c\u6211\u4eec\u7684 <code>tw</code> \u5b9e\u4f8b\u540e, \u6211\u4eec\u5148\u5236\u70b9\u5c0f\u76ee\u6807:</p> <ul> <li>\u5728\u7f13\u52a8\u5f00\u59cb\u65f6\u8f93\u51fa \"Tween start!\"</li> <li>\u5728\u7f13\u52a8\u8fc7\u7a0b\u65f6\u8f93\u51fa \"Tweening... Eased: &lt;\u6b64\u65f6\u7684\u7f13\u52a8\u503c&gt;, Percent: &lt;\u7f13\u52a8\u5df2\u8fdb\u884c\u7684\u65f6\u95f4\u5360\u6bd4&gt;\"</li> <li>\u5728\u7f13\u52a8\u7ed3\u675f\u540e\u8f93\u51fa \"Tween complete!\"</li> </ul> <p>\u5bf9\u4e8e\u5f00\u59cb\u548c\u7ed3\u675f\u5f88\u7b80\u5355, \u6211\u4eec\u53ea\u9700\u8981\u8d4b\u503c\u4e00\u4e9b\u5b57\u6bb5:</p> \u8d4b\u503c Tween \u7684\u4e00\u4e9b\u5b57\u6bb5<pre><code>tw.OnStart = t =&gt; Logger.Log(LogLevel.Info, \"test\", \"Tween start!\");\ntw.OnComplete = t =&gt; Logger.Log(LogLevel.Info, \"test\", \"Tween complete!\");\n</code></pre> <p>\u5728\u8fd9\u91cc\u6211\u4eec\u4f7f\u7528 lambda \u8868\u8fbe\u5f0f\u4e3a\u5176\u8d4b\u503c, \u5176\u4e2d\u8be5 lambda \u88ab\u4f20\u5165\u7684\u53c2\u6570\u5c31\u662f\u8fd9\u4e2a <code>Tween</code> \u5b9e\u4f8b, \u8fd9\u53ef\u4ee5\u5e2e\u52a9\u6211\u4eec\u907f\u514d lambda \u6355\u83b7\u4ee5\u53ca\u590d\u7528\u6211\u4eec\u7684 <code>Tween</code> \u5904\u7406\u51fd\u6570.</p> <p>\u5bf9\u4e8e\u7f13\u52a8\u8fc7\u7a0b, \u6211\u4eec\u9996\u5148\u4ecb\u7ecd\u4e24\u4e2a\u5c5e\u6027:</p> <ul> <li><code>Eased</code>: \u8868\u793a\u8be5\u7f13\u52a8\u5f53\u524d\u7684 \"\u7f13\u52a8\u503c\"</li> <li><code>Percent</code>: \u8868\u793a\u8be5\u7f13\u52a8\u5df2\u8fdb\u884c\u65f6\u95f4\u5360\u6bd4, \u5373 \u5df2\u8fdb\u884c\u65f6\u95f4/\u603b\u65f6\u95f4</li> </ul> <p>\u4e00\u4e2a\u66f4\u6e05\u695a\u7684\u4f8b\u5b50\u662f\u89c2\u5bdf easings.net \u7684\u56fe\u50cf, <code>Eased</code> \u5373\u7eb5\u5750\u6807\u503c, <code>Percent</code> \u5373\u6a2a\u5750\u6807\u503c.</p> <p>\u90a3\u4e48\u8fd9\u91cc\u5c31\u5f88\u7b80\u5355\u5b9e\u73b0\u4e86: <pre><code>tw.OnUpdate = t =&gt; Logger.Log(LogLevel.Info, \"test\", $\"Tweening... Eased: {t.Eased}, Percent: {t.Percent}\");\n</code></pre></p> <p>\u6700\u540e\u8bb0\u5f97 <code>Start</code> \u5b83\u5e76\u4e14\u8bb0\u5f97\u628a\u5b83\u6302\u8f7d\u5230\u5b9e\u4f53\u4e0a, \u56e0\u4e3a\u5b83\u7684\u66f4\u65b0\u662f\u4f9d\u8d56\u5b9e\u4f53\u7684:</p> \u5f00\u59cb\u5e76\u6302\u8f7d<pre><code>// \u5982\u679c\u4f60\u5bf9 `start` \u53c2\u6570\u4f20\u5165 `true` \u90a3\u4e48\u4f60\u53ef\u4ee5\u4e0d\u7528\u505a\u8fd9\u4e00\u6b65\ntw.Start();\n// \u8fd9\u91cc\u5047\u8bbe\u6211\u4eec\u7684\u6240\u6709\u4ee3\u7801\u90fd\u8fdb\u884c\u5728\u4e00\u4e2a\u5b9e\u4f53\u5185\u90e8\nthis.Add(tw);\n</code></pre> <p>\u6216\u8005, \u6211\u4eec\u4f7f\u7528 <code>Tween.Set</code> \u65b9\u6cd5, \u5b83\u662f\u4e00\u4e2a\u5de5\u5177\u65b9\u6cd5\u5141\u8bb8\u6211\u4eec\u7b80\u5316\u5bf9 Tween \u7684\u4f7f\u7528, \u4e0a\u9762\u7684\u4f8b\u5b50\u7528\u8fd9\u4e2a\u65b9\u6cd5\u53ef\u4ee5\u5199\u6210\u8fd9\u6837: <pre><code>Tween tw = Tween.Set(this, Tween.TweenMode.Oneshot, 1f, Ease.BackIn,\n    t =&gt; Logger.Log(LogLevel.Info, \"test\", $\"Tweening... Eased: {t.Eased}, Percent: {t.Percent}\"),\n    t =&gt; Logger.Log(LogLevel.Info, \"test\", \"Tween complete!\"));\n// OnStart \u8fd8\u5f97\u624b\u52a8\u8bbe\u7f6e\u5450\ntw.OnStart = t =&gt; Logger.Log(LogLevel.Info, \"test\", \"Tween start!\");\ntw.Start();\n</code></pre></p> <p>\u5b83\u4f1a\u81ea\u52a8\u5e2e\u6211\u4eec\u6302\u8f7d\u5230\u5b9e\u4f53\u4e0a, \u4e0d\u8fc7\u4f9d\u7136\u9700\u8981\u6211\u4eec\u624b\u52a8 <code>Start</code>, \u8fd9\u91cc\u65b9\u4fbf\u4e4b\u5904\u5c31\u5728\u4e8e\u4f60\u53ef\u4ee5\u76f4\u63a5\u628a\u4e00\u4e2a\u7b80\u5355\u7684\u51fd\u6570\u76f4\u63a5\u5728\u53c2\u6570\u4e2d\u4f20\u5165, \u800c\u4e0d\u662f <code>Create</code> \u540e\u518d\u8bbe\u7f6e\u5b57\u6bb5. \u4e0d\u8fc7\u8fd9\u91cc\u53c2\u6570\u5217\u8868\u4e2d\u5e76\u6ca1\u6709 <code>Start</code> \u76f8\u5173\u7684\u53c2\u6570, \u5982\u679c\u4f60\u8fd8\u9700\u8981\u8bbe\u7f6e <code>Start</code> \u7684\u56de\u8c03\u7684\u8bdd\u4f60\u53ef\u4ee5\u56de\u9000\u5230\u4e0a\u9762\u7684\u4f8b\u5b50\u4e2d\u7684\u65b9\u6cd5, \u5c31\u50cf\u4e0a\u9762\u7684\u4ee3\u7801\u4e00\u6837\u624b\u52a8\u8bbe\u7f6e <code>OnStart</code>.</p>"},{"location":"trans/common1/#alarm","title":"Alarm","text":"<p>\u987e\u540d\u601d\u4e49, \u5b83\u5c31\u662f\u4e2a'\u95f9\u949f', \u5b83\u5141\u8bb8\u4f60\u8bbe\u5b9a\u4e00\u4e2a\u65f6\u95f4\u5e76\u5728\u65f6\u95f4\u7ed3\u675f\u540e\u505a\u4e00\u4e9b\u4e8b\u60c5, \u5176\u4f7f\u7528\u8d77\u6765\u5f88\u7b80\u5355: <pre><code>Alarm alarm = Alarm.Create(Alarm.AlarmMode.Oneshot, OnAlarm, 2f, false);\nAdd(alarm);\nalarm.Start();\n\nstatic void OnAlarm()\n{\n    Logger.Log(LogLevel.Info, \"Test\", \"123\");\n}\n</code></pre></p> <ul> <li>\u7b2c\u4e00\u4e2a\u53c2\u6570 <code>AlarmMode</code> \u4e0e <code>Tween.TweenMode</code> \u7684\u57fa\u672c\u4e00\u81f4, \u8fd9\u91cc\u5c31\u4e0d\u8d58\u8ff0\u4e86</li> <li>\u7b2c\u4e8c\u4e2a\u53c2\u6570\u8868\u793a\u65f6\u95f4\u5230\u540e\u7684\u56de\u8c03\u51fd\u6570</li> <li>\u7b2c\u4e09\u4e2a\u53c2\u6570\u8868\u793a\u65f6\u95f4\u6709\u591a\u957f</li> <li>\u7b2c\u56db\u4e2a\u53c2\u6570\u4e5f\u4e0e tween \u7c7b\u4f3c, \u8868\u793a\u662f\u5426\u5e0c\u671b\u81ea\u52a8\u8c03\u7528 <code>Start</code> \u65b9\u6cd5</li> </ul> <p>\u9664\u4e86\u5728\u7b2c\u4e09\u4e2a\u53c2\u6570\u5904\u8bbe\u7f6e\u65f6\u95f4\u957f\u5ea6\u5916, <code>Start</code> \u65b9\u6cd5\u4e5f\u5141\u8bb8\u6211\u4eec\u4f20\u5165\u4e00\u4e2a\u65f6\u95f4\u957f\u5ea6, \u8fd9\u4f1a\u5728\u4f60\u9700\u8981\u4e00\u4e2a\u4e0d\u5b9a\u957f\u7684\u95f9\u949f\u7684\u65f6\u5019\u5f88\u6709\u7528. \u9664\u6b64\u4e4b\u5916, <code>Alarm</code> \u4e5f\u6709\u7c7b\u4f3c\u4e8e <code>Tween.Set</code> \u7684\u65b9\u6cd5\u76f4\u63a5\u4f5c\u7528\u4e0e <code>Entity</code> \u4e0a, \u53c2\u6570\u4e5f\u4e0e\u5176\u6784\u9020\u51fd\u6570\u76f8\u540c: <pre><code>// \u4e0d\u8fc7\u8fd9\u91cc AlarmMode \u53cd\u800c\u88ab matt \u653e\u5230\u6700\u540e\u53bb\u4e86\nAlarm.Set(this, 2f, OnAlarm, Alarm.AlarmMode.Oneshot).Start();\n</code></pre></p>"},{"location":"trans/common1/#coroutine","title":"Coroutine","text":"<p><code>Coroutine</code> \u5e38\u89c1\u7684\u4e2d\u6587\u7ffb\u8bd1\u53eb\u505a '\u534f\u7a0b', \u5b83\u662f\u4e00\u4e2a\u975e\u5e38\u5f3a\u5927\u7684\u4e1c\u897f, async/await \u5f02\u6b65\u5141\u8bb8\u6211\u4eec\u50cf\u5199\u540c\u6b65\u4ee3\u7801\u4e00\u6837\u5199\u5f02\u6b65\u4ee3\u7801, \u5927\u6982\u7c7b\u4f3c\u5730, \u534f\u7a0b\u5c31\u5141\u8bb8\u6211\u4eec\u50cf\u5199\u4e00\u4e2a\u5728\u540c\u4e00\u5e27\u5185\u5141\u8bb8\u7684\u4ee3\u7801\u4e00\u6837\u5199\u5728\u4e0d\u540c\u5e27\u5185\u8fd0\u884c\u7684\u4ee3\u7801. \u597d\u5427\u4e0a\u9762\u8fd9\u53e5\u8bdd\u6709\u70b9\u4e71, \u4e0d\u8fc7\u6211\u4eec\u770b\u4e00\u4e0b\u4f8b\u5b50\u5c31\u4f1a\u7406\u89e3\u4e86: <pre><code>var coroutine = new Coroutine(MakeRoutine());\nAdd(coroutine);\n\nstatic IEnumerator MakeRoutine()\n{\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5f00\u59cb!\");\n    yield return 1f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u8fc7\u4e861s!\");\n    yield return 2f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u53c8\u8fc7\u4e862s!\");\n    yield break;\n}\n</code></pre></p> <p>Info</p> <p>\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u7684 <code>yield return</code> \u7b49\u8bed\u6cd5\u5c5e\u4e8e \"\u8fed\u4ee3\u5668\u51fd\u6570\", \u5982\u679c\u4f60\u4e0d\u4e86\u89e3\u5b83\u7684\u8bdd\u4f60\u53ef\u4ee5\u5230 msdn \u4e0a\u6216\u8005 bing \u641c\u7d22 \u4e0a\u67e5\u627e\u5b83.</p> <p>\u4e0a\u8ff0\u4ee3\u7801\u4f1a\u7acb\u523b\u6253\u5370\u4e00\u53e5 \"\u5f00\u59cb!\" \u7136\u540e\u7b49\u5f851s, \u7136\u540e\u6253\u5370 \"\u8fc7\u4e861s!\", \u518d\u8fc7\u4e862s\u540e\u518d\u6b21\u6253\u5370\"\u53c8\u8fc7\u4e862s!\". \u4e5f\u5c31\u662f\u8bf4\u4f60\u6bcf <code>yield return</code> \u4e00\u4e2a\u6d6e\u70b9\u6570, \u6e38\u620f\u4f1a\u7b49\u5f85\u8be5\u79d2\u6570, \u7136\u540e\u7ee7\u7eed\u6267\u884c\u4e0b\u9762\u7684\u4ee3\u7801. \u4f60\u53ef\u80fd\u89c9\u5f97\u8fd9\u4e0d\u5c31\u662f\u4e2a\u9ad8\u7ea7\u70b9\u7684 <code>Alarm</code> \u5417, \u786e\u5b9e, \u4f60\u4ecd\u7136\u53ef\u4ee5\u7528 <code>Alarm</code> \u6765\u91cd\u5199\u8fd9\u90e8\u5206\u529f\u80fd, \u4e0d\u8fc7\u5f88\u5feb\u4f60\u5c31\u4f1a\u9677\u5165\u56de\u8c03\u5730\u72f1\u5e76\u4e14\u4ee3\u7801\u4e5f\u53d8\u7684\u5341\u5206\u96be\u8bfb: <pre><code>Logger.Log(LogLevel.Info, \"tag\", \"\u5f00\u59cb!\");\nAlarm.Set(this, 1f, () =&gt;\n{\n    Logger.Log(LogLevel.Info, \"tag\", \"\u8fc7\u4e861s!\");\n    Alarm.Set(this, 2f, () =&gt;\n    {\n        Logger.Log(LogLevel.Info, \"tag\", \"\u53c8\u8fc7\u4e862s!\");\n\n    }, Alarm.AlarmMode.Oneshot);\n\n}, Alarm.AlarmMode.Oneshot);\n</code></pre></p> <p>\u9664\u4e86\u8fd4\u56de\u4e00\u4e9b\u6d6e\u70b9\u6570, \u6211\u4eec\u8fd8\u53ef\u4ee5\u8fd4\u56de\u4e00\u4e2a <code>null</code>, \u8fd9\u6837\u4f1a\u8ba9\u6e38\u620f\u4ec5\u7b49\u5f85\u4e00\u5e27, \u4e5f\u5c31\u662f\u5728\u8fd9\u6b21\u8fd4\u56de\u540e, \u6e38\u620f\u5728\u4e0b\u4e00\u5e27\u7acb\u523b\u7ee7\u7eed\u6267\u884c\u800c\u4e0d\u662f\u7b49\u5f85\u79d2\u6570. \u6bd4\u5982\u5728\u5b98\u56fe\u4e2d <code>FallingBlock</code> \u5bf9\u5176\u7684\u4e00\u4e2a\u5e94\u7528(\u5df2\u7b80\u5316, \u5220\u9664\u4e86 BadelineBoss \u76f8\u5173\u7684\u4ee3\u7801): Celeste.FallingBlock.Sequence()<pre><code>// \u6301\u7eed\u68c0\u6d4b\u662f\u5426\u73a9\u5bb6\u5728\u4e0a\u9762\u6293/\u7ad9\u7740\nwhile (!PlayerFallCheck())\n    yield return null;\n// \u73a9\u5bb6\u6293/\u7ad9\u7740, \u8fdb\u5165\u6389\u843d\u72b6\u6001\nHasStartedFalling = true;\nwhile (true)\n{\n    // \u5728\u771f\u6b63\u8fdb\u884c\u5411\u4e0b\u79fb\u52a8\u65f6\u5148\u7b49\u5f85 0.2s \n    yield return 0.2f;\n\n    // \u7136\u540e\u7b49\u5f85 0.4s, \u4f46\u662f\u73a9\u5bb6\u79bb\u5f00\u6389\u843d\u5757\u540e\u4f1a\u53d6\u6d88\u8fd9\u4e2a\u7b49\u5f85\n    float waitTimer = 0.4f;\n    while (waitTimer &gt; 0f &amp;&amp; PlayerWaitCheck())\n    {\n        yield return null;\n        waitTimer -= Engine.DeltaTime;\n    }\n\n    // ......, \u6267\u884c\u6301\u7eed\u6389\u843d\u7684\u903b\u8f91, \u76f4\u5230\u78b0\u5230\u4e86\u5e73\u53f0(\u6cdb\u6307\u6240\u6709\u4e0a\u9762\u80fd\u7ad9\u7684\u4e1c\u897f, \u975e\u6307\u6728\u5e73\u53f0, \u4e0b\u540c)\u7136\u540e\u505c\u4e0b\n\n    // \u6bcf\u9694 0.1s \u68c0\u6d4b\u662f\u5426\u5e95\u4e0b\u4f9d\u7136\u8fd8\u5b58\u5728\u5e73\u53f0, \u5426\u5219\u8fdb\u5165\u4e0b\u4e00\u6b21 while \u5faa\u73af\n    while (CollideCheck&lt;Platform&gt;(Position + new Vector2(0f, 1f)))\n        yield return 0.1f;\n}\n......\n</code></pre> \u73b0\u5728\u56de\u5fc6\u4e00\u4e0b\u5b98\u56fe\u7684\u6389\u843d\u5757\u7684\u903b\u8f91, \u662f\u4e0d\u662f\u548c\u4e0a\u9762\u4ee3\u7801\u63cf\u8ff0\u7684\u4e00\u81f4? \u5982\u679c\u6ca1\u6709\u4e86\u534f\u7a0b, \u6211\u4eec\u5c31\u5f97\u7528\u4e00\u4e2a\u72b6\u6001\u53d8\u91cf\u6765\u50a8\u5b58\u6389\u843d\u5757\u8fdb\u884c\u5230\u54ea\u4e00\u6b65, \u5e76\u4e14\u65f6\u65f6\u523b\u523b\u7ef4\u62a4\u8fd9\u4e2a\u53d8\u91cf, \u65e5\u76ca\u53d8\u7684\u8d8a\u6765\u8d8a\u9ebb\u70e6.</p> <p>\u534f\u7a0b\u8fd8\u80fd\u8fd4\u56de\u53e6\u4e00\u4e2a\u534f\u7a0b, \u53ea\u9700\u8981\u8fd4\u56de\u4e00\u4e2a <code>IEnumerator</code>: <pre><code>var coroutine = new Coroutine(MakeRoutine());\nAdd(coroutine);\n\nstatic IEnumerator MakeRoutine()\n{\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5f00\u59cb!\");\n    yield return 1f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u8fc7\u4e861s!\");\n    yield return MakeRoutineInner();\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5185\u90e8\u7684\u534f\u7a0b\u7ed3\u675f\u4e86!\");\n    yield return MakeRoutineInner();\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5185\u90e8\u7684\u534f\u7a0b\u53c8\u4e00\u6b21\u7ed3\u675f\u4e86!\");\n    yield break;\n}\n\nstatic IEnumerator MakeRoutineInner()\n{\n    yield return 1f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5185\u90e8\u7b49\u4e861s!\");\n    yield return 1f;\n    Logger.Log(LogLevel.Info, \"tag\", \"\u5185\u90e8\u53c8\u7b49\u4e861s!\");\n    yield break;\n}\n</code></pre> \u5b83\u7684\u8f93\u51fa\u4f1a\u50cf\u662f: <pre><code>(09/30/2023 13:39:28) [Everest] [Info] [tag] \u5f00\u59cb!\n(09/30/2023 13:39:29) [Everest] [Info] [tag] \u8fc7\u4e861s!\n(09/30/2023 13:39:30) [Everest] [Info] [tag] \u5185\u90e8\u7b49\u4e861s!\n(09/30/2023 13:39:31) [Everest] [Info] [tag] \u5185\u90e8\u53c8\u7b49\u4e861s!\n(09/30/2023 13:39:31) [Everest] [Info] [tag] \u5185\u90e8\u7684\u534f\u7a0b\u7ed3\u675f\u4e86!\n(09/30/2023 13:39:32) [Everest] [Info] [tag] \u5185\u90e8\u7b49\u4e861s!\n(09/30/2023 13:39:33) [Everest] [Info] [tag] \u5185\u90e8\u53c8\u7b49\u4e861s!\n(09/30/2023 13:39:33) [Everest] [Info] [tag] \u5185\u90e8\u7684\u534f\u7a0b\u53c8\u4e00\u6b21\u7ed3\u675f\u4e86!\n</code></pre></p> <p>\u4f7f\u7528\u534f\u7a0b, \u6211\u4eec\u53ef\u4ee5\u5f88\u8f7b\u677e\u7684\u5c31\u50cf\u81ea\u7136\u63cf\u8ff0\u4e00\u4e2a\u8fc7\u7a0b\u4e00\u6837 \"\u81ea\u7136\" \u5730\u5199\u5b9e\u73b0\u7684\u4ee3\u7801, \u5b98\u56fe\u4e2d\u5267\u60c5\u7684\u5b9e\u73b0\u5c31\u662f\u4e00\u4e2a\u5f88\u597d\u7684\u4f8b\u5b50(\u6b64\u5904\u4e3a\u5e8f\u7ae0\u9e1f\u6559\u51b2\u523a\u7684\u5267\u60c5, \u5df2\u5927\u91cf\u7b80\u5316): Celeste.CS00_Ending<pre><code>private IEnumerator Cutscene(Level level)\n{\n    // \u6162\u6162\u51cf\u6162\u6e38\u620f\u901f\u5ea6\u76f4\u5230 0.0x, \u5e76\u4e14\u5728\u51cf\u6162\u5230 0.5x \u65f6\u505c\u6b62\u6865\u5d29\u584c\u97f3\u4e50\n    while (Engine.TimeRate &gt; 0f)\n    {\n        yield return null;\n        if (Engine.TimeRate &lt; 0.5f &amp;&amp; bridge != null)\n            bridge.StopCollapseLoop();\n        level.StopShake();\n        Engine.TimeRate -= Engine.RawDeltaTime * 2f;\n    }\n    // \u6b64\u65f6\u6e38\u620f\u901f\u5ea6\u4f1a\u88ab\u8bef\u51cf\u5230\u8d1f\u6570, \u8bbe\u7f6e\u56de 0 \u9632\u6b62\u6e38\u620f\u884c\u4e3a\u5f02\u5e38\n    Engine.TimeRate = 0f;\n    // \u5207\u6362\u73a9\u5bb6\u72b6\u6001\u5230 StDummy, \u5373\u7981\u6b62\u6240\u6709\u8f93\u5165\u548c\u4ea4\u4e92\n    player.StateMachine.State = Player.StDummy;\n    // \u9501\u5b9a\u73a9\u5bb6\u671d\u5411\u4e3a\u53f3\n    player.Facing = Facings.Right;\n    // \u65e0\u89c6\u6e38\u620f\u901f\u5ea6\u5730\u7b49\u5f85 1s, \u9ed8\u8ba4\u8fd4\u56de\u6d6e\u70b9\u6570\u7684\u7b49\u5f85\u4f1a\u53d7\u6e38\u620f\u901f\u5ea6\u5f71\u54cd,\n    // \u8fd9\u91cc\u5982\u679c\u7528\u8fd4\u56de\u6d6e\u70b9\u6570\u7684\u7b49\u5f85\u4f1a\u9020\u6210\u534f\u7a0b\u505c\u6b62, \u56e0\u4e3a\u6e38\u620f\u901f\u5ea6\u4e3a 0x, \u5373\u7b49\u5f85\u6c38\u8fdc\u4e0d\u4f1a\u7ed3\u675f\n    yield return WaitFor(1f);\n    // \u64ad\u653e\u9e1f\u98de\u5165\u7684\u58f0\u97f3\n    Audio.Play(\"event:/game/general/bird_in\", bird.Position);\n    // \u8bbe\u7f6e\u9e1f\u7684\u671d\u5411\u548c\u52a8\u753b\n    bird.Facing = Facings.Left;\n    bird.Sprite.Play(\"fall\", false, false);\n    // \u7f13\u52a8\u9e1f\u7684\u4f4d\u7f6e, \u5e76\u5728\u9e1f\u98de\u5230\u4e00\u534a\u65f6\u64ad\u653e\u98de\u884c\u7684\u52a8\u753b\n    float percent = 0f;\n    Vector2 from = bird.Position;\n    Vector2 to = bird.StartPosition;\n    while (percent &lt; 1f)\n    {\n        bird.Position = from + (to - from) * Ease.QuadOut(percent);\n        if (percent &gt; 0.5f)\n            bird.Sprite.Play(\"fly\", false, false);\n        percent += Engine.RawDeltaTime * 0.5f;\n        yield return null;\n    }\n    bird.Position = to;\n    from = default(Vector2);\n    to = default(Vector2);\n    // \u64ad\u653e\u9e1f\u78b0\u5730\u7684\u97f3\u6548\n    Audio.Play(\"event:/game/general/bird_land_dirt\", bird.Position);\n    // \u5411\u5de6\u91ca\u653e\u5c18\u57c3\u7c92\u5b50\u6548\u679c\n    Dust.Burst(bird.Position, - MathHelper.PI / 2, 12);\n    // \u64ad\u653e\u95f2\u7f6e\u52a8\u753b, \u7136\u540e\u7b49\u5f85 0.5s \u540e\u518d\u6b21\u64ad\u653e\u5544\u5730\u7684\u52a8\u753b\n    bird.Sprite.Play(\"idle\", false, false);\n    yield return WaitFor(0.5f);\n    bird.Sprite.Play(\"peck\", false, false);\n    // \u7b49\u5f85 1.1s, \u4e5f\u5c31\u662f\u5dee\u4e0d\u591a\u5544\u5730\u52a8\u753b\u7684\u957f\u5ea6\n    yield return WaitFor(1.1f);\n    // \u64ad\u653e\u51b2\u523a\u6559\u5b66\n    yield return bird.ShowTutorial(new BirdTutorialGui(\n        bird, new Vector2(0f, -16f), Dialog.Clean(\"tutorial_dash\", null), \n        new Vector2(1f, -1f), \"+\", BirdTutorialGui.ButtonPrompt.Dash\n        ), caw: true);\n\n    // \u6301\u7eed\u7b49\u5f85, \u76f4\u5230\u73a9\u5bb6\u6309\u4e0b\u4e86\u53f3\u4e0a\u51b2\n    for (;;)\n    {\n        Vector2 aimVector = Input.GetAimVector(Facings.Right);\n        if (aimVector.X &gt; 0f &amp;&amp; aimVector.Y &lt; 0f &amp;&amp; Input.Dash.Pressed)\n            break;\n        yield return null;\n    }\n    // \u8bbe\u7f6e\u73a9\u5bb6\u7684\u72b6\u6001\u4e3a \"\u9e1f\u51b2\u523a\u6559\u7a0b\" \u72b6\u6001, \u8fd9\u4e2a\u72b6\u6001\u5373\u51b2\u523a\u5f00\u59cb\u5230\u4e0a\u5cb8\u5e76\u5f3a\u5236\u79fb\u52a8\u5230\u53f3\u4fa7\u7684\u72b6\u6001\n    player.StateMachine.State = Player.StBirdDashTutorial;\n    player.Dashes = 0;\n    level.Session.Inventory.Dashes = 1;\n    // \u6062\u590d\u6e38\u620f\u901f\u7387\n    Engine.TimeRate = 1f;\n    // \u6536\u56de\u9e1f\u7684\u6559\u7a0b\u6846\u6846\n    bird.Add(new Coroutine(bird.HideTutorial()));\n    // \u7b49\u5f85 0.25s\n    yield return 0.25f;\n    // \u64ad\u653e\u9e1f\u88ab\u73a9\u5bb6\u5413\u8d70\u98de\u8d70\u7684\u52a8\u753b (\u6b64\u65f6\u5927\u7ea6\u662f\u73a9\u5bb6\u51b2\u523a\u7ed3\u675f\u7684\u65f6\u95f4)\n    bird.Add(new Coroutine(bird.StartleAndFlyAway()));\n    // \u7b49\u5f85\u76f4\u5230\u73a9\u5bb6\u843d\u5730, \u6216\u8005\u76f4\u5230\u73a9\u5bb6\u5bc4\u4e86\n    while (!player.Dead &amp;&amp; !player.OnGround(1))\n        yield return null;\n    // \u7b49\u5f85 2s\n    yield return 2f;\n    // \u64ad\u653e title_ping \u97f3\u6548, \u5982\u679c\u4f60\u60f3\u4e0d\u8d77\u6765\u7684\u8bdd\u4f60\u53ef\u4ee5\u53bb\u4ed4\u7ec6\u542c\u542c\n    // \u5728\u851a\u84dd\u6e90 fmod \u5de5\u7a0b\u6587\u4ef6\u91cc\u5b83\u7684\u97f3\u9891\u6587\u4ef6\u4f4d\u4e8e music/kuraine/mus_lvl0_titleping_oneshot.ogg\n    Audio.SetMusic(\"event:/music/lvl0/title_ping\");\n    // \u7ee7\u7eed\u7b49\u5f85 2s\n    yield return 2f;\n    // \u5411\u573a\u666f\u4e2d\u52a0\u5165\u663e\u793a \"\u4f60\u80fd\u505a\u5230\u3002\" \u8fd9\u53e5\u8bdd\u7684\u5b9e\u4f53\n    endingText = new PrologueEndingText(false);\n    Scene.Add(endingText);\n\n    // \u83b7\u53d6\u5173\u5361\u4e2d\u63a7\u5236\u524d\u666f\u96ea\u548c\u80cc\u666f\u96ea\u7684\u5b9e\u4f53\n    Snow bgSnow = level.Background.Get&lt;Snow&gt;();\n    Snow fgSnow = level.Foreground.Get&lt;Snow&gt;();\n    // \u987a\u4fbf\u52a0\u5165\u9ad8\u5206\u8fa8\u7387\u7684\u96ea, \u4e5f\u5373 ui \u5c42\u4e0a\u7684\u96ea (HiresSnow = High resolution snow)\n    level.Add(level.HiresSnow = new HiresSnow(0.45f));\n    // \u4f46\u662f\u5148\u628a\u900f\u660e\u5ea6\u8c03\u6210 0, \u7528\u6765\u7b49\u4f1a\u6e10\u53d8\n    level.HiresSnow.Alpha = 0f;\n\n    // \u5f00\u59cb\u6e10\u53d8\u4e09\u5c42\u96ea\u7684\u900f\u660e\u5ea6\n    float ease = 0f;\n    while (ease &lt; 1f)\n    {\n        ease += Engine.DeltaTime * 0.25f;\n        float eased = Ease.CubeInOut(ease);\n        if (fgSnow != null)\n            fgSnow.Alpha -= Engine.DeltaTime * 0.5f;\n        if (bgSnow != null)\n            bgSnow.Alpha -= Engine.DeltaTime * 0.5f;\n        level.HiresSnow.Alpha = Calc.Approach(level.HiresSnow.Alpha, 1f, Engine.DeltaTime * 0.5f);\n        // \u4e8e\u6b64\u540c\u65f6 \"\u4f60\u80fd\u505a\u5230\u3002\" \u8fd9\u53e5\u8bdd\u4e5f\u6162\u6162\u964d\u4e0b\u6765\n        endingText.Position = new Vector2(960f, 540f - 1080f * (1f - eased));\n        // \u6444\u50cf\u673a\u4e5f\u6162\u6162\u5411\u4e0a\u79fb\u52a8\n        level.Camera.Y = level.Bounds.Top - 3900f * eased;\n        yield return null;\n    }\n    // \u7ed3\u675f\u8fd9\u4e2a\u5267\u60c5\n    EndCutscene(level);\n    yield break;\n}\n</code></pre></p>"},{"location":"trans/ec_common/","title":"\u66f4\u591a EC","text":"<p>\u90a3\u4e48\u7ecf\u8fc7\u524d\u9762\u7684\u9605\u8bfb, \u76f8\u4fe1\u4f60\u5df2\u7ecf\u4e86\u89e3\u5230\u4e86\u4e00\u4e9b\u5f88\u5f88\u5f88\u57fa\u672c\u7684\u77e5\u8bc6, \u90a3\u4e48\u4ece\u8fd9\u4e00\u7ae0\u5f00\u59cb\u5c31\u662f\u4e00\u4e9b\u96f6\u788e\u4e14\u6742\u4e71\u7684\u4e1c\u897f\u4e86. \u987a\u4fbf\u6240\u4ee5, \u6211\u8fd8\u662f\u5f88\u5efa\u8bae\u4f60\u53bb\u591a\u9605\u8bfb\u4e00\u4e0b\u539f\u7248\u7684\u4ee3\u7801\u4ee5\u53ca\u4e00\u4e9b\u5e38\u89c1\u7b80\u5355Helper\u7684\u6e90\u7801, \u6bd5\u7adf\u6211\u81ea\u5df1\u90fd\u4e0d\u77e5\u9053\u6211\u9700\u8981\u5728\u8fd9\u91cc\u8bf4\u4e9b\u4ec0\u4e48(</p> <p>_(:\u0437\u300d\u2220)_</p> <p>_(:\u0437\u300d\u2220)_ \u6446\u70c2\u4e86\u8fd9\u8282\u53ef\u80fd\u4f1a\u5f88\u4e0d\u660e\u6240\u4ee5(</p>"},{"location":"trans/ec_common/#_1","title":"\u751f\u547d\u5468\u671f","text":"<p>\u5728\u524d\u9762\u6211\u4eec\u5df2\u7ecf\u4e86\u89e3\u5230\u4e86 <code>Update</code> \u51fd\u6570\u548c <code>Render</code> \u51fd\u6570, <code>Update</code> \u4e0e <code>Render</code> \u6bcf\u5e27\u90fd\u4f1a\u88ab\u8c03\u7528, \u5bf9\u4e8e\u903b\u8f91\u7684\u66f4\u65b0\u6211\u4eec\u5e94\u5728 <code>Update</code> \u4e2d\u505a, \u800c\u6709\u5173\u7ed8\u5236\u7684\u4efb\u52a1\u6211\u4eec\u5e94\u8be5\u5728 <code>Render</code> \u4e2d\u505a, \u8fd9\u662f\u56e0\u4e3a\u5373\u4f7f\u4f60\u5728 <code>Update</code> \u4e2d\u8fdb\u884c\u4e86\u7ed8\u5236\u7684\u8c03\u7528, \u5728 <code>Render</code> \u5f00\u59cb\u4e4b\u524d\u4e5f\u4f1a\u88ab\u851a\u84dd\u6e05\u7a7a. \u7c7b\u4f3c\u5730, \u6e38\u620f\u4e2d\u7684\u6682\u505c\u7684\u5b9e\u73b0\u539f\u7406\u662f\u505c\u6b62\u6bcf\u5e27 <code>Update</code> \u7684\u8c03\u7528\u800c\u4fdd\u7559 <code>Render</code> \u7684\u8c03\u7528, \u90a3\u4e48\u81ea\u7136\u5982\u679c\u4f60\u5728 <code>Render</code> \u91cc\u8fdb\u884c\u903b\u8f91\u66f4\u65b0\u4f60\u4f1a\u7834\u574f\u6389\u6e38\u620f\u539f\u6709\u7684\u6682\u505c.  </p> <p>ok\u90a3\u4e48\u6211\u4eec balabala \u8bf4\u4e86\u4e00\u5927\u5806, \u63a5\u4e0b\u6765\u4ecb\u7ecd\u51e0\u4e2a\u4f1a\u88ab\u851a\u84dd\u8c03\u7528\u7684\u51fd\u6570, \u8fd9\u4e9b\u51fd\u6570\u4e5f\u53eb\u505a<code>\u751f\u547d\u5468\u671f</code>\u51fd\u6570.</p>"},{"location":"trans/ec_common/#entity","title":"\u5bf9\u4e8e Entity","text":"<ul> <li><code>Update</code></li> <li><code>Render</code></li> <li><code>DebugRender</code>: \u8be5\u51fd\u6570\u4f1a\u5728\u851a\u84dd\u8c03\u8bd5\u63a7\u5236\u53f0\u88ab\u6253\u5f00\u65f6\u88ab\u6bcf\u5e27\u88ab\u8c03\u7528\u4f5c\u4e3a debug \u6e32\u67d3, \u5373 everest \u9ed8\u8ba4 ~ \u952e\u6253\u5f00\u7684\u90a3\u4e2a, \u5b83\u7684\u9ed8\u8ba4\u884c\u4e3a\u662f\u7ed8\u5236\u8be5\u5b9e\u4f53\u7684\u78b0\u649e\u7bb1, \u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u505a\u4e00\u4e9b\u8c03\u8bd5\u7528\u7684\u6807\u8bc6\u7684\u7ed8\u5236, \u5c31\u6bd4\u5982\u8bf4\u4f60\u7684\u5b9e\u4f53\u7684\u4f5c\u7528\u8303\u56f4\u4ec0\u4e48\u7684.</li> <li><code>Added</code>: \u5f53\u8be5\u5b9e\u4f53\u88ab\u4ee5 <code>Scene.Add</code> \u51fd\u6570\u8c03\u7528\u52a0\u5165\u5230\u573a\u666f\u4e0a\u65f6\u8c03\u7528, \u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u8bfb\u53d6\u573a\u666f\u7684\u4e00\u4e9b\u72b6\u6001\u6216\u8005 flag \u4e4b\u7c7b\u7684\u5e76\u66f4\u6539\u5b83\u7684\u884c\u4e3a.</li> <li><code>Awake</code>: \u8be5\u51fd\u6570\u4e0e <code>Added</code> \u884c\u4e3a\u76f8\u540c, \u4f46\u662f\u5f53\u4e00\u5e27\u4e4b\u5185\u6709\u591a\u4e2a\u5b9e\u4f53\u88ab\u52a0\u5165\u573a\u666f\u65f6\u5b83\u4eec\u7684 <code>Awake</code> \u4f1a\u5728\u8fd9\u4e9b\u5b9e\u4f53\u90fd\u88ab\u52a0\u5165\u540e\u518d\u6279\u91cf\u8c03\u7528, \u800c <code>Added</code> \u5219\u662f\u52a0\u5165\u4e00\u4e2a\u5c31\u8c03\u7528\u4e00\u4e2a. \u4e00\u4e2a\u5f88\u597d\u7684\u5728\u5b98\u56fe\u4e2d\u8fd0\u7528\u7684\u4f8b\u5b50\u662f\u6d6e\u52a8\u5757\u7684\u8fde\u63a5, \u8fd9\u662f\u5728\u573a\u666f\u5f00\u59cb\u65f6\u505a\u7684, \u4e3a\u4e86\u9632\u6b62\u9057\u6f0f\u67d0\u4e9b\u6d6e\u52a8\u5757\u95f4\u7684\u8fde\u63a5\u5c31\u9700\u8981\u5728\u5b9e\u4f53\u90fd\u88ab\u52a0\u5165\u540e\u518d\u8c03\u7528.</li> <li><code>Removed</code>: \u5f53\u8be5\u5b9e\u4f53\u88ab\u4ee5 <code>Scene.Remove</code> \u51fd\u6570\u8c03\u7528\u79fb\u9664\u573a\u666f\u65f6\u8c03\u7528, \u4f60\u53ef\u4ee5\u5728\u8fd9\u91cc\u53d6\u6d88\u4e00\u4e9b\u5b9e\u4f53\u5bf9\u573a\u666f\u7684\u4e00\u4e9b\u4f5c\u7528, \u6bd4\u5982\u8bf4\u80cc\u666f\u7684\u53d8\u5316.</li> <li><code>SceneBegin</code>: \u5f53\u573a\u666f\u88ab\u8c03\u7528 <code>Scene.Begin</code> \u7684\u540c\u65f6\u8c03\u7528</li> <li><code>SceneEnd</code>: \u5f53\u573a\u666f\u88ab\u8c03\u7528 <code>Scene.End</code> \u7684\u540c\u65f6\u8c03\u7528</li> </ul>"},{"location":"trans/ec_common/#component","title":"\u5bf9\u4e8e Component","text":"<p>\u5bf9\u4e8e Component \u6765\u8bf4\u5927\u90e8\u5206\u51fd\u6570\u4e0e Entity \u7684\u7c7b\u4f3c, \u53ea\u4e0d\u8fc7\u540d\u5b57\u524d\u52a0\u4e2a\u4e86 Entity. \u6bd4\u5982\u5b9e\u4f53\u7684 <code>Awake</code> \u5bf9\u5e94 Component \u7684 <code>EntityAwake</code>, \u901a\u5e38\u8fd9\u4e9b\u51fd\u6570\u88ab\u8c03\u7528\u7684\u5730\u65b9\u662f\u5bf9\u5e94\u7684 Entity \u7684\u751f\u547d\u5468\u671f\u51fd\u6570\u7684\u9ed8\u8ba4\u5b9e\u73b0, \u6240\u4ee5\u9664\u975e\u6709\u610f\u800c\u4e3a\u4e4b\u8bb0\u5f97\u5728\u5f00\u5934\u8c03\u7528\u57fa\u7c7b\u7684\u751f\u547d\u5468\u671f\u5b9e\u73b0: MyInterestingEntity.cs<pre><code>public override void Awake()\n{\n    // ensure `Awake`s of its components has been called\n    base.Awake();\n    // do other thing...\n}\n</code></pre></p>"},{"location":"trans/ec_common/#scene","title":"\u5bf9\u4e8e Scene","text":"<p>\u55ef... \u5bf9\u5e94 Scene \u7684\u4e00\u4e9b\u751f\u547d\u5468\u671f\u51fd\u6570\u6211\u4e2a\u4eba\u4e5f\u4e0d\u662f\u5f88\u4e86\u89e3\u6bd5\u7adf\u6211\u4eec\u5927\u90e8\u5206\u7684\u65f6\u95f4\u90fd\u5728 gameplay \u7684\u573a\u666f\u4e0a, \u6240\u4ee5\u8fd9\u8282\u5c31\u6682\u65f6\u5495\u4e86(\u3002_\u3002)</p>"},{"location":"trans/ec_common/#_2","title":"\u5e38\u89c1\u7684\u65b9\u6cd5\u4e0e\u5c5e\u6027","text":"<ul> <li><code>Scene.Add</code>: \u5c06\u4e00\u4e2a\u5b9e\u4f53\u52a0\u5165\u5230\u573a\u666f\u4e2d</li> <li><code>Entity.Add</code>: \u5c06\u4e00\u4e2a Component \u6302\u8f7d\u5230\u5b9e\u4f53\u4e0a</li> <li><code>Scene.Remove</code>: \u5c06\u4e00\u4e2a\u5b9e\u4f53\u79fb\u51fa\u573a\u666f</li> <li><code>Entity.Remove</code>: \u5c06\u4e00\u4e2a Component \u79fb\u51fa\u5b9e\u4f53</li> <li><code>Entity.RemoveSelf</code>: \u5c06 Entity \u81ea\u8eab\u79fb\u51fa\u81ea\u8eab\u6240\u5728\u573a\u666f</li> <li><code>Component.RemoveSelf</code>: \u5c06 Component \u81ea\u8eab\u79fb\u51fa\u6240\u5728\u5b9e\u4f53</li> <li><code>Scene.Entities</code>: \u83b7\u53d6\u5f53\u524d\u573a\u666f\u4e0a\u7684\u5b9e\u4f53\u5217\u8868</li> <li><code>Entity.Components</code>: \u83b7\u53d6\u5f53\u524d\u5b9e\u4f53\u7684 Component \u5217\u8868</li> </ul>"},{"location":"trans/ec_common/#entity_1","title":"Entity","text":"<p><code>Entity</code> \u672c\u8eab\u6709\u56db\u4e2a\u516c\u5f00\u7684\u5b57\u6bb5:</p> <ul> <li><code>Active</code>, \u8be5 <code>bool</code> \u5b57\u6bb5\u8868\u793a\u8be5 <code>Entity</code> \u662f\u5426 \"\u5b58\u6d3b\", \u5426\u5219\u4e3a \"\u5931\u6d3b\", \"\u5931\u6d3b\" \u7684 <code>Entity</code> \u5c06\u4e0d\u4f1a\u88ab\u8c03\u7528 <code>Update</code> \u65b9\u6cd5\u76f4\u5230 <code>Active</code> \u4e3a <code>true</code></li> <li><code>Collidable</code>, \u8be5 <code>bool</code> \u5b57\u6bb5\u8868\u793a\u8be5 <code>Entity</code> \u662f\u5426 \"\u53ef\u78b0\u649e\", \u4e0d\u53ef\u78b0\u649e\u7684\u5b9e\u4f53\u4e0e\u4efb\u4f55\u5b9e\u4f53\u8fdb\u884c\u78b0\u649e\u68c0\u6d4b\u65f6\u90fd\u4f1a\u8fd4\u56de <code>false</code>, \u6240\u4ee5\u4f60\u53ef\u4ee5\u4f7f\u7528\u8be5\u81ea\u52a8\u7981\u7528\u5b83\u7684\u78b0\u649e\u7bb1</li> <li><code>Visible</code>, \u8be5 <code>bool</code> \u5b57\u6bb5\u8868\u793a\u8be5 <code>Entity</code> \u662f\u5426 \"\u53ef\u89c1\", \u4e0d\u53ef\u89c1\u7684\u5b9e\u4f53\u4e0d\u4f1a\u88ab\u8c03\u7528 <code>Render</code> \u65b9\u6cd5, \u6ce8\u610f\u5373\u4f7f\u4e0d\u53ef\u89c1\u5b83\u7684\u78b0\u649e\u7bb1\u4f9d\u7136\u5b58\u5728.</li> <li><code>Position</code>, \u8be5 <code>Vector2</code> \u5b57\u6bb5\u8868\u793a\u8be5 <code>Entity</code> \u7684\u4f4d\u7f6e, \u6ce8\u610f\u8fd9\u4e2a\u4f4d\u7f6e\u76f8\u5bf9\u7684\u5750\u6807\u7cfb\u662f\u4e0d\u540c\u7684, \u5bf9\u4e8e HUD \u5b9e\u4f53\u6765\u8bf4\u5b83\u7684\u5750\u6807\u7cfb\u662f\u4e00\u4e2a 1922 x 1092 \u7684\u539f\u70b9\u5de6\u4e0a\u89d2\u7684\u5c4f\u5e55\u5750\u6807, \u5bf9\u4e8e gameplay \u5b9e\u4f53\u6765\u8bf4\u5b83\u662f\u76f8\u5bf9\u4e8e\u4e16\u754c\u539f\u70b9\u7684\u5206\u5ea6\u503c\u4e3a 1px \u7684\u5750\u6807. \u8fd9\u4e2a\u884c\u4e3a\u53ef\u4ee5\u901a\u8fc7\u540e\u9762\u6240\u8bf4\u7684 <code>Tag</code> \u6765\u914d\u7f6e.</li> </ul>"},{"location":"trans/ec_common/#tag","title":"Tag","text":"<p>:thinking: \u9664\u6b64\u4e4b\u5916\u5462\u8fd8\u6709\u4e00\u4e2a\u5c0f\u4e1c\u897f\u53eb <code>Tag</code>, \u8bed\u4e49\u4e0a\u6765\u8bf4\u5b83\u8868\u793a\u8fd9\u4e2a\u5b9e\u4f53\u7684\u4e00\u4e9b\u6807\u7b7e\u5c5e\u6027, \u4f60\u53ef\u4ee5\u901a\u8fc7 <code>Entity.Tag</code> \u5c5e\u6027\u6765\u8bbf\u95ee\u5b83, \u5b83\u662f\u4e00\u4e2a 32 \u4f4d\u6574\u6570, \u5b83\u7684\u6bcf\u4e00\u4f4d\u8868\u793a\u4e00\u4e2a\u8be5\u5b9e\u4f53\u7684\"\u5c5e\u6027\", \u6211\u4eec\u901a\u5e38\u4f1a\u4f7f\u7528 <code>AddTag</code> \u4ee5\u53ca <code>RemoveTag</code> \u6765\u64cd\u4f5c\u5b83. \u8981\u83b7\u53d6\u573a\u666f\u4e2d\u6240\u6709\u62e5\u6709\u67d0\u4e00 <code>Tag</code> \u7684\u5b9e\u4f53, \u6211\u4eec\u9700\u8981\u8bbf\u95ee <code>Scene</code> \u7684 <code>TagLists</code> \u800c\u4e0d\u662f <code>Tracker</code>, \u7136\u540e\u4f7f\u7528\u5b83\u7684\u7d22\u5f15\u5668(\u5f62\u5982 <code>tagList[yourtag]</code> \u7684\u8fd0\u7b97\u7b26)\u6765\u68c0\u7d22, \u6216\u8005\u4f60\u4e5f\u53ef\u4ee5\u4f7f\u7528\u7b80\u4fbf\u7684\u65b9\u6cd5---\u76f4\u63a5\u8bbf\u95ee <code>Scene</code> \u7684\u7d22\u5f15\u5668. \u4e00\u822c\u7684\u8bdd, \u6211\u5bf9\u4e8e <code>Tag</code> \u7684\u5e94\u7528\u5f88\u5c11, \u6700\u8fd1\u4e00\u6b21\u662f\u5c06\u4e00\u4e2a <code>Entity</code> \u6807\u8bb0\u4e3a ui \u5c42, \u5b83\u7684\u4ee3\u7801\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684: <pre><code>this.AddTag(Tags.HUD);\n</code></pre> \u5f53\u4f60\u7684\u5b9e\u4f53\u62e5\u6709\u8fd9\u4e2a Tag \u540e, \u851a\u84dd\u4f1a\u5c06\u4f60\u7684\u5b9e\u4f53\u7ed8\u5236\u5728 ui \u5c42, \u6bd4\u8f83\u5e38\u89c1\u7684\u4f8b\u5b50\u5c31\u662f\u5de6\u4e0a\u89d2\u7684\u8ba1\u65f6\u5668, \u5b83\u5728\u6784\u9020\u5668\u5185\u5c31\u7ed9\u81ea\u5df1\u6253\u4e0a\u4e86 <code>Tags.HUD</code> \u7684\u6807\u7b7e. \u4e5f\u5982\u4e0a\u9762\u6240\u8bf4\u7684, \u4e00\u4e9b\u851a\u84dd\u5e38\u89c1\u7684\u6240\u6709 Tag \u4f60\u90fd\u53ef\u4ee5\u5728 <code>Celeste.Tags</code> \u7c7b\u5185\u627e\u5230.</p> <p>\u4ee5\u4e0b\u662f\u4e00\u4e9b\u53ef\u80fd\u5730\u5e38\u89c1\u7684 Tag:</p> <ul> <li><code>PauseUpdate</code>: \u662f\u5426\u5728\u6682\u505c\u671f\u95f4\u4f9d\u7136\u88ab\u8c03\u7528 <code>Update</code>, \u901a\u5e38\u7528\u4e8e ui \u5c42\u7684\u5b9e\u4f53\u4e0a</li> <li><code>FrozenUpdate</code>: \u662f\u5426\u5728 <code>Frozen</code> \u72b6\u6001\u4e0b\u4f9d\u7136\u88ab\u8c03\u7528 <code>Update</code> (\u6bd4\u5982\u8349\u8393\u7c7d\u52a8\u753b\u8fc7\u7a0b, 1a\u84dd\u5fc3\u89e3\u5bc6\u6210\u529f\u8fc7\u7a0b, \u6ce8\u610f\u6b64\u72b6\u6001\u4e0e\u51bb\u7ed3\u5e27\u65e0\u5173)</li> <li><code>TransitionUpdate</code>: \u662f\u5426\u5728\u5173\u5361\u5207\u677f\u65f6\u4f9d\u7136\u88ab\u8c03\u7528 <code>Update</code>, \u901a\u5e38\u7528\u4e8e\u5728\u5207\u677f\u65f6\u66f4\u65b0\u4e00\u4e9b\u89c6\u89c9\u4e0a\u7684\u4e1c\u897f(\u6bd4\u5982\u7535\u7f51\u7684 \"\u653e\u7535\" \u52a8\u753b\u4e0d\u4f1a\u5728\u5207\u677f\u65f6\u9759\u6b62)</li> <li><code>HUD</code>: \u5373\u662f\u5426\u662f ui \u5c42, \u6b64\u9879\u5c31\u4f1a\u66f4\u6539 <code>Entity</code> \u7684 <code>Position</code> \u7684\u76f8\u5bf9\u5750\u6807\u7cfb</li> <li><code>Global</code>: \u8be5 Entity \u662f\u5426\u662f\u5168\u5c40\u7684, \u4e00\u4e2a\u975e\u5168\u5c40\u5b9e\u4f53\u5728\u5173\u5361\u91cd\u8bd5\u540e\u4f1a\u6d88\u5931, \u5168\u5c40 Tag \u53ef\u4ee5\u907f\u514d\u8fd9\u4ef6\u4e8b, \u901a\u5e38\u5168\u5c40 Tag \u6700\u5e38\u89c1\u7684\u7528\u6cd5\u662f\u548c HUD \u7ed3\u5408\u5728\u4e00\u8d77, \u8fd9\u6837\u4f60\u5c31\u62e5\u6709\u4e86\u4e00\u4e2a\u5728\u6e38\u620f\u5185\u6301\u4e45\u7684 ui \u90e8\u4ef6\u4e86.</li> </ul>"},{"location":"trans/il/","title":"IL","text":"<p>Info</p> <p>\u5982\u679c\u4f60\u5728\u4e4b\u524d\u5df2\u7ecf\u5b66\u4e60\u8fc7 <code>IL</code> \u5e76\u4e14\u4f7f\u7528\u8fc7\u7c7b <code>System.Reflection.Emit</code> \u8fd9\u4e9b api \u7684\u8bdd\u4f60\u53ef\u4ee5\u8df3\u8fc7\u8fd9\u4e00\u8282.</p>"},{"location":"trans/il/#_1","title":"\u7b80\u4ecb","text":"<p><code>IL</code> \u5168\u79f0 <code>Intermediate Language</code>, \u5373\u4e2d\u95f4\u8bed\u8a00, \u5728\u4e00\u4e9b\u8f83\u8001\u7684\u6587\u6863\u91cc\u9762\u5b83\u53ef\u80fd\u4e5f\u4f1a\u88ab\u53eb\u505a <code>MSIL</code>, \u5373 <code>Microsoft Intermediate Language</code>, \u5076\u5c14\u8fd8\u4f1a\u6709\u4e00\u4e9b\u5730\u65b9\u53eb\u505a <code>CIL</code>, \u5373 <code>Common Intermediate Language</code>, \u8fd9\u4e09\u79cd\u53eb\u6cd5\u901a\u5e38\u610f\u4e49\u4e0a\u90fd\u662f\u6307\u4e00\u4e2a\u4e1c\u897f. \u5728\u524d\u9762\u6211\u4eec\u5c31\u5df2\u7ecf\u63d0\u5230\u8fc7 <code>IL</code> \u4e86(\u9605\u8bfb\u4ee3\u78012), \u4f46\u662f\u5e76\u6ca1\u6709\u6df1\u5165\u7684\u8bb2\u89e3\u5b83\u5230\u5e95\u662f\u4ec0\u4e48\u6837\u7684. <code>IL</code> \u901a\u5e38\u6765\u8bf4\u53ef\u4ee5\u7406\u89e3\u6210\u4e24\u4e2a\u90e8\u5206, \u4e00\u4e2a \"\u6267\u884c\" \u90e8\u5206, \u4e00\u4e2a \"\u58f0\u660e\" \u90e8\u5206, \"\u6267\u884c\" \u90e8\u5206\u89c4\u5b9a\u4e86\u4e00\u4e2a\u51fd\u6570\u5185\u90e8\u7684\u4ee3\u7801\u5e94\u8be5\u600e\u4e48\u64cd\u63a7\u6211\u4eec\u7684\u7a0b\u5e8f, \u800c \"\u58f0\u660e\" \u90e8\u5206\u5219\u89c4\u5b9a\u4e86\u4e00\u4e2a\u51fd\u6570\u7684\u8fd4\u56de\u503c, \u53c2\u6570\u5217\u8868, \u8bbf\u95ee\u4fee\u9970\u7b26, \u6240\u5728\u7c7b, \u7c7b\u7684\u8bbf\u95ee\u4fee\u9970\u7b26, \u540d\u79f0\u7b49\u8fd9\u4e9b\u5143\u6570\u636e, \u83b7\u53d6\u8fd9\u4e9b\u5143\u6570\u636e\u5176\u5b9e\u4f60\u65e9\u5728\u5b66\u4e60\u53cd\u5c04\u7684\u65f6\u5019\u5c31\u8fdb\u884c\u8fc7. \u540c\u65f6\u4fee\u6539\u6216\u751f\u6210\u8fd9\u4e9b\u5143\u6570\u636e\u4e5f\u4e0d\u56f0\u96be, \u4f46\u662f\u5728\u8fdb\u884c\u851a\u84dd modding \u65f6\u4fee\u6539\u6216\u751f\u6210\u8fd9\u4e9b\u5143\u6570\u636e\u7684\u64cd\u4f5c\u51e0\u4e4e\u4e0d\u4f1a\u88ab\u4f7f\u7528\u5230, \u6240\u4ee5\u8fd9\u4e00\u8282\u6211\u4eec\u805a\u7126\u4e8e <code>IL</code> \u7684 \"\u6267\u884c\" \u90e8\u5206, \u8bb2\u8ff0\u5176\u57fa\u672c\u7ed3\u6784, \u57fa\u7840\u8bed\u6cd5\u7b49\u5185\u5bb9.  </p>"},{"location":"trans/il/#_2","title":"\u521d\u5370\u8c61","text":"<p>HelloWorld!<pre><code>namespace DynamicAssemblyTest;\n\npublic static class Program\n{\n    public static void Main()\n    {\n        Console.WriteLine(\"Hello world!\");\n    }\n}\n</code></pre> \u73b0\u5728, \u8bd5\u7740\u7f16\u8bd1\u4e0a\u8ff0\u5f88\u7b80\u5355\u7684 HelloWorld \u7a0b\u5e8f, \u627e\u5230\u5176\u7a0b\u5e8f\u96c6, \u7136\u540e\u7528 <code>dnSpy</code>(\u6216\u8005 <code>ILSpy</code> \u4e5f\u884c) \u6253\u5f00\u5b83. \u4e0d\u8fc7\u8fd9\u6b21\u6211\u4eec\u4e0d\u662f\u5728\u770b <code>C#</code> \u4ee3\u7801\u4e86, \u6211\u4eec\u9700\u8981\u770b <code>IL</code> \u4ee3\u7801, \u6240\u4ee5\u6211\u4eec\u5728\u5982\u4e0b\u56fe\u7684\u8fd9\u4e2a\u4e0b\u62c9\u6846\u4e2d\u9009\u62e9 <code>IL</code>:</p> <p></p> <p>\u5728\u56fe\u4e2d\u7684\u90a3\u4e00\u5768\u4f60\u53ef\u80fd\u4e0d\u77e5\u6240\u63aa\u7684\u4ee3\u7801\u5c31\u662f <code>IL</code> \u4ee3\u7801\u4e86, \u5728\u4e0a\u8ff0 <code>IL</code> \u4ee3\u7801\u4e2d <code>.method</code> <code>.class</code> \u8fd9\u4e00\u7c7b\u5b57\u6837\u5c31\u8868\u793a\u58f0\u660e\u4e00\u4e2a \u65b9\u6cd5/\u7c7b, \u800c\u5176\u540e\u9762\u6240\u8ddf\u7684\u4e00\u5927\u957f\u4e32\u5173\u952e\u5b57\u5c31\u662f\u4e00\u4e9b\u5143\u6570\u636e, \u6bd4\u5982\u7c7b\u540d, \u8bbf\u95ee\u4fee\u9970\u7b26\u7b49\u6211\u4eec\u4e4b\u524d\u8c08\u8bba\u8fc7\u7684\u4e1c\u897f, \u540e\u9762\u7684\u5927\u62ec\u53f7\u5c31\u8868\u793a\u8fd9\u4e2a\u58f0\u660e\u7684 \"\u5185\u5bb9\u7269\", \u901a\u5e38\u7c7b\u7684 \"\u5185\u5bb9\u7269\" \u6709\u5185\u90e8\u7c7b, \u65b9\u6cd5, \u6784\u9020\u5668, \u5b57\u6bb5, \u5c5e\u6027\u7b49, \u90a3\u4e48\u663e\u800c\u6613\u89c1\u8fd9\u91cc\u5c31\u6beb\u65e0\u7591\u95ee\u5c31\u662f <code>IL</code> \u7684\u58f0\u660e\u90e8\u5206\u4e86. \u73b0\u5728\u6211\u4eec\u5173\u6ce8 <code>.method</code> \u58f0\u660e, \u5176\u7684 \"\u5185\u5bb9\u7269\" \u5c31\u662f\u6211\u4eec\u63a5\u4e0b\u6765\u8981\u805a\u7126\u7684, \u5373 <code>IL</code> \u7684 \"\u6267\u884c\" \u90e8\u5206. \u5728\u4e0a\u56fe\u4e2d dnSpy \u5e2e\u6211\u4eec\u5c06\u524d\u9762\u52a0\u4e0a\u4e86\u5b57\u8282\u5185\u5b58\u504f\u79fb\u7684\u90a3\u6bcf\u4e00\u884c\u5c31\u662f\u6211\u4eec\u7684 <code>IL</code> \u4ee3\u7801\u4e86, \u4e0d\u8fc7\u8fd9\u91cc\u6211\u4eec\u4e0d\u592a\u4f1a\u9700\u8981\u8fd9\u4e2a\u504f\u79fb\u91cf, \u56e0\u4e3a\u5927\u591a\u6570\u6d89\u53ca\u64cd\u4f5c <code>IL</code> \u7684\u5e93\u90fd\u4f1a\u4e3a\u6211\u4eec\u81ea\u52a8\u5b8c\u6210\u8fd9\u4e2a\u504f\u79fb\u7684\u8ba1\u7b97.</p>"},{"location":"trans/il/#_3","title":"\u5207\u6362\u73af\u5883 &amp; \u52a8\u6001\u7a0b\u5e8f\u96c6","text":"<p>\u73b0\u5728\u6211\u4eec\u9700\u8981\u4e00\u4e2a\u73af\u5883\u6765\u4e66\u5199\u6211\u4eec\u7684 <code>IL</code> \u4ee3\u7801, \u5f53\u7136\u4f60\u867d\u7136\u5b8c\u5168\u53ef\u4ee5\u5c31\u5728 dnSpy \u5bf9\u7740\u90a3\u4e00\u5927\u5806 <code>C#</code> \u7f16\u8bd1\u540e\u7684 <code>IL</code> \u8fdb\u884c\u4fee\u6539,  \u5e76\u9891\u7e41\u4fdd\u5b58\u4fee\u6539\u7136\u540e\u8fd0\u884c\u6765\u67e5\u770b\u6548\u679c, \u4f46\u662f\u8fd9\u603b\u5f52\u6ca1\u6709\u6211\u4eec\u76f4\u63a5\u5728 <code>C#</code> \u4ee3\u7801\u91cc\u5199 <code>IL</code> \u4ee3\u7801\u91cc\u65b9\u4fbf!</p> <p>\u9996\u5148, \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u4e0d\u518d\u5728 mod \u5de5\u7a0b\u91cc\u5de5\u4f5c\u4e86, \u8fd9\u90e8\u5206\u5185\u5bb9\u662f\u72ec\u7acb\u5f00\u6765\u7684, \u6240\u4ee5\u6211\u4f1a\u63a8\u8350\u4f60\u65b0\u5efa\u4e00\u4e2a\u9879\u76ee\u6765\u505a\u8fd9\u4e9b. \u8fd9\u91cc\u6211\u7ed9\u9879\u76ee\u53d6\u7684\u540d\u662f <code>DynamicAssemblyTest</code>, \u76ee\u6807\u6846\u67b6\u662f <code>.net 7</code>. \u5b8c\u6210\u540e, \u590d\u5236\u7c98\u8d34\u4ee5\u4e0b\u4ee3\u7801(\u4e4b\u540e\u6211\u4eec\u4f1a\u6162\u6162\u89e3\u91ca\u7684): <pre><code>using System.Reflection;\nusing System.Reflection.Emit;\n\nnamespace DynamicAssemblyTest;\n\npublic static class Program\n{\n    public static MethodInfo GenerateMethod(Action&lt;ILGenerator&gt; generateAction)\n    {\n        AssemblyBuilder asmBuilder = AssemblyBuilder.DefineDynamicAssembly(new(\"MyAssembly\"), AssemblyBuilderAccess.RunAndCollect);\n        ModuleBuilder moduleBuilder = asmBuilder.DefineDynamicModule(\"MyTestModule\");\n        TypeBuilder typeBuilder = moduleBuilder.DefineType(\"MyType\");\n        MethodBuilder methodBuilder = typeBuilder.DefineMethod(\"MyMethod\", MethodAttributes.Public | MethodAttributes.Static);\n        generateAction(methodBuilder.GetILGenerator());\n        return typeBuilder.CreateType().GetMethod(\"MyMethod\")!;\n    }\n\n    public static void Main()\n    {\n        MethodInfo methodInfo = GenerateMethod(il =&gt;\n        {\n            il.Emit(OpCodes.Ldstr, \"Hello Dynamic Method!\");\n            il.Emit(OpCodes.Call, typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!);\n            il.Emit(OpCodes.Ret);\n        });\n        Action action = methodInfo.CreateDelegate&lt;Action&gt;();\n        action();\n    }\n}\n</code></pre></p> <p>Note</p> <p>\u6211\u9ed8\u8ba4\u542f\u7528\u4e86\u9690\u5f0f\u547d\u540d\u7a7a\u95f4, \u5982\u679c\u4f60\u9047\u5230\u4e86\u7c7b\u578b\u672a\u627e\u5230\u7684\u62a5\u9519\u90a3\u4f60\u5c31\u5f97\u624b\u52a8 using \u4e00\u4e0b\u5269\u4f59\u7684\u90a3\u4e9b\u547d\u540d\u7a7a\u95f4\u4e86.</p> <p>\u73b0\u5728\u8fd0\u884c\u4f60\u7684\u7a0b\u5e8f, \u4f60\u5e94\u8be5\u4f1a\u5f97\u5230\u4e00\u53e5\u8f93\u51fa: <code>Hello Dynamic Method!</code>. \u4e0a\u8ff0\u4ee3\u7801\u5176\u5b9e\u662f\u5728\u5728\u4ee3\u7801\u4e2d\u52a8\u6001\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7a0b\u5e8f\u96c6, \u7136\u540e\u52a8\u6001\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7c7b, \u5e76\u5411\u91cc\u9762\u52a8\u6001\u5b9a\u4e49\u4e86\u4e00\u4e2a <code>MyMethod</code> \u65b9\u6cd5, \u4e4b\u540e\u6211\u4eec\u52a8\u6001\u5730 \"\u7f16\u8bd1\" \u4e86\u8fd9\u4e2a\u7a0b\u5e8f\u96c6\u5e76\u5c06\u5176\u88c5\u8f7d\u5230\u6211\u4eec\u7684\u7a0b\u5e8f\u96c6\u57df\u4e2d, \u5176\u4e2d, <code>MyMethod</code> \u65b9\u6cd5\u7684 <code>IL</code> \u7684\u5185\u5bb9\u5c31\u662f\u5728\u6211\u4eec\u7684 <code>Main</code> \u65b9\u6cd5\u4e2d <code>GenerateMethod</code> \u53c2\u6570\u4e2d\u7684\u59d4\u6258\u5b9a\u4e49\u7684. \u5f80\u7b80\u5355\u6765\u8bf4\u5c31\u662f\u6211\u4eec\u5728\u4ee3\u7801\u4e2d\u53cd\u5c04\u521b\u5efa\u4e86\u4e00\u6bb5\u65b0\u7684\u4ee3\u7801\u5e76\u6267\u884c, \u8fd9\u542c\u8d77\u6765\u662f\u4e0d\u662f\u9177\u6781\u4e86? \u4e0a\u9762\u8fd9\u4e2a\u52a8\u6001\u5b9a\u4e49\u7a0b\u5e8f\u96c6\u7684\u5e93\u53eb\u505a <code>System.Reflection.Emit</code>, \u5728\u8fd9\u91cc\u6211\u4eec\u53ea\u662f\u4e3a\u4e86\u5b66\u4e60\u4e00\u70b9 <code>IL</code> \u77e5\u8bc6\u800c\u4f7f\u7528, \u5230\u540e\u9762\u4fee\u6539\u851a\u84dd\u7684\u7a0b\u5e8f\u96c6\u65f6\u6211\u4eec\u9700\u8981\u4f7f\u7528 Everest \u5e26\u7684 <code>Mono.Cecil</code> \u5e93, \u4e0d\u8fc7\u4ed6\u4eec\u5927\u540c\u5c0f\u5f02.</p>"},{"location":"trans/il/#il_1","title":"\u57fa\u672c <code>IL</code>","text":"<pre><code>IL_0000: nop\nIL_0001: ldstr     \"Hello world!\"\nIL_0006: call      void [System.Console]System.Console::WriteLine(string)\nIL_000B: nop\nIL_000C: ret\n</code></pre> <p>\u901a\u5e38\u6765\u8bf4, \u4e00\u6bb5 <code>IL</code> \u5305\u542b\u591a\u884c <code>IL</code>, \u6bcf\u4e00\u884c <code>IL</code>(\u6211\u5076\u5c14\u4e5f\u4f1a\u79f0\u4e3a\u4e00\u53e5 <code>IL</code>) \u90fd\u5305\u542b\u4e00\u4e2a\u64cd\u4f5c\u7801(OpCode)\u4ee5\u53ca\u53ef\u4ee5\u6ca1\u6709\u7684\u53c2\u6570. \u6bd4\u5982\u4e0a\u8ff0\u6bb5 <code>IL</code>, \u5176\u5305\u542b\u4e94\u884c <code>IL</code>:</p> <ul> <li>\u7b2c\u4e00\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>nop</code>, \u6ca1\u6709\u53c2\u6570</li> <li>\u7b2c\u4e8c\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>ldstr</code>, \u53c2\u6570\u662f\u4e00\u4e32\u5b57\u7b26\u4e32, \u6216\u8005\u4e25\u8c28\u7684\u8bf4, \u662f\u4e00\u4e2a\u5b57\u7b26\u4e32\u7684 <code>token</code>, \u5b83\u5f15\u7528\u4e86\u7a0b\u5e8f\u96c6\u5143\u6570\u636e\u4e2d\u5b58\u653e\u5b57\u7b26\u4e32\u672c\u4f53\u7684\u4f4d\u7f6e,  \u4e0d\u8fc7\u6211\u4eec\u53ef\u4ee5\u5ffd\u7565\u8fd9\u4e2a\u7ec6\u8282, \u56e0\u4e3a\u6211\u4eec\u4e0d\u4f1a\u6d89\u53ca\u5230 <code>IL</code> \u7684\u5177\u4f53\u5b57\u8282\u5c42\u9762\u7684\u4e1c\u897f.</li> <li>\u7b2c\u4e09\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>call</code>, \u53c2\u6570\u662f\u4e00\u4e2a\u65b9\u6cd5, \u5b83\u4e5f\u662f\u4e00\u4e2a <code>token</code>, \u5176\u4e5f\u662f\u5f15\u7528\u4e86\u5143\u6570\u636e\u4e2d\u5b58\u653e\u65b9\u6cd5\u672c\u4f53\u7684\u4f4d\u7f6e</li> <li>\u7b2c\u56db\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>nop</code>, \u6ca1\u6709\u53c2\u6570</li> <li>\u7b2c\u4e94\u884c <code>IL</code> \u7684\u64cd\u4f5c\u7801\u662f <code>ret</code>, \u6ca1\u6709\u53c2\u6570</li> </ul> <p>\u90a3\u4e48, \u5728\u77e5\u9053 <code>IL</code> \u7684\u57fa\u672c\u7ed3\u6784\u540e, \u6211\u4eec\u5c31\u53ef\u4ee5\u5177\u4f53\u5b66\u4e60 <code>IL</code> \u8fd9\u4e9b\u64cd\u4f5c\u7801\u5230\u5e95\u5e72\u4e86\u4ec0\u4e48\u4e86.</p>"},{"location":"trans/il/#_4","title":"\u8bc4\u4f30\u6808","text":"<p>Note</p> <p>\u5982\u679c\u4f60\u5728\u8fd9\u91cc\u4e0d\u77e5\u9053\u6808\u662f\u4ec0\u4e48\u7684\u8bdd, \u4f60\u5c31\u8be5\u53bb\u590d\u4e60\u4e00\u4e0b\u4f60\u4e4b\u524d\u5b66\u4e60\u7684\u6570\u636e\u7ed3\u6784\u4e4b\u6808\u4e86.</p> <p>\u5728 <code>IL</code> \u4ee3\u7801\u4e2d, \u5927\u91cf\u64cd\u4f5c\u7b26\u672c\u8d28\u4e0a\u90fd\u662f\u5728\u64cd\u4f5c\u4e00\u4e2a\u53eb\u505a <code>\u8bc4\u4f30\u6808</code> \u7684\u4e1c\u897f, \u4ece\u5b57\u9762\u4e0a\u6211\u4eec\u5c31\u53ef\u4ee5\u77e5\u9053\u5b83\u662f\u4e00\u4e2a\u6808, \u90a3\u4e48\u65e2\u7136\u662f\u6808, \u90a3\u4e48\u901a\u5e38\u5c31\u6709 <code>\u538b\u5165</code> \u548c <code>\u5f39\u51fa</code> \u4e24\u79cd\u64cd\u4f5c, <code>\u8bc4\u4f30\u6808</code> \u4e5f\u662f\u5982\u6b64. \u6bd4\u5982\u5982\u4e0b <code>C#</code> \u65b9\u6cd5: <pre><code>static int Add(int a, int b, int c) \n{\n    return a + b + c;\n}\n</code></pre></p> <p>\u5b83\u5728\u7f16\u8bd1\u5668\u7684 <code>Release</code> \u4f18\u5316\u4e0b\u4f1a\u7f16\u8bd1\u6210\u5982\u4e0b <code>IL</code>:</p> <p>Info</p> <p>\u7f16\u8bd1\u5668\u7684 <code>Debug</code> \u7f16\u8bd1\u4e0b\u4f1a\u4ea7\u751f\u5f88\u591a\u7528\u4e8e\u8c03\u8bd5\u4ee3\u7801\u7684 <code>IL</code>, \u76f8\u5bf9\u6765\u8bf4\u4f1a\u590d\u6742\u5f88\u591a, \u6240\u4ee5\u6211\u4eec\u4f7f\u7528 <code>Release</code> \u7f16\u8bd1\u6765\u5c3d\u53ef\u80fd\u7b80\u5316</p> <pre><code>.method private hidebysig static \n        int32 Add (\n            int32 a,\n            int32 b,\n            int32 c\n        ) cil managed \n    {\n        .maxstack 8\n\n        IL_0000: ldarg.0\n        IL_0001: ldarg.1\n        IL_0002: add\n        IL_0003: ldarg.2\n        IL_0004: add\n        IL_0005: ret\n    } // end of method Program::Add\n</code></pre> <p>\u8fd9\u91cc\u6211\u4eec\u628a\u4e00\u90e8\u5206\u58f0\u660e\u90e8\u5206\u653e\u51fa\u6765\u4e86, \u4e0d\u8fc7\u6211\u4eec\u53ea\u9700\u8981\u5173\u5fc3\u8fd9\u4e00\u884c: <code>.maxstack 8</code>, \u5b83\u8868\u793a\u8bf7\u6c42\u5728\u8fd9\u4e2a\u65b9\u6cd5\u6267\u884c\u8fc7\u7a0b\u4e2d\u8bc4\u4f30\u6808\u6709\u786e\u4fdd 8 \u4e2a\u5927\u5c0f\u7684\u7a7a\u95f4\u53ef\u4ee5\u4f7f\u7528. \u7528\u56fe\u8868\u7684\u65b9\u6cd5\u5927\u6982\u662f(\u6700\u5de6\u4fa7\u6808\u9ad8\u5ea6\u6700\u4f4e, \u5411\u53f3\u6808\u9ad8\u5ea6\u9010\u6e10\u589e\u52a0, \u7ea2\u8272\u8868\u793a\u76ee\u524d\u4f7f\u7528\u4e86\u7684\u6808\u4f4d, \u4e4b\u540e\u7684\u56fe\u8868\u540c):</p> <p> <pre><code>flowchart LR\n    S1 --- S2 --- S3 --- S4 --- S5 --- S6 --- S7 --- S8\n    style S1 stroke:red</code></pre> </p> <p>\u9996\u5148\u6211\u4eec\u4f1a\u4ecb\u7ecd\u4e00\u4e2a\u7cfb\u5217\u7684\u64cd\u4f5c\u7b26 <code>ldarg.*</code>, \u5b83\u8868\u793a\u5c06\u65b9\u6cd5\u53c2\u6570\u5217\u8868\u4e2d\u7684\u7b2c *-1 \u4e2a\u53c2\u6570\u538b\u5165\u8bc4\u4f30\u6808\u4e2d, \u4e0d\u5e26\u53c2\u6570(<code>ldarg.0</code> \u4e0e <code>ldarg.1</code> \u91cc\u7684\u6570\u5b57\u662f\u64cd\u4f5c\u7b26\u672c\u8eab, \u4e0d\u8981\u8ba4\u4e3a\u5b83\u662f\u4e00\u4e2a\u53c2\u6570\u4e86),  \u6ce8\u610f\u8fd9\u662f\u5728\u9759\u6001\u65b9\u6cd5\u4e2d\u800c\u8a00\u7684, \u5982\u679c\u8be5\u65b9\u6cd5\u662f\u6210\u5458\u65b9\u6cd5, \u90a3\u4e48 <code>ldarg.0</code> \u5b9e\u9645\u4e0a\u538b\u5165\u7684\u662f <code>this</code> \u7684\u503c, \u800c <code>ldarg.1</code> \u624d\u662f\u7b2c\u4e00\u4e2a\u53c2\u6570.  </p> <p>\u5728\u4e0a\u8ff0\u6bb5 <code>IL</code> \u4e2d, \u8be5\u65b9\u6cd5\u662f\u4e2a\u9759\u6001\u65b9\u6cd5, \u6240\u4ee5\u524d\u4e24\u884c <code>ldarg.0</code> \u4e0e <code>ldarg.1</code> \u4f1a\u5c06\u7b2c\u4e00\u4e2a\u53c2\u6570\u548c\u7b2c\u4e8c\u4e2a\u53c2\u6570\u538b\u5165\u8bc4\u4f30\u6808\u4e2d. \u73b0\u5728\u5047\u8bbe\u6211\u4eec\u8c03\u7528\u4f20\u5165\u7684\u53c2\u6570\u5206\u522b\u662f <code>1, 2, 3</code>(Sn\u8868\u793a\u672a\u4f7f\u7528\u7684\u6808\u4f4d, a:b \u8868\u793a\u8be5\u4f4d\u7f6e\u5b58\u5165\u4e86\u4e00\u4e2aa\u7c7b\u578b\u7684b\u503c, \u540e\u540c):</p> <p> <pre><code>flowchart \n    subgraph start\n    direction LR\n    S1_3[\"S1\"] --- S2_3[\"S2\"] --- S3_3[\"S3\"] --- S4_3[\"S4\"]\n    end\n\n    subgraph ldarg.0\n    direction LR\n    S1[\"int32: 1\"] --- S2 --- S3 --- S4\n    style S1 stroke:red\n    end\n\n    subgraph ldarg.1\n    direction LR\n    S1_2[\"int32: 1\"] --- S2_2[\"int32: 2\"] --- S3_2[\"S3\"] --- S4_2[\"S4\"]\n    style S1_2 stroke:red\n    style S2_2 stroke:red\n    end\n\n    start --&gt; ldarg.0 --&gt; ldarg.1</code></pre> </p> <p>\u7136\u540e\u8981\u4ecb\u7ecd\u7684\u662f <code>add</code> \u64cd\u4f5c\u7b26, <code>add</code> \u64cd\u4f5c\u7b26\u4f1a\u5f39\u51fa\u8bc4\u4f30\u6808\u4e0a\u7684\u4e24\u4e2a\u5143\u7d20, \u7136\u540e\u5c06\u5b83\u4eec\u76f8\u52a0, \u7136\u540e\u5c06\u7ed3\u679c\u538b\u5165\u8bc4\u4f30\u6808. \u5f53\u8fd9\u4e24\u4e2a\u5143\u7d20\u4efb\u610f\u4e00\u4e2a\u4e0d\u662f\u57fa\u672c\u6570\u5b57\u7c7b\u578b\u65f6 jit \u5c31\u4f1a\u629b\u51fa <code>InvalidProgramException</code> \u5f02\u5e38. \u540c\u65f6\u6ce8\u610f\u4e00\u4e2a\u7ec6\u8282, \u4f60\u4e3a\u7c7b\u91cd\u8f7d\u7684\u52a0\u53f7\u8fd0\u7b97\u7b26\u5e76\u4e0d\u662f\u4f7f\u7528\u7684\u8fd9\u4e2a\u64cd\u4f5c\u7b26, \u800c\u662f\u8c03\u7528\u7684\u4e00\u4e2a\u7279\u6b8a\u7684\u540d\u4e3a <code>op_Add</code> \u7684\u5e26\u6709 <code>special name</code> \u6807\u8bb0\u7684\u65b9\u6cd5. \u6700\u540e\u662f <code>ret</code> \u64cd\u4f5c\u7b26, \u5f53\u65b9\u6cd5\u6ca1\u6709\u8fd4\u56de\u503c\u65f6\u5b83\u4f1a\u5c06\u63a7\u5236\u6743\u4ea4\u56de\u7ed9\u8c03\u7528\u8005, \u540c\u65f6 jit \u4f1a\u4e3a\u6211\u4eec\u68c0\u67e5\u8bc4\u4f30\u6808\u662f\u5426\u6e05\u7a7a, \u5982\u679c\u8bc4\u4f30\u6808\u4e0a\u8fd8\u6709\u4e1c\u897f\u90a3\u4e48\u540c\u6837 jit \u4f1a\u629b\u51fa\u5f02\u5e38. \u5f53\u65b9\u6cd5\u62e5\u6709\u8fd4\u56de\u503c\u65f6\u5b83\u4f1a\u786e\u4fdd\u8bc4\u4f30\u6808\u4e0a\u6709\u4e14\u53ea\u5269\u4e00\u4e2a\u5143\u7d20, \u7136\u540e\u5c06\u8fd9\u4e2a\u503c\u5f39\u51fa\u5e76\u538b\u5165\u8c03\u7528\u8005\u7684\u8bc4\u4f30\u6808\u4e0a(\u8bc4\u4f30\u6808\u662f\u65b9\u6cd5\u72ec\u7acb\u5730). \u90a3\u4e48\u81ea\u7136\u800c\u7136, \u6211\u4eec\u6700\u521d\u7684\u90a3 6 \u53e5 <code>IL</code> \u5927\u6982\u4f1a\u662f\u8fd9\u4e2a\u5de5\u4f5c\u6d41\u7a0b:</p> <p> <pre><code>flowchart \n    subgraph start\n    direction LR\n    S1 --- S2 --- S3 --- S4\n    end\n\n    subgraph ldarg.0\n    direction LR\n    S1_2[\"int32: 1\"] --- S2_2[\"S2\"] --- S3_2[\"S3\"] --- S4_2[\"S4\"]\n    style S1_2 stroke:red\n    end\n\n    subgraph ldarg.1\n    direction LR\n    S1_3[\"int32: 1\"] --- S2_3[\"int32: 2\"] --- S3_3[\"S3\"] --- S4_3[\"S4\"]\n    style S1_3 stroke:red\n    style S2_3 stroke:red\n    end\n\n    subgraph add\n    direction LR\n    S1_4[\"int32: 3\"] --- S2_4[\"S2\"] --- S3_4[\"S3\"] --- S4_4[\"S4\"]\n    style S1_4 stroke:red\n    end\n\n    subgraph ldarg.2\n    direction LR\n    S1_5[\"int32: 3\"] --- S2_5[\"int32: 3\"] --- S3_5[\"S3\"] --- S4_5[\"S4\"]\n    style S1_5 stroke:red\n    style S2_5 stroke:red\n    end\n\n    subgraph 2ndadd [\"2nd add\"]\n    direction LR\n    S1_6[\"int32: 6\"] --- S2_6[\"S2\"] --- S3_6[\"S3\"] --- S4_6[\"S4\"]\n    style S1_6 stroke:red\n    end\n\n    start --&gt; ldarg.0 --&gt; ldarg.1 --&gt; add --&gt; ldarg.2 --&gt; 2ndadd --&gt; ret</code></pre> </p> <p><sub>\u8fd9\u56fe\u505a\u5b8c\u540e\u770b\u4e0a\u53bb\u597d\u50cf\u4e0d\u662f\u60f3\u8c61\u4e2d\u7684\u90a3\u4e48\u76f4\u89c2...</sub></p>"},{"location":"trans/il/#il_2","title":"\u4e66\u5199 <code>IL</code>","text":"<p>\u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u4e86\u89e3\u4e86\u4e00\u5c0f\u4e9b <code>IL</code> \u7684\u77e5\u8bc6, \u73b0\u5728\u6211\u4eec\u56de\u5230\u4e4b\u524d\u7684\u5de5\u7a0b\u4e2d, \u66f4\u6539\u4e3a\u4ee5\u4e0b\u4ee3\u7801: <pre><code>using System.Reflection;\nusing System.Reflection.Emit;\n\nnamespace DynamicAssemblyTest;\n\npublic static class Program\n{\n    public static MethodInfo GenerateMethod(Action&lt;ILGenerator&gt; generateAction)\n    {\n        AssemblyBuilder asmBuilder = AssemblyBuilder.DefineDynamicAssembly(new(\"MyAssembly\"), AssemblyBuilderAccess.RunAndCollect);\n        ModuleBuilder moduleBuilder = asmBuilder.DefineDynamicModule(\"MyTestModule\");\n        TypeBuilder typeBuilder = moduleBuilder.DefineType(\"MyType\");\n        MethodBuilder methodBuilder = typeBuilder.DefineMethod(\"MyMethod\", MethodAttributes.Public | MethodAttributes.Static\n            , typeof(int), new Type[] { typeof(int), typeof(int), typeof(int) });\n        generateAction(methodBuilder.GetILGenerator());\n        return typeBuilder.CreateType().GetMethod(\"MyMethod\")!;\n    }\n\n    public static void Main()\n    {\n        MethodInfo methodInfo = GenerateMethod(il =&gt;\n        {\n            il.Emit(OpCodes.Ldarg_0);\n            il.Emit(OpCodes.Ldarg_1);\n            il.Emit(OpCodes.Add);\n            il.Emit(OpCodes.Ldarg_2);\n            il.Emit(OpCodes.Add);\n            il.Emit(OpCodes.Ret);\n        });\n        var func = methodInfo.CreateDelegate&lt;Func&lt;int, int, int, int&gt;&gt;();\n        var result = func(1, 2, 3);\n        Console.WriteLine($\"result is {result}\");\n    }\n}\n</code></pre></p> <p>\u8fd9\u91cc\u6211\u4eec\u5728\u4e0a\u9762\u66f4\u6539\u4e86\u65b9\u6cd5\u7684\u5b9a\u4e49, \u4f7f\u5b83\u53d8\u4e3a\u5e26\u6709 <code>int</code> \u8fd4\u56de\u503c\u4e14\u63a5\u6536 3 \u4e2a\u53c2\u6570\u7684\u65b9\u6cd5, \u7136\u540e\u9002\u5f53\u4fee\u6539\u6211\u4eec\u8c03\u7528\u8fd9\u4e2a\u65b9\u6cd5\u7684\u5730\u65b9, \u7136\u540e\u8fd0\u7528\u6211\u4eec\u521a\u624d\u7684 <code>IL</code> \u77e5\u8bc6\u5b9e\u73b0\u8fd9\u4e2a\u65b9\u6cd5. \u73b0\u5728, \u8fd0\u884c\u5b83, \u4f60\u5e94\u8be5\u4f1a\u5f97\u5230 <code>result is 6</code> \u7684\u8f93\u51fa, \u4f46\u662f\u6211\u4eec\u5168\u7a0b\u90fd\u6ca1\u6709\u5728 <code>C#</code> \u4ee3\u7801\u4e2d\u4f7f\u7528 <code>+</code> \u8fd0\u7b97\u7b26, \u800c\u662f\u76f4\u63a5\u5728 <code>IL</code> \u4e2d\u8c03\u7528 <code>add</code> \u64cd\u4f5c\u7b26, \u4ece\u67d0\u4e9b\u65b9\u9762\u6765\u8bf4\u8fd9\u633a\u6709\u8da3\u7684.</p> <p>\u73b0\u5728, \u8bd5\u7740\u5b8c\u6210\u4e00\u4e2a\u5c0f\u7ec3\u4e60, \u5c06\u4e0a\u9762 <code>GenerateMethod</code> \u65b9\u6cd5\u91cc\u5bf9 <code>MyMethod</code> \u7684\u5b9e\u73b0\u4ece <code>a + b + c</code> \u66f4\u6539\u4e3a <code>a + b * c</code>.</p> \u63d0\u793a\u7b54\u6848 <p>\u4e58\u6cd5\u7684\u64cd\u4f5c\u7b26\u4e3a <code>mul</code>, \u5176\u4f7f\u7528\u65b9\u6cd5\u4e0e <code>add</code> \u4e00\u81f4.</p> \u65b9\u6cd5\u4e00\u65b9\u6cd5\u4e8c\u89e3\u91ca <pre><code>il.Emit(OpCodes.Ldarg_1);\nil.Emit(OpCodes.Ldarg_2);\nil.Emit(OpCodes.Mul);\nil.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Add);\nil.Emit(OpCodes.Ret);\n</code></pre> <pre><code>il.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Ldarg_1);\nil.Emit(OpCodes.Ldarg_2);\nil.Emit(OpCodes.Mul);\nil.Emit(OpCodes.Add);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u5728\u65b9\u6cd5\u4e00\u4e2d\u6211\u4eec\u7684\u601d\u8def\u5f88\u81ea\u7136, \u5148\u538b\u5165\u540e\u4e24\u4e2a\u53c2\u6570\u4f7f\u5176\u76f8\u4e58\u540e\u518d\u4e0e\u7b2c\u4e00\u4e2a\u53c2\u6570\u76f8\u52a0. \u4e5f\u5c31\u662f\u5b9e\u73b0\u7684\u662f <code>(b * c) + a</code>. \u5728\u65b9\u6cd5\u4e8c\u4e2d\u5c31\u9700\u8981\u52a8\u70b9\u8111\u5b50, \u6211\u4eec\u4e00\u6b21\u6027\u5c06\u4e09\u4e2a\u53c2\u6570\u538b\u5165\u4e86\u6808\u4e2d, \u7136\u540e\u6267\u884c\u4e00\u4e2a <code>mul</code> \u64cd\u4f5c, \u5b83\u4f1a\u628a\u6700\u540e\u538b\u5165\u7684\u4e24\u4e2a\u5143\u7d20\u5f39\u51fa\u76f8\u4e58\u540e\u538b\u5165, \u7136\u540e\u6211\u4eec\u9a6c\u4e0a\u518d\u6267\u884c\u4e00\u4e2a <code>add</code> \u64cd\u4f5c, \u5c06\u521a\u521a\u88ab\u538b\u5165\u7684\u5143\u7d20\u4e0e\u6700\u5f00\u59cb\u88ab\u538b\u5165\u7684\u7b2c\u4e00\u4e2a\u53c2\u6570\u76f8\u52a0, \u4e5f\u5c31\u662f\u5b9e\u73b0\u7684\u662f <code>a + (b * c)</code>.</p> <p>\u73b0\u5728\u4f60\u53ef\u4ee5\u8bd5\u7740\u73a9\u4e00\u4e9b\u6709\u8da3\u7684\u4e1c\u897f, \u6bd4\u5982\u8bd5\u7740\u7528 <code>ldarg.3</code> \u538b\u5165\u4e00\u4e2a\u4e0d\u5b58\u5728\u7684\u7b2c\u56db\u4e2a\u53c2\u6570, \u6216\u8005\u5728 <code>ret</code> \u65f6\u8bc4\u4f30\u6808\u4e0a\u6ca1\u6709\u5143\u7d20\u6216\u8005\u6709\u5f88\u591a\u4e2a\u5143\u7d20. \u2003\u2014\u2014\u2014\u2014 \u5b83\u4eec\u90fd\u4f1a\u8ff7\u60d1 jit \u7136\u540e\u4e0d\u77e5\u6240\u63aa\u5730\u6254\u7ed9\u4f60\u4e00\u4e2a <code>InvalidProgramException</code>.</p> <p>\u90a3\u4e48\u518d\u6765\u8bd5\u8bd5 <code>a - b + c</code>:</p> \u63d0\u793a\u7b54\u6848 <p>\u51cf\u6cd5\u7684\u64cd\u4f5c\u7b26\u4e3a <code>sub</code>, \u5b83\u4f1a\u5f39\u51fa\u4e24\u4e2a\u503c, \u5c06\u540e\u5f39\u51fa\u7684\u503c\u51cf\u53bb\u5148\u5f39\u51fa\u7684\u503c\u540e\u5c06\u7ed3\u679c\u538b\u5165\u8bc4\u4f30\u6808.</p> <p><pre><code>il.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Ldarg_1);\nil.Emit(OpCodes.Sub);\nil.Emit(OpCodes.Ldarg_2);\nil.Emit(OpCodes.Add);\nil.Emit(OpCodes.Ret);\n</code></pre> \u4f60\u53ef\u80fd\u5df2\u7ecf\u53d1\u73b0\u7684\u4e00\u4e2a\u6bd4\u8f83\u8212\u670d\u7684\u70b9\u662f, \u76f8\u51cf\u7684\u987a\u5e8f\u521a\u597d\u5c31\u662f\u538b\u5165\u7684\u987a\u5e8f, \u4e5f\u5373\u5f39\u51fa\u7684\u9006\u987a\u5e8f, \u8fd9\u70b9\u4f1a\u8ba9\u6211\u4eec\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\u624b\u5199 <code>IL</code> \u7684\u66f4\u7b26\u5408\u76f4\u89c9\u4e00\u70b9.</p>"},{"location":"trans/il/#_5","title":"\u65b9\u6cd5\u7684\u8c03\u7528","text":"<p>\u73b0\u5728\u6211\u4eec\u7684 <code>IL</code> \u6307\u4ee4\u53ea\u80fd\u505a\u4e9b\u52a0\u52a0\u51cf\u51cf\u662f\u4e0d\u662f\u5f88\u65e0\u804a? \u90a3\u4e48\u73b0\u5728\u6211\u4eec\u6765\u8bd5\u8bd5\u5728 <code>IL</code> \u4e2d\u8c03\u7528\u65b9\u6cd5. \u5728 <code>IL</code> \u4e2d\u6709\u4e09\u79cd\u8c03\u7528\u65b9\u6cd5\u6307\u4ee4:</p> \u64cd\u4f5c\u7b26 \u53c2\u6570 \u63cf\u8ff0 <code>call</code> \u65b9\u6cd5 token \u6839\u636e\u65b9\u6cd5\u7684\u53c2\u6570\u5217\u8868(\u5305\u542b <code>this</code>, \u5982\u679c\u5176\u662f\u6210\u5458\u65b9\u6cd5\u65f6)\u9006\u987a\u5e8f\u5f39\u51fa\u5bf9\u5e94\u6570\u91cf\u53c2\u6570\u5e76\u4ee5\u6b64\u8c03\u7528\u5bf9\u5e94\u65b9\u6cd5 <code>callvirt</code> \u65b9\u6cd5 token \u540c <code>call</code>, \u4f46\u662f\u8be5\u6307\u4ee4\u5728\u5bf9\u5e94\u65b9\u6cd5\u4e3a\u865a\u65b9\u6cd5\u65f6\u4f1a\u5411\u4e0b\u5bfb\u627e\u91cd\u5199\u540e\u7684\u65b9\u6cd5 <code>calli</code> callsite \u63cf\u8ff0 \u6839\u636e callsite \u63cf\u8ff0 \u5f39\u51fa\u5bf9\u5e94\u53c2\u6570\u5e76\u518d\u6b21\u5f39\u51fa\u6240\u9700\u7684\u51fd\u6570\u6307\u9488\u5e76\u8c03\u7528 <p>\u5176\u4e2d\u7528\u7684\u6700\u591a\u7684\u662f <code>call</code> \u548c <code>callvirt</code>, \u6700\u540e\u4e00\u4e2a <code>calli</code> \u5728\u505a\u4e0e\u672c\u673a\u4ea4\u4e92\u65f6\u624d\u5e38\u7528,  \u56e0\u4e3a\u5b83\u8981\u6c42\u6211\u4eec\u6709\u5bf9\u5e94\u7684\u51fd\u6570\u6307\u9488(\u51fd\u6570\u6307\u9488\u53ef\u80fd\u5f88\u591a\u6559\u7a0b\u4e0d\u4f1a\u63d0\u53ca, \u4f60\u53ef\u4ee5\u5728MSDN \u4e0a\u7684\u4e0d\u5b89\u5168\u4ee3\u7801\u3001\u6570\u636e\u6307\u9488\u548c\u51fd\u6570\u6307\u9488\u8fd9\u7bc7\u6587\u7ae0\u4e2d\u4e86\u89e3).  </p> <p><code>call</code> \u4e0e <code>callvirt</code> \u6700\u4e3b\u8981\u7684\u533a\u522b\u662f, <code>call</code> \u6307\u4ee4\u4e00\u65e6\u6307\u5b9a\u4e86\u5bf9\u5e94\u65b9\u6cd5, \u90a3\u4e48\u5728\u8fd0\u884c\u65f6\u8c03\u7528\u7684\u65b9\u6cd5\u662f\u4e0d\u4f1a\u53d8\u7684, \u6240\u4ee5\u5b83\u901a\u5e38\u751f\u6210\u4e8e\u9759\u6001\u65b9\u6cd5\u7684\u8c03\u7528\u4e2d, \u800c <code>callvirt</code> \u5728\u8fd0\u884c\u65f6\u4f1a\u68c0\u6d4b\u76ee\u6807\u7c7b\u578b, \u5e76\u5411\u4e0b\u67e5\u627e\u53ef\u80fd\u7684\u88ab\u91cd\u5199\u540e\u7684\u65b9\u6cd5, \u6240\u4ee5\u6309\u5b57\u9762\u610f\u601d\u5b83\u7ecf\u5e38\u751f\u6210\u4e8e\u865a\u65b9\u6cd5\u7684\u8c03\u7528\u4e2d, \u4e0d\u8fc7\u4e00\u822c\u5bf9\u4e8e\u666e\u901a\u6210\u5458\u65b9\u6cd5\u7684\u8c03\u7528, <code>C#</code> \u7f16\u8bd1\u5668\u4e5f\u4f1a\u751f\u6210 <code>callvirt</code> \u6307\u4ee4, \u8fd9\u662f\u56e0\u4e3a <code>callvirt</code> \u9700\u8981\u68c0\u67e5\u76ee\u6807\u7c7b\u578b, \u5728\u8c03\u7528\u5bf9\u8c61\u4e3a <code>null</code> \u65f6\u5c31\u629b\u51fa <code>NullReferenceException</code>, \u800c <code>call</code> \u6307\u4ee4\u53ef\u80fd\u76f4\u5230\u65b9\u6cd5\u8c03\u7528\u4e00\u534a\u65f6\u624d\u5bdf\u89c9 <code>this</code> \u4e3a <code>null</code>, \u8fd9\u662f\u4e00\u4e2a\u5f88\u5371\u9669\u7684\u884c\u4e3a.</p> <p>\u5728\u6211\u4eec\u5e9f\u8bdd\u5b8c\u4e4b\u540e, \u662f\u65f6\u5019\u505a\u4e00\u70b9\u5b9e\u9645\u7684\u4e86. \u73b0\u5728, \u6211\u4eec\u4e0d\u9700\u8981\u6211\u4eec\u4e4b\u524d\u6d4b\u8bd5 <code>add</code>, <code>ret</code>, <code>mul</code>, <code>sub</code> \u6307\u4ee4\u65f6\u58f0\u660e\u7684\u65b9\u6cd5\u7b7e\u540d\u4e86, \u6240\u4ee5\u6211\u4eec\u66f4\u6539\u5982\u4e0b\u4ee3\u7801, \u4f7f\u5f97\u6211\u4eec\u7684\u52a8\u6001\u65b9\u6cd5 <code>MyMethod</code> \u8fd4\u56de <code>void</code> \u5e76\u4e14\u4e0d\u63a5\u6536\u53c2\u6570: <pre><code>public static MethodInfo GenerateMethod(Action&lt;ILGenerator&gt; generateAction)\n{\n    AssemblyBuilder asmBuilder = AssemblyBuilder.DefineDynamicAssembly(new(\"MyAssembly\"), AssemblyBuilderAccess.RunAndCollect);\n    ModuleBuilder moduleBuilder = asmBuilder.DefineDynamicModule(\"MyTestModule\");\n    TypeBuilder typeBuilder = moduleBuilder.DefineType(\"MyType\");\n    MethodBuilder methodBuilder = typeBuilder.DefineMethod(\"MyMethod\", MethodAttributes.Public | MethodAttributes.Static\n        , typeof(void), Type.EmptyTypes);\n    generateAction(methodBuilder.GetILGenerator());\n    return typeBuilder.CreateType().GetMethod(\"MyMethod\")!;\n}\n</code></pre></p> <p>\u987a\u4fbf\u628a\u4e0b\u9762\u4e5f\u6539\u6210\u8fd9\u6837, \u4ee5\u8d34\u5408\u6211\u4eec\u5728\u4e0a\u9762\u7684\u5b9a\u4e49, \u987a\u4fbf\u6e05\u7a7a\u4e00\u4e0b\u6211\u4eec\u7684\u65b9\u6cd5\u4f53: <pre><code>MethodInfo methodInfo = GenerateMethod(il =&gt;\n{\n    il.Emit(OpCodes.Ret);\n});\nvar action = methodInfo.CreateDelegate&lt;Action&gt;();\naction();\n</code></pre></p> <p>\u73b0\u5728, \u6211\u4eec\u6253\u7b97\u4f7f\u7528 <code>IL</code> \u5199\u4e00\u4e2a HelloWorld \u7a0b\u5e8f, \u90a3\u4e48\u5c31\u9700\u8981\u8c03\u7528 <code>System.Console.WriteLine(string)</code> \u8fd9\u4e2a\u65b9\u6cd5, \u6ce8\u610f\u6b64\u65f6\u6211\u4eec\u5fc5\u987b\u6e05\u695a\u6211\u4eec\u8c03\u7528\u7684\u65b9\u6cd5\u7684\u5177\u4f53\u67d0\u4e2a\u91cd\u8f7d, \u73b0\u5728\u4f7f\u7528\u53cd\u5c04\u77e5\u8bc6, \u83b7\u53d6\u8fd9\u4e2a\u9759\u6001\u65b9\u6cd5\u7684 <code>MethodInfo</code>: <pre><code>var cws = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\n</code></pre></p> <p>\u7136\u540e\u6211\u4eec\u89c2\u5bdf\u5b83\u7684\u53c2\u6570, \u53d1\u73b0\u9700\u8981\u4e00\u4e2a <code>string</code>, \u6240\u4ee5\u6211\u4eec\u5f97\u4f7f\u7528 <code>ldstr</code> <code>IL</code> \u6307\u4ee4, \u5b83\u4f1a\u5c06\u5b83\u53c2\u6570 token \u5bf9\u5e94\u7684\u5b57\u7b26\u4e32\u538b\u5165\u8bc4\u4f30\u6808, \u5728\u8fd9\u91cc\u6211\u4eec\u4e0d\u9700\u8981\u5173\u5fc3\u8fd9\u4e2a token \u5982\u4f55\u751f\u6210, <code>System.Reflection.Emit</code> \u4f1a\u5e2e\u6211\u4eec\u505a\u597d\u8fd9\u4e9b, \u5728\u8fd9\u91cc\u53ea\u9700\u8981\u4f20\u5165 <code>string</code>: <pre><code>il.Emit(OpCodes.Ldstr, \"Hello World in IL!\");\n</code></pre></p> <p>\u4e00\u5207\u5c31\u7eea, \u8c03\u7528\u6211\u4eec\u7684\u65b9\u6cd5:</p> <pre><code>il.Emit(OpCodes.Call, cws);\n</code></pre> <p>\u603b\u7684\u4ee3\u7801\u5982\u4e0b: <pre><code>ar cws = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nil.Emit(OpCodes.Ldstr, \"Hello World in IL!\");\nil.Emit(OpCodes.Call, cws);\nil.Emit(OpCodes.Ret);\n</code></pre></p> <p>\u73b0\u5728, \u8fd0\u884c\u7a0b\u5e8f, \u4f60\u5e94\u8be5\u4f1a\u770b\u5230\u5982\u4e0b\u8f93\u51fa: \u54c7\u4f60\u592a\u5f3a\u4e86\u4f60\u505a\u5230\u4e86\u8fd9\u4e2a\u795e\u4ed9\u64cd\u4f5c\u4f60\u600e\u4e48\u53ef\u4ee5\u8fd9\u4e48\u5f3a\uff01\uff01\uff01\u2003\u5f85\u4f1a\u513f\u6211\u8bf4\u6211\u81ea\u5df1\u5462<pre><code>Hello World in IL!\n</code></pre></p> <p>\u5bf9\u4e8e\u6709\u8fd4\u56de\u503c\u7684\u65b9\u6cd5, <code>call</code> \u8c03\u7528\u5b8c\u540e\u4f1a\u5c06\u8fd4\u56de\u503c\u538b\u5165\u5806\u6808, \u6bd4\u5982\u8981\u5c06\u4ee5\u4e0b <code>C#</code> \u4ee3\u7801\u8f6c\u4e3a <code>IL</code> \u4ee3\u7801: <pre><code>Console.WriteLine(Console.ReadLine());\n</code></pre></p> <p>\u53ea\u9700\u8981\u8fd9\u6837: <pre><code>var cws = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar cr = typeof(Console).GetMethod(\"ReadLine\")!;\nil.Emit(OpCodes.Call, cr);\nil.Emit(OpCodes.Call, cws);\nil.Emit(OpCodes.Ret);\n</code></pre></p> <p>\u5f53\u6211\u4eec\u4e0d\u9700\u8981\u8fd4\u56de\u503c\u65f6, \u6211\u4eec\u5fc5\u987b\u663e\u5f0f\u4f7f\u7528 <code>pop</code> \u6307\u4ee4\u820d\u5f03\u5b83, \u9632\u6b62\u5b83\"\u6c61\u67d3\"\u6211\u4eec\u7684\u8bc4\u4f30\u6808: <pre><code>// \u7b49\u5f85\u7528\u6237\u7684\u4e00\u4e2a\u56de\u8f66\u8f93\u5165\nConsole.ReadLine();\nConsole.WriteLine(\"Hey, I see you pressed the Enter!\");\n</code></pre></p> <pre><code>var cws = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar cr = typeof(Console).GetMethod(\"ReadLine\")!;\nil.Emit(OpCodes.Call, cr);\nil.Emit(OpCodes.Pop);\nil.Emit(OpCodes.Ldstr, \"Hey, I see you pressed the Enter!\");\nil.Emit(OpCodes.Call, cws);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u65b9\u6cd5\u7684\u53c2\u6570\u5217\u8868\u987a\u5e8f\u548c\u538b\u6808\u987a\u5e8f\u4e00\u81f4, \u8c03\u7528\u591a\u53c2\u6570\u65b9\u6cd5\u4e5f\u4f1a\u663e\u5f97\u5f88\u81ea\u7136: <pre><code>double a = Math.Pow(123, 4);\nConsole.WriteLine(a);\n</code></pre></p> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(double) })!;\nvar powMethod = typeof(Math).GetMethod(\"Pow\")!;\nil.Emit(OpCodes.Ldc_R8, 123.0);\nil.Emit(OpCodes.Ldc_R8, 4.0);\nil.Emit(OpCodes.Call, powMethod);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p><code>ldc.r8</code> \u6307\u4ee4\u5c06\u53c2\u6570\u4e2d\u7684 <code>float64</code>, \u5373 <code>double</code> \u5b57\u9762\u91cf\u538b\u5165\u8bc4\u4f30\u6808\u4e2d, \u7c7b\u4f3c\u7684\u64cd\u4f5c\u7b26\u8fd8\u6709 <code>ldc.i4</code>, \u5b83\u5c06\u53c2\u6570\u4e2d\u7684 <code>int32</code> \u5373 <code>int</code> \u5b57\u9762\u91cf\u538b\u5165\u8bc4\u4f30\u6808\u4e2d, \u6ce8\u610f\u5728\u8fd9\u91cc\u4f20\u53c2\u6211\u4eec\u5fc5\u987b\u660e\u786e\u5199\u660e\u53c2\u6570\u7c7b\u578b, \u6bd4\u5982\u4e0a\u9762\u7684 <code>IL</code> \u5982\u679c\u4f7f\u7528 <code>123</code> \u800c\u4e0d\u662f <code>123.0</code> \u4f1a\u53d1\u751f jit \u5f02\u5e38\u6216\u884c\u4e3a\u975e\u671f\u671b, \u56e0\u4e3a\u53c2\u6570\u7c7b\u578b\u4e0d\u5339\u914d, <code>123</code> \u5339\u914d\u5230\u4e86 <code>il.Emit</code> \u7684 <code>int</code> \u91cd\u8f7d, \u800c\u6211\u4eec\u9700\u8981\u7684\u662f <code>double</code> \u91cd\u8f7d, \u6240\u4ee5\u6211\u4eec\u5199\u660e <code>123.0</code> \u6216 <code>123d</code> \u4ee5\u4f7f\u5176\u6210\u4e3a <code>double</code> \u7c7b\u578b\u7684\u5b57\u9762\u91cf. \u5bf9\u4e8e <code>float</code> <code>long</code> <code>double</code> \u7b49\u8fd9\u4e9b\u6709\u5bf9\u5e94\u5b57\u9762\u91cf\u540e\u7f00\u7684(<code>f</code>, <code>l</code>, <code>d</code>) \u7c7b\u578b\u6211\u4eec\u76f4\u63a5\u52a0\u540e\u7f00\u5c31\u884c\u4e86, \u4f46\u5bf9\u4e8e <code>short</code> \u548c <code>byte</code> \u8fd9\u4e9b, \u6211\u4eec\u5fc5\u987b\u8fdb\u884c\u663e\u5f0f\u5f3a\u8f6c:</p> <pre><code>public static void Main()\n{\n    MethodInfo methodInfo = GenerateMethod(il =&gt;\n    {\n        // il \u4e2d\u6ca1\u6709\u5bf9\u5e94\u7684\u52a0\u8f7d `int16` \u548c `int8` \u7684\u6307\u4ee4, \u6211\u4eec\u5f97\u4f7f\u7528 `ldc.i4`, \n        // \u867d\u7136\u5b83\u672c\u6765\u662f\u7528\u6765\u52a0\u8f7d `int32` \u7684, \u4f46 jit \u4f1a\u77e5\u9053\u6211\u4eec\u60f3\u8981\u5e72\u4ec0\u4e48\n        // \u5bf9\u4e8e\u5c0f\u4e00\u70b9\u7684\u6574\u6570\u5b57\u9762\u91cf IL \u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a `ldc.i4.s` \u6307\u4ee4\n        // \u5176\u53c2\u6570\u4e3a `int8` \u5373 `byte` \u6216 `sbyte` \u7c7b\u578b\n        var printByte = typeof(Program).GetMethod(\"PrintByte\")!;\n        il.Emit(OpCodes.Ldc_I4_S, (byte)12);\n        il.Emit(OpCodes.Call, printByte);\n        il.Emit(OpCodes.Ldc_I4, (int)12);\n        il.Emit(OpCodes.Call, printByte);\n        il.Emit(OpCodes.Ret);\n    });\n    var action = methodInfo.CreateDelegate&lt;Action&gt;();\n    action();\n\n}\n\npublic static void PrintByte(byte v)\n{\n    Console.WriteLine($\"Your byte is {v}\");\n}\n</code></pre>"},{"location":"trans/il/#_6","title":"\u5bf9\u8c61\u5b9e\u4f8b\u5316","text":"<p>\u8fd9\u4e00\u6b65\u5f88\u7b80\u5355, \u4e3a\u4e86\u5b9e\u4f8b\u5316\u4e00\u4e2a\u5bf9\u8c61, \u6211\u4eec\u9700\u8981\u4f7f\u7528 <code>newobj</code> \u64cd\u4f5c\u7b26, \u5176\u53c2\u6570\u4e3a\u5bf9\u5e94\u5bf9\u8c61\u7684\u4e00\u4e2a\u6784\u9020\u5668, \u8be5\u6307\u4ee4\u6267\u884c\u540e\u4f1a\u5c06\u6211\u4eec\u8981\u7684\u5bf9\u8c61\u538b\u5165\u8bc4\u4f30\u6808, \u6bd4\u5982\u5982\u4e0b <code>C#</code> \u4ee3\u7801:</p> <pre><code>new StringBuilder();\n</code></pre> <p>\u6211\u4eec\u9700\u8981\u8fd9\u6837\u751f\u6210\u5b83\u7684 <code>IL</code>:</p> <pre><code>var sbctor = typeof(StringBuilder).GetConstructor(Type.EmptyTypes)!;\nil.Emit(OpCodes.Newobj, sbctor);\n</code></pre>"},{"location":"trans/il/#_7","title":"\u6210\u5458\u65b9\u6cd5\u7684\u8c03\u7528","text":"<p>\u73b0\u5728, \u6211\u4eec\u5728\u8bc4\u4f30\u6808\u4e0a\u6709\u4e86\u4e00\u4e2a\u5bf9\u8c61, \u6211\u4eec\u5c31\u53ef\u4ee5\u7528\u5b83\u8c03\u7528\u5b83\u7684\u6210\u5458\u65b9\u6cd5\u4e86. \u6210\u5458\u65b9\u6cd5\u7684\u8c03\u7528\u4e0e\u9759\u6001\u65b9\u6cd5\u8c03\u7528\u57fa\u672c\u4e00\u81f4, \u4f46\u662f\u6bcf\u6b21\u8c03\u7528\u4e4b\u524d\u6211\u4eec\u90fd\u5fc5\u987b\u8bb0\u5f97\u5c06 <code>this</code> \u7684\u503c\u4f5c\u4e3a\u7b2c0\u4e2a\u53c2\u6570\u538b\u5165\u5806\u6808, \u987a\u4fbf, \u8bb0\u4f4f\u8fd9\u91cc\u7684 <code>this</code> \u662f\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u7684, \u6bcf\u6b21\u8c03\u7528\u90fd\u4f1a\u88ab\u5f39\u51fa\u8bc4\u4f30\u6808, \u6240\u4ee5\u5728\u8fde\u7eed\u8c03\u7528\u5b83\u7684\u6210\u5458\u65b9\u6cd5\u65f6\u8bb0\u5f97\u5c06 <code>this</code> \u518d\u6b21\u538b\u5165. \u901a\u5e38\u6211\u4eec\u4f1a\u4f7f\u7528 <code>callvirt</code> \u6765\u8c03\u7528\u6210\u5458\u65b9\u6cd5, \u4e00\u65b9\u9762\u4e3a\u4e86\u786e\u4fdd\u8c03\u7528\u5230\u4e86\u91cd\u5199\u540e\u7684\u865a\u51fd\u6570, \u4e00\u65b9\u9762\u4e3a\u4e86\u5c3d\u53ef\u80fd\u65e9\u7684\u68c0\u6d4b\u51fa <code>this</code> \u4e3a null.</p> <pre><code>Console.WriteLine(new StringBuilder().Append(\"abc\").Append(\"def\").Append(\"ghi\").ToString());\n</code></pre> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar sbctor = typeof(StringBuilder).GetConstructor(Type.EmptyTypes)!;\nvar appendMethod = typeof(StringBuilder).GetMethod(\"Append\", new Type[] { typeof(string) })!;\nvar toStringMethod = typeof(StringBuilder).GetMethod(\"ToString\", Type.EmptyTypes)!;\n// StringBuilder.Append \u65b9\u6cd5\u4f1a\u8fd4\u56de\u81ea\u8eab, \u6240\u4ee5\u8fd9\u91cc\u7684 `this` \u5728\u65b9\u6cd5\u88ab\u8c03\u7528\u540e\u53c8\u88ab\u5f39\u51fa\u53c8\u88ab\u538b\u5165\nil.Emit(OpCodes.Newobj, sbctor);\nil.Emit(OpCodes.Ldstr, \"abc\");\nil.Emit(OpCodes.Callvirt, appendMethod);\nil.Emit(OpCodes.Ldstr, \"def\");\nil.Emit(OpCodes.Callvirt, appendMethod);\nil.Emit(OpCodes.Ldstr, \"ghi\");\nil.Emit(OpCodes.Callvirt, appendMethod);\nil.Emit(OpCodes.Callvirt, toStringMethod);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u4f46\u662f\u5b9e\u9645\u4e0a, \u6211\u4eec\u660e\u786e\u77e5\u9053 <code>StringBuilder</code> \u662f\u5bc6\u5c01\u7684, \u6ca1\u4eba\u4f1a\u91cd\u5199\u5b83\u7684\u865a\u65b9\u6cd5, \u4ee5\u53ca\u8fd9\u91cc\u6211\u4eec\u660e\u786e\u77e5\u9053\u8fd9\u91cc\u7684 <code>this</code> \u4e0d\u4e3a null, \u6240\u4ee5\u5b9e\u9645\u4e0a\u4e0a\u9762\u7684 <code>callvirt</code> \u90fd\u80fd\u6362\u6210 <code>call</code>:</p> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar sbctor = typeof(StringBuilder).GetConstructor(Type.EmptyTypes)!;\nvar appendMethod = typeof(StringBuilder).GetMethod(\"Append\", new Type[] { typeof(string) })!;\nvar toStringMethod = typeof(StringBuilder).GetMethod(\"ToString\", Type.EmptyTypes)!;\n// StringBuilder.Append \u65b9\u6cd5\u4f1a\u8fd4\u56de\u81ea\u8eab, \u6240\u4ee5\u8fd9\u91cc\u7684 `this` \u5728\u65b9\u6cd5\u88ab\u8c03\u7528\u540e\u53c8\u88ab\u5f39\u51fa\u53c8\u88ab\u538b\u5165\nil.Emit(OpCodes.Newobj, sbctor);\nil.Emit(OpCodes.Ldstr, \"abc\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Ldstr, \"def\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Ldstr, \"ghi\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Call, toStringMethod);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre>"},{"location":"trans/il/#_8","title":"\u5c40\u90e8\u53d8\u91cf","text":"<p>\u4e5f\u8bb8\u4f60\u4e5f\u53d1\u73b0\u4e86, \u6211\u4eec\u4e0a\u9762\u7684\u4ee3\u7801\u90fd\u6709\u4e9b\"\u618b\u5c48\", \u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u5728\u4e0a\u9762\u7684\u4ee3\u7801\u4e2d\u6ca1\u6709\u7528\u5230\u5c40\u90e8\u53d8\u91cf. \u5728 <code>System.Reflection.Emit</code> \u4e2d, \u6211\u4eec\u5fc5\u987b\u663e\u5f0f\u6307\u5b9a\u6211\u4eec\u53ef\u80fd\u7528\u5230\u51e0\u4e2a\u5c40\u90e8\u53d8\u91cf\u4ee5\u53ca\u5bf9\u5e94\u7684\u7c7b\u578b, \u6bd4\u5982\u5982\u4e0b C# \u4ee3\u7801: <pre><code>StringBuilder sb = new();\nsb.Append(\"abc\");\nsb.Append(\"def\");\nsb.Append(\"ghi\");\nstring str = sb.ToString();\nConsole.WriteLine(str);\n</code></pre></p> <p>\u6211\u4eec\u8fdb\u884c\u5206\u6790, \u53d1\u73b0\u5b83\u4f7f\u7528\u4e86\u4e24\u4e2a\u5c40\u90e8\u53d8\u91cf: <code>sb</code> \u548c <code>str</code>, \u6240\u4ee5\u6211\u4eec\u5728\u8c03\u7528 <code>il.Emit</code> \u4e4b\u524d\u8c03\u7528 <code>il.DeclareLocal</code>:</p> <pre><code>il.DeclareLocal(typeof(StringBuilder)); // 0\nil.DeclareLocal(typeof(string)); // 1\n</code></pre> <p>\u6ce8\u610f\u6211\u4eec\u8c03\u7528 <code>DeclareLocal</code> \u7684\u987a\u5e8f, \u8fd9\u4e2a\u987a\u5e8f\u6211\u4eec\u5728\u4e0b\u9762\u7684 <code>IL</code> \u4e2d\u5c31\u4f1a\u4f7f\u7528\u5b83:</p> \u54e6\u5929\u54ea\u5b83\u771f\u7684\u592a\u957f\u4e86<pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar sbctor = typeof(StringBuilder).GetConstructor(Type.EmptyTypes)!;\nvar appendMethod = typeof(StringBuilder).GetMethod(\"Append\", new Type[] { typeof(string) })!;\nvar toStringMethod = typeof(StringBuilder).GetMethod(\"ToString\", Type.EmptyTypes)!;\n\nil.DeclareLocal(typeof(StringBuilder)); // 0\nil.DeclareLocal(typeof(string)); // 1\n\nil.Emit(OpCodes.Newobj, sbctor);\n// \u5c06\u6211\u4eec\u7684 StringBuilder \u5bf9\u8c61\u5b58\u5230 0 \u53f7\u4f4d\u7684\u5c40\u90e8\u53d8\u91cf\u4e0a\nil.Emit(OpCodes.Stloc_0); \n// \u628a\u6211\u4eec\u4e4b\u524d\u5728 0 \u53f7\u4f4d\u5c40\u90e8\u53d8\u91cf\u4e0a\u5b58\u7684 StringBuilder \u5bf9\u8c61\u8bfb\u53d6\u51fa\u6765\u5e76\u538b\u5165\u8bc4\u4f30\u6808\u4e0a\nil.Emit(OpCodes.Ldloc_0); \n// \u51c6\u5907 StringBuilder.Append \u7684\u90a3\u4e2a\u53c2\u6570\u4f5c\u4e3a\u5176\u5185\u90e8 ldarg.1 \u4f1a\u8bfb\u53d6\u7684\u503c(ldarg.0 \u662f this)\nil.Emit(OpCodes.Ldstr, \"abc\");\nil.Emit(OpCodes.Call, appendMethod);\n// \u6211\u4eec\u5728\u8fd9\u91cc\u4e0d\u4f1a\u4f7f\u7528 StringBuilder.Append \u7684\u90a3\u4e2a\u7528\u4e8e\u94fe\u5f0f\u8c03\u7528\u7684\u8fd4\u56de\u503c\n// \u6240\u4ee5\u6211\u4eec\u4f7f\u7528 `pop` \u5f39\u51fa\u5b83\u907f\u514d\"\u6c61\u67d3\"\u6211\u4eec\u7684\u8bc4\u4f30\u6808.\nil.Emit(OpCodes.Pop);\nil.Emit(OpCodes.Ldloc_0);\nil.Emit(OpCodes.Ldstr, \"def\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\nil.Emit(OpCodes.Ldloc_0);\nil.Emit(OpCodes.Ldstr, \"ghi\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\nil.Emit(OpCodes.Ldloc_0);\nil.Emit(OpCodes.Call, toStringMethod);\nil.Emit(OpCodes.Stloc_1);\nil.Emit(OpCodes.Ldloc_1);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u5728\u4e0a\u9762\u7684 <code>IL</code> \u4e2d, <code>stloc.0</code> \u5c06\u6808\u9876\u7684\u503c\u5f39\u51fa\u5e76\u5b58\u5230\u5c40\u90e8\u53d8\u91cf 0 \u53f7\u4f4d\u4e0a, <code>ldloc.0</code> \u8bfb\u53d6\u5c40\u90e8\u53d8\u91cf 0 \u53f7\u4f4d\u7684\u503c\u7136\u540e\u5c06\u5176\u538b\u5165\u8bc4\u4f30\u6808\u4e0a. \u4e0d\u8fc7\u5b9e\u9645\u4e0a\u8fd9\u91cc\u7528\u4e0d\u7740\u5c40\u90e8\u53d8\u91cf, \u9664\u4e86\u4f7f\u7528 <code>Append</code> \u8fd4\u56de\u7684 <code>this</code> \u4e4b\u5916, \u6211\u4eec\u8fd8\u53ef\u4ee5\u4f7f\u7528 <code>dup</code> \u6307\u4ee4\u6765\u7b80\u5316\u5927\u91cf\u7684 <code>ldloc.0</code> \u64cd\u4f5c. \u9664\u6b64\u4e4b\u5916 <code>string</code> \u90a3\u4e2a\u5c40\u90e8\u53d8\u91cf\u4e5f\u7528\u4e0d\u7740, \u6211\u4eec\u5728 <code>ToString</code> \u540e\u76f4\u63a5\u8c03\u7528 <code>Console.WriteLine</code> \u5373\u53ef, \u56e0\u4e3a\u8fd9\u65f6\u7684 <code>string</code> \u521a\u597d\u5c31\u5728\u6808\u9876.</p> <pre><code>il.Emit(OpCodes.Newobj, sbctor);\n\nil.Emit(OpCodes.Dup);\nil.Emit(OpCodes.Ldstr, \"abc\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\n\nil.Emit(OpCodes.Dup);\nil.Emit(OpCodes.Ldstr, \"def\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\n\nil.Emit(OpCodes.Dup);\nil.Emit(OpCodes.Ldstr, \"ghi\");\nil.Emit(OpCodes.Call, appendMethod);\nil.Emit(OpCodes.Pop);\n\nil.Emit(OpCodes.Dup);\nil.Emit(OpCodes.Call, toStringMethod);\nil.Emit(OpCodes.Call, cw);\n\n// \u8bb0\u5f97\u5f39\u51fa\u6700\u521d newobj \u6307\u4ee4\u538b\u5165\u7684\u90a3\u4e2a\u5143\u7d20, \u5426\u5219\u6b64\u65f6 ret \u6808\u5c31\u4e0d\u662f\u7a7a\u7684\u4e86\n// \u8fd9\u4f1a\u5bfc\u81f4 jit \u629b\u51fa InvalidProgramException\nil.Emit(OpCodes.Pop);\n\nil.Emit(OpCodes.Ret);\n</code></pre> <p><code>dup</code> \u6307\u4ee4\u5f39\u51fa\u6808\u9876\u7684\u5143\u7d20, \u7136\u540e\u538b\u5165\u4e24\u904d\u8fd9\u4e2a\u5143\u7d20, \u4e5f\u5c31\u662f\u5b83\u4f1a\u590d\u5236\u6808\u9876\u7684\u5143\u7d20\u4e00\u904d\u5e76\u538b\u5165, \u5728\u8fd9\u91cc,  \u6211\u4eec\u4f7f\u7528 <code>dup</code> \u6307\u4ee4\u5728\u6bcf\u6b21\u9700\u8981 <code>this</code> \u5bf9\u8c61\u65f6\u590d\u5236\u6700\u521d <code>newobj</code> \u6307\u4ee4\u538b\u5165\u7684\u5143\u7d20, \u8fd9\u6837\u5c31\u65e0\u9700\u4f7f\u7528\u5c40\u90e8\u53d8\u91cf\u800c\u590d\u6742\u5316\u6211\u4eec\u7684 <code>IL</code> \u4e86.</p>"},{"location":"trans/il/#_9","title":"\u5c5e\u6027\u7684\u8bbf\u95ee","text":"<p>\u5728 <code>IL</code> \u4e2d, \u5176\u5b9e\u6ca1\u6709\u4e00\u6761\u6307\u4ee4\u662f\u5173\u4e8e\u5c5e\u6027\u7684, \u56e0\u4e3a\u6211\u4eec\u77e5\u9053\u5c5e\u6027\u5b9e\u9645\u4e0a\u5c31\u662f\u4e00\u5bf9 getter \u548c setter \u800c\u5df2. \u901a\u5e38, \u4e00\u4e2a\u540d\u4e3a <code>MyProp</code> \u7684\u5c5e\u6027\u7684 getter \u65b9\u6cd5\u53eb\u505a <code>get_MyProp</code>, setter \u65b9\u6cd5\u53eb\u505a <code>set_MyProp</code>, \u5982\u679c\u4f60\u5728 C# \u4e2d\u5c1d\u8bd5\u7ed9\u65b9\u6cd5\u8fd9\u6837\u8d77\u540d\u4f60\u4f1a\u53d1\u73b0\u7f16\u8bd1\u5668\u4f1a\u4e3a\u4e86\u9632\u6b62\u65b9\u6cd5\u91cd\u540d\u800c\u62a5\u9519, \u987a\u4fbf, \u8fd9\u4e00\u5bf9\u65b9\u6cd5\u5b83\u4eec\u5404\u81ea\u90fd\u6709\u4e00\u4e2a <code>special name</code> \u7684\u7279\u6b8a\u6807\u8bb0\u4ee5\u4fbf\u7f16\u8bd1\u5668\u77e5\u6653\u5b83\u4eec\u5f52\u5c5e\u4e8e\u4e00\u4e2a\u5c5e\u6027.  </p> <p>\u6bd4\u5982\u5982\u4e0b <code>C#</code> \u4ee3\u7801:</p> <pre><code>Console.WriteLine(\"123\".Length);\n</code></pre> <pre><code>var cwInt = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(int) })!;\nvar stringGetLength = typeof(string).GetMethod(\"get_Length\")!;\nil.Emit(OpCodes.Ldstr, \"123\");\nil.Emit(OpCodes.Call, stringGetLength);\nil.Emit(OpCodes.Call, cwInt);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u5728\u8fd9\u91cc\u6211\u4eec\u8c03\u7528\u7684\u5c31\u662f <code>string</code> \u7684 <code>get_Length</code> \u65b9\u6cd5. \u5c31\u662f\u8fd9\u4e48\u7b80\u5355.</p>"},{"location":"trans/il/#_10","title":"\u5b57\u6bb5\u7684\u8bbf\u95ee","text":"<p>\u5bf9\u4e8e\u9759\u6001\u5b57\u6bb5\u7684\u8bbf\u95ee, \u6211\u4eec\u9700\u8981\u4f7f\u7528 <code>ldsfld</code> \u64cd\u4f5c\u7b26, \u6bd4\u5982 <code>Path.DirectorySeparatorChar</code> \u8fd9\u4e2a\u9759\u6001\u5b57\u6bb5: <pre><code>Console.WriteLine(Path.DirectorySeparatorChar);\n</code></pre></p> <pre><code>// \u6ce8\u610f\u4e0b\u8fd9\u91cc WriteLine \u7684\u91cd\u8f7d\u6362\u4e86, \u56e0\u4e3a Path.DirectorySeparatorChar \u662f char \u7c7b\u578b\u7684\nvar cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(char) })!;\nvar pathStfld = typeof(Path).GetField(\"DirectorySeparatorChar\")!;\nil.Emit(OpCodes.Ldsfld, pathStfld);\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p><code>ldsfld</code> \u4f1a\u5c06\u53c2\u6570\u4e2d\u7684\u9759\u6001\u5b57\u6bb5\u7684 token \u5bf9\u5e94\u7684\u9759\u6001\u5b57\u6bb5\u7684\u503c\u538b\u5165\u8bc4\u4f30\u6808\u4e0a.</p> <p>\u5bf9\u4e8e\u6210\u5458\u5b57\u6bb5\u7684\u8bbf\u95ee\u4e5f\u662f\u7c7b\u4f3c\u7684, \u4e0d\u8fc7\u5b83\u4f1a\u9700\u8981\u5f39\u51fa\u4e00\u4e2a <code>this</code> \u5143\u7d20, \u6bd4\u5982\u5bf9\u4e8e\u5982\u4e0b C# \u7c7b:  </p> <p><sub>\u5176\u5b9e\u662f\u627e\u4e0d\u5230\u00a0bcl\u00a0\u91cc\u7ecf\u5e38\u8bbf\u95ee\u6210\u5458\u5b57\u6bb5\u7684\u4f8b\u5b50\u624d\u88ab\u8feb\u58f0\u660e\u65b0\u7c7b\u7684</sub></p> <pre><code>public class SomeClass\n{\n    public string SomeString;\n    public SomeClass()\n        =&gt; SomeString = \"\u8fd9\u91cc\u662f\u4e00\u4e2a\u5b57\u7b26\u4e32!\";\n}\n</code></pre> <pre><code>var someClassCtor = typeof(SomeClass).GetConstructor(Type.EmptyTypes)!;\nvar cwString = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar someClassFld = typeof(SomeClass).GetField(\"SomeString\")!;\nil.Emit(OpCodes.Newobj, someClassCtor);\nil.Emit(OpCodes.Ldfld, someClassFld);\nil.Emit(OpCodes.Call, cwString);\nil.Emit(OpCodes.Ret);\n</code></pre>"},{"location":"trans/il/#_11","title":"\u8df3\u8f6c\u6307\u4ee4","text":"<p>\u5728\u8fd9\u91cc\u6211\u4eec\u4f1a\u4ecb\u7ecd\u8fd9\u4e00\u8282\u7684\u6700\u540e\u4e00\u4e2a\u4e1c\u897f \u2014\u2014 \u8df3\u8f6c\u6307\u4ee4. \u5b83\u662f C# \u4e2d <code>if</code> <code>switch</code> <code>for</code> <code>while</code> <code>goto</code> \u7b49\u6d41\u7a0b\u63a7\u5236\u8bed\u53e5\u90fd\u5341\u5206\u4f9d\u8d56\u7684\u4e1c\u897f.  </p> <p>\u5728 <code>IL</code> \u4e2d, \u4e3a\u4e86\u65b9\u4fbf \u5927\u4e8e, \u5c0f\u4e8e, \u5927\u4e8e\u7b49\u4e8e, \u5c0f\u4e8e\u7b49\u4e8e, \u662f\u5426 null, \u662f\u5426\u975e0 \u7b49\u4f17\u591a\u6761\u4ef6\u8868\u8fbe\u5f0f\u7684\u5224\u65ad, <code>IL</code> \u5f15\u5165\u4e86\u5927\u91cf\u6709\u5173\u7684\u6307\u4ee4, \u5177\u4f53\u5982\u4e0b\u8868(\u6458\u81ea MSDN):</p> \u6307\u4ee4 \u63cf\u8ff0 beq\u00a0\u00a0\u00a0 \u5982\u679c\u4e24\u4e2a\u503c\u76f8\u7b49\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 beq.s\u00a0\u00a0 \u5982\u679c\u4e24\u4e2a\u503c\u76f8\u7b49\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bge\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bge.s\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bge.un\u00a0\u00a0\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bge.un.s\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bgt\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bgt.s\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bgt.un\u00a0\u00a0\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bgt.un.s\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5927\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 ble\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 ble.s\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 ble.un\u00a0\u00a0\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 ble.un.s\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u6216\u7b49\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u6743\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 blt\u00a0\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 blt.s\u00a0\u00a0\u00a0 \u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 blt.un\u00a0\u00a0\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 blt.un.s\u00a0 \u5f53\u6bd4\u8f83\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u65f6\uff0c\u5982\u679c\u7b2c\u4e00\u4e2a\u503c\u5c0f\u4e8e\u7b2c\u4e8c\u4e2a\u503c\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 bne.un\u00a0\u00a0\u00a0 \u5f53\u4e24\u4e2a\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u4e0d\u76f8\u7b49\u65f6\uff0c\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 bne.un.s\u00a0 \u5f53\u4e24\u4e2a\u65e0\u7b26\u53f7\u6574\u6570\u503c\u6216\u4e0d\u53ef\u6392\u5e8f\u7684\u6d6e\u70b9\u578b\u503c\u4e0d\u76f8\u7b49\u65f6\uff0c\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 br\u00a0\u00a0\u00a0\u00a0 \u65e0\u6761\u4ef6\u5730\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 br.s\u00a0\u00a0\u00a0\u00a0 \u65e0\u6761\u4ef6\u5730\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 brfalse\u00a0\u00a0 \u5982\u679c value \u4e3a false\u3001\u7a7a\u5f15\u7528\uff08Visual Basic \u4e2d\u7684 Nothing\uff09\u6216\u96f6\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 brfalse.s \u5982\u679c value \u4e3a false\u3001\u7a7a\u5f15\u7528\u6216\u96f6\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 brtrue\u00a0\u00a0\u00a0 \u5982\u679c value \u4e3a true\u3001\u975e\u7a7a\u6216\u975e\u96f6\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\u3002 brtrue.s\u00a0 \u5982\u679c value \u4e3a true\u3001\u975e\u7a7a\u6216\u975e\u96f6\uff0c\u5219\u5c06\u63a7\u5236\u8f6c\u79fb\u5230\u76ee\u6807\u6307\u4ee4\uff08\u77ed\u683c\u5f0f\uff09\u3002 <p>\u53ef\u4ee5\u53d1\u73b0, \u57fa\u672c\u90fd\u662f\u5404\u79cd\u5927\u4e8e\u5c0f\u4e8e\u7b49\u4e8e\u975e\u7a7a\u975e0\u7b49\u4ee5\u53ca\u6709\u7b26\u53f7\u65e0\u7b26\u53f7\u8fd9\u4e9b\u60c5\u51b5\u7684\u6392\u5217\u7ec4\u5408. \u4e0a\u8868\u4e2d\u6211\u4eec\u79f0\u9664\u4e86 <code>br</code> \u4e0e <code>br.s</code> \u6307\u4ee4\u5916\u7684\u6307\u4ee4\u4e3a \"\u6761\u4ef6\u8df3\u8f6c\u6307\u4ee4\", \u53cd\u4e4b\u6211\u4eec\u79f0\u4e3a \"\u65e0\u6761\u4ef6\u8df3\u8f6c\u6307\u4ee4\". \u8fd9\u91cc\u6211\u4eec\u53ea\u4f1a\u7b80\u5355\u4e3e\u4f8b <code>br</code> <code>brfalse</code> \u8fd9\u4e24\u4e2a\u6307\u4ee4\u7684\u4f7f\u7528. \u5176\u4ed6\u6307\u4ee4\u57fa\u672c\u53ea\u662f\u51e0\u4e2a\u6761\u4ef6\u4e0d\u540c\u7c7b\u578b\u4e0d\u540c\u7684\u5dee\u522b.</p> <p><code>brfalse</code> \u6307\u4ee4\u4f1a\u4ece\u8bc4\u4f30\u6808\u4e0a\u5f39\u51fa\u4e00\u4e2a\u503c, \u7136\u540e\u67e5\u770b\u8be5\u503c\u662f\u5426\u4e3a <code>false</code> \u6216\u8005 <code>null</code> \u6216\u8005 <code>0</code>, \u5982\u679c\u662f\u5219\u8df3\u8f6c\u5230\u53c2\u6570\u6240\u6307\u7684\u76ee\u6807\u4f4d\u7f6e, \u5426\u5219\u4e0d\u505a\u4efb\u4f55\u4e8b. \u6bd4\u5982\u5982\u4e0b C# \u4ee3\u7801:</p> <pre><code>public static void MyMethod(int value)\n{\n    if (value == 0)\n    {\n        Console.WriteLine(\"value is 0!\");\n    }\n    else\n    {\n        Console.WriteLine(\"value is not 0.\");\n    }\n}\n</code></pre> <p>\u987a\u4fbf\u8bb0\u5f97\u66f4\u6539\u6211\u4eec\u7684\u65b9\u6cd5\u5b9a\u4e49:</p> <pre><code>public static MethodInfo GenerateMethod(Action&lt;ILGenerator&gt; generateAction)\n{\n    AssemblyBuilder asmBuilder = AssemblyBuilder.DefineDynamicAssembly(new(\"MyAssembly\"), AssemblyBuilderAccess.RunAndCollect);\n    ModuleBuilder moduleBuilder = asmBuilder.DefineDynamicModule(\"MyTestModule\");\n    TypeBuilder typeBuilder = moduleBuilder.DefineType(\"MyType\");\n    MethodBuilder methodBuilder = typeBuilder.DefineMethod(\"MyMethod\", MethodAttributes.Public | MethodAttributes.Static\n        , typeof(void), new Type[] { typeof(int) });\n    generateAction(methodBuilder.GetILGenerator());\n    return typeBuilder.CreateType().GetMethod(\"MyMethod\")!;\n}\n\npublic static void Main()\n{\n    MethodInfo methodInfo = GenerateMethod(il =&gt;\n    {\n        // TODO implement the IL body\n    });\n    var action = methodInfo.CreateDelegate&lt;Action&lt;int&gt;&gt;();\n    action(1);\n}\n</code></pre> <p>\u5176\u5bf9\u5e94 <code>IL</code> \u4e3a:</p> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar valueIs0Target = il.DefineLabel();\nil.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Brfalse, valueIs0Target);\nil.Emit(OpCodes.Ldstr, \"value is not 0.\");\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\nil.MarkLabel(valueIs0Target);\nil.Emit(OpCodes.Ldstr, \"value is 0!\");\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre> <p>\u5728\u8fd9\u91cc, \u5728\u4f7f\u7528 <code>System.Reflection.Emit</code> \u5e93\u7684\u60c5\u51b5\u4e0b, \u6211\u4eec\u5728\u4ee3\u7801\u7684\u7b2c 2 \u884c\u5b9a\u4e49\u4e86\u4e00\u4e2a Label, \u7528\u6765\u4e4b\u540e\u4f5c\u4e3a\u6761\u4ef6\u8df3\u8f6c\u6307\u4ee4\u7684\u53c2\u6570\u4f20\u5165, \u4e0d\u8fc7\u76ee\u524d\u8fd9\u4e2a Label \u6ca1\u6709\u6307\u5411\u4efb\u4f55 <code>IL</code> \u6307\u4ee4\u4f4d\u7f6e, \u6240\u4ee5\u6211\u4eec\u5728\u7b2c 8 \u884c\u8c03\u7528 <code>MarkLabel</code> \u65b9\u6cd5, \u8c03\u7528\u5b8c\u8be5\u65b9\u6cd5\u540e\u7684\u4e0b\u4e00\u6b21 <code>Emit</code> \u7684 <code>IL</code> \u6307\u4ee4\u7684\u4f4d\u7f6e\u4fe1\u606f\u5c31\u4f1a\u88ab\u8bbe\u7f6e\u5230 Label \u4e2d, \u89c2\u5bdf\u4e0a\u8ff0\u4ee3\u7801\u4e0d\u96be\u53d1\u73b0, \u6211\u4eec\u8bfb\u53d6\u7684\u7b2c\u4e00\u4e2a\u53c2\u6570, \u5982\u679c\u4e3a 0 \u90a3\u4e48\u8df3\u8f6c\u5230\u8f93\u51fa <code>value is 0!</code> \u7684 <code>IL</code> \u6307\u4ee4\u6bb5\u524d, \u800c\u5f53\u975e 0 \u65f6\u4e0d\u505a\u4efb\u4f55\u4e8b\u8ba9\u5176\u81ea\u7136\u6267\u884c\u5230\u8f93\u51fa <code>value is not 0.</code> \u7684 <code>IL</code> \u6307\u4ee4\u6bb5\u524d, \u4f60\u53ef\u4ee5\u66f4\u6539\u8c03\u7528\u8fd9\u4e2a\u65b9\u6cd5\u7684\u4ee3\u7801\u7684\u5730\u65b9\u4f20\u5165\u7684\u53c2\u6570\u6765\u89c2\u5bdf\u5b83\u7684\u8f93\u51fa(\u6bd4\u5982\u5c06 <code>action(1)</code> \u6539\u4e3a <code>action(0)</code>). \u987a\u4fbf, \u5728\u8fd9\u4e2a\u6307\u4ee4\u6bb5\u540e\u9762\u7d27\u8ddf\u4e00\u4e2a <code>ret</code> \u6307\u4ee4\u76f4\u63a5\u8fd4\u56de\u8be5\u65b9\u6cd5\u9632\u6b62\u8bef\u6267\u884c\u5230\u540e\u9762\u7684 <code>IL</code> \u6bb5. \u4e0d\u8fc7\u8fd9\u53ea\u5728\u540e\u9762\u6ca1\u6709\u4ee3\u7801\u9700\u8981\u6267\u884c\u7684\u60c5\u51b5\u4e0b\u594f\u6548,  \u5982\u679c\u540e\u9762\u4f9d\u7136\u6709\u4ee3\u7801\u7684\u8bdd\u6211\u4eec\u5c31\u5f97\u4f7f\u7528 <code>br</code> \u6307\u4ee4\u4e86.</p> <p><code>br</code> \u6307\u4ee4\u6267\u884c\u540e\u4f1a\u5c06\u76ee\u524d\u7684\u6267\u884c\u4f4d\u7f6e\u65e0\u6761\u4ef6\u7684\u8df3\u8f6c\u5230\u5bf9\u5e94\u4f4d\u7f6e, \u6bd4\u5982\u521a\u624d\u4ecb\u7ecd <code>brfalse</code> \u6307\u4ee4\u672b\u5c3e\u7684\u4e00\u70b9\u5c0f\u95ee\u9898, \u5373\u6bd4\u5982\u5982\u4e0b C# \u4ee3\u7801:</p> <pre><code>if (value == 0)\n{\n    Console.WriteLine(\"value is 0!\");\n}\nelse\n{\n    Console.WriteLine(\"value is not 0.\");\n}\nConsole.WriteLine(\"always execute me!\");\n</code></pre> <p>\u5728\u672b\u5c3e\u6211\u4eec\u6709\u4e00\u4e2a\u65b9\u6cd5\u8c03\u7528\u662f\u65e0\u5173 <code>value</code> \u7684\u503c\u7684, \u4e4b\u524d\u7684\u4ee3\u7801\u6211\u4eec\u4e3a\u4e86\u9632\u6b62\u8bef\u6267\u884c <code>IL</code> \u6211\u4eec\u4f7f\u7528\u4e86 <code>ret</code> \u6307\u4ee4\u76f4\u63a5\u8fd4\u56de\u6574\u4e2a\u65b9\u6cd5, \u4f46\u662f\u73b0\u5728\u8fd9\u91cc\u6211\u4eec\u65e0\u6cd5\u8fd9\u4e48\u5e72, \u4e0d\u8fc7\u73b0\u5728\u6709 <code>br</code> \u6307\u4ee4\u53ef\u4ee5\u4f7f\u7528\u4e86:</p> <pre><code>var cw = typeof(Console).GetMethod(\"WriteLine\", new Type[] { typeof(string) })!;\nvar valueIs0Target = il.DefineLabel();\nvar afterIfTarget = il.DefineLabel();\nil.Emit(OpCodes.Ldarg_0);\nil.Emit(OpCodes.Brfalse, valueIs0Target);\nil.Emit(OpCodes.Ldstr, \"value is not 0.\");\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Br, afterIfTarget);\nil.MarkLabel(valueIs0Target);\nil.Emit(OpCodes.Ldstr, \"value is 0!\");\nil.Emit(OpCodes.Call, cw);\nil.MarkLabel(afterIfTarget);\nil.Emit(OpCodes.Ldstr, \"always execute me!\");\nil.Emit(OpCodes.Call, cw);\nil.Emit(OpCodes.Ret);\n</code></pre>"},{"location":"trans/il/#s","title":"<code>.s</code> \u7cfb\u6307\u4ee4","text":"<p>\u4f60\u53ef\u80fd\u53d1\u73b0\u4e86\u5c31\u662f\u4e00\u4e9b <code>IL</code> \u6307\u4ee4\u540c\u65f6\u8fd8\u6709\u4e00\u4e2a\u5e26 <code>.s</code> \u540e\u7f00\u7684\u7248\u672c, \u8fd9\u4e2a\u6211\u4eec\u4e00\u822c\u53eb\u5b83\u7684 \"\u77ed\u683c\u5f0f\" \u7248\u672c, \u53cd\u4e4b\u53eb \"\u957f\u683c\u5f0f\" \u7248\u672c, \u6bd4\u5982\u5c31\u521a\u624d\u7684 <code>br</code> \u5bf9\u5e94\u7684 <code>br.s</code>, \u901a\u5e38\u7c7b\u4f3c\u8fd9\u4e00\u5bf9 <code>IL</code> \u6307\u4ee4\u7684\u533a\u522b\u5c31\u662f <code>.s</code> \u7248\u672c\u7684\u53c2\u6570\u4f1a\u77ed\u4e00\u70b9, \u6bd4\u5982\u957f\u683c\u5f0f\u7248\u672c\u7684\u53c2\u6570\u957f\u5ea6\u662f 4 \u5b57\u8282, \u800c\u77ed\u683c\u5f0f\u7248\u672c\u7684\u53c2\u6570\u957f\u5ea6\u53ef\u80fd\u5c31\u662f 2 \u5b57\u8282, \u6ce8\u610f\u8fd9\u91cc\u4e0d\u662f\u8bf4\u7684\u662f\u538b\u5165\u8bc4\u4f30\u6808\u7684\u503c\u7684\u7c7b\u578b, \u957f\u77ed\u683c\u5f0f\u7248\u672c\u6240\u505a\u7684\u4e8b\u60c5\u662f\u5b8c\u5168\u4e00\u6837\u7684, \u53ea\u662f\u4f20\u53c2\u5141\u8bb8\u4f60\u7528\u77ed\u4e00\u70b9\u7684\u53c2\u6570. \u8fd9\u5176\u5b9e\u5c31\u662f\u4e00\u4e2a\u5bf9 <code>IL</code> \u6307\u4ee4\u7684\u5927\u5c0f\u4f18\u5316, \u7f16\u8bd1\u5668\u901a\u5e38\u5c31\u4f1a\u80fd\u7528 <code>.s</code> \u7248\u672c\u5c31\u7528 <code>.s</code> \u7248\u672c, \u5f53\u53c2\u6570\u9700\u6c42\u8d85\u8fc7\u77ed\u683c\u5f0f\u53c2\u6570\u8868\u8fbe\u8303\u56f4\u65f6\u624d\u4f1a\u4f7f\u7528\u957f\u683c\u5f0f, \u5bf9\u4e8e\u6211\u4eec\u7684\u8bdd\u5982\u679c\u4f60\u60f3\u5fae\u5fae\u7684\u4f18\u5316\u4e00\u4e0b\u4f60\u7684 <code>IL</code> \u7684\u5927\u5c0f\u7684\u8bdd, \u4f60\u53ef\u4ee5\u9009\u62e9\u5728\u53c2\u6570\u8303\u56f4\u591f\u7528\u7684\u60c5\u51b5\u4e0b\u4f7f\u7528 <code>.s</code> \u7248\u672c.</p>"},{"location":"trans/il/#_12","title":"\u7ed3\u5c3e","text":"<p>\u81f3\u6b64, \u4e00\u4e9b\u57fa\u672c\u7684 <code>IL</code> \u4f60\u5df2\u4e86\u89e3, \u6211\u4eec\u5728\u8fd9\u91cc\u4ecb\u7ecd\u7684 <code>IL</code> \u6307\u4ee4\u4e0d\u8fc7\u662f\u51b0\u5c71\u4e00\u89d2, \u8fd8\u6709\u5f88\u591a\u5176\u4ed6\u7684 <code>IL</code> \u6307\u4ee4\u6ca1\u6709\u4ecb\u7ecd, \u4e0d\u8fc7\u5b83\u4eec\u5927\u540c\u5c0f\u5f02, \u57fa\u672c\u90fd\u662f\u5bf9\u8bc4\u4f30\u6808\u7684\u5404\u79cd\u5404\u6837\u7684\u64cd\u4f5c, \u6211\u4eec\u53ea\u9700\u8981\u5728\u7528\u5230\u65f6\u6216\u8005\u5076\u5c14\u7ffb\u9605\u4e00\u4e0b <code>IL</code> \u6307\u4ee4\u8868\u5c31\u80fd\u4e86\u89e3. \u6b64\u5916, \u5728 dnSpy \u7684 <code>IL</code> \u4ee3\u7801\u7684\u89c6\u89d2\u65f6, \u70b9\u51fb <code>IL</code> \u64cd\u4f5c\u7b26\u7684\u540d\u79f0\u53ef\u4ee5\u5f88\u65b9\u4fbf\u5730\u8df3\u8f6c\u5230 msdn \u4e0a\u5bf9\u8fd9\u4e2a\u6307\u4ee4\u7684\u63cf\u8ff0. \u90a3\u4e48, \u5728\u4e86\u89e3\u4f7f\u7528 <code>System.Reflection.Emit</code> \u5e93\u540e, \u6211\u4eec\u5c31\u53ef\u4ee5\u4f7f\u7528 <code>Mono.Cecil</code> \u5728\u851a\u84dd\u4e2d\u66f4\u6539\u851a\u84dd\u7684\u7a0b\u5e8f\u96c6\u4e86.  </p> <p>\u4e00\u4e9b\u53ef\u80fd\u6709\u7528\u7684\u8d44\u6e90:</p> <ul> <li>OpCodes Fields - Microsoft Learn (https://learn.microsoft.com/...)</li> <li>\u7406\u89e3IL - Rorschach - \u77e5\u4e4e (https://zhuanlan.zhihu.com/...)</li> <li>IL\u6307\u4ee4\u8be6\u7ec6 - Zery - \u535a\u5ba2\u56ed (https://www.cnblogs.com/...)</li> </ul>"}]}
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 8d37ac55a0c83bbcdd7b15c3072ecd4ada920c67..3bd0075806833dc06b9407a1cb31ead6d4a33aae 100755
GIT binary patch
delta 13
Ucmb=gXP58h;5f&hGm*Ul032Eb82|tP

delta 13
Ucmb=gXP58h;P7=%pU7ST02){W%K!iX

diff --git a/trans/adv_hooks/index.html b/trans/adv_hooks/index.html
index 753c138..eaba0cd 100755
--- a/trans/adv_hooks/index.html
+++ b/trans/adv_hooks/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>IL 钩子与随意钩取 - 蔚蓝Code Mod教程</title>
+        <title>IL 钩子与随意钩取 - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -779,6 +779,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/trans/common1/index.html b/trans/common1/index.html
index 845f5c7..0e3ca21 100755
--- a/trans/common1/index.html
+++ b/trans/common1/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>Alarm, Tween, Coroutine - 蔚蓝Code Mod教程</title>
+        <title>Alarm, Tween, Coroutine - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -766,6 +766,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/trans/ec_common/index.html b/trans/ec_common/index.html
index 696735b..698302e 100755
--- a/trans/ec_common/index.html
+++ b/trans/ec_common/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>更多EC - 蔚蓝Code Mod教程</title>
+        <title>更多EC - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -806,6 +806,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
diff --git a/trans/il/index.html b/trans/il/index.html
index 70434cd..13d553d 100755
--- a/trans/il/index.html
+++ b/trans/il/index.html
@@ -24,7 +24,7 @@
     
     
       
-        <title>IL - 蔚蓝Code Mod教程</title>
+        <title>IL - Celeste Code Mod 教程</title>
       
     
     
@@ -87,7 +87,7 @@
 
 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="页眉">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-header__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-header__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
@@ -100,7 +100,7 @@
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
-            蔚蓝Code Mod教程
+            Celeste Code Mod 教程
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
@@ -190,12 +190,12 @@
 
 <nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="蔚蓝Code Mod教程" class="md-nav__button md-logo" aria-label="蔚蓝Code Mod教程" data-md-component="logo">
+    <a href="../.." title="Celeste Code Mod 教程" class="md-nav__button md-logo" aria-label="Celeste Code Mod 教程" data-md-component="logo">
       
   <img src="../../assets/images/favicon.png" alt="logo">
 
     </a>
-    蔚蓝Code Mod教程
+    Celeste Code Mod 教程
   </label>
   
     <div class="md-nav__source">
@@ -850,6 +850,69 @@
   
 
     
+      
+      
+  
+  
+  
+    
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    额外 - LuaCutscene
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            额外 - LuaCutscene
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../extra_luacs/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    首页
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>