Update Doc

docs/event.md

@@ -29,6 +29,7 @@
     "x,y": {
         "trigger": "action", // 触发的trigger, action代表自定义事件
         "enable": true, // 该事件初始状态下是否处于启用状态
+        "noPass": true, // 该点是否不可通行。true代表不可通行，false代表可通行。
         "data": [ // 实际执行的事件列表
             // 事件1
             // 事件2
@@ -53,6 +54,7 @@
     "x,y": {
         // 除非你要覆盖该点已存在的系统默认事件，否则"trigger": "action"可以省略
         "enable": true, // 该事件初始状态下是否处于启用状态
+        "noPass": true, // 该点是否不可通行。true代表不可通行，false代表可通行。
         "data": [ // 实际执行的事件列表
             // 事件1
             // 事件2
@@ -71,6 +73,28 @@
     "x,y": {
         // 除非你要覆盖该点已存在的系统默认事件，否则"trigger": "action"可以省略
         // 该事件初始状态下是启用状态，则可以省略"enable": true；如果是禁用状态则必须加上"enable": false
+        "noPass": true, // 该点是否不可通行。true代表不可通行，false代表可通行。
+        "data": [ // 实际执行的事件列表
+            // 事件1
+            // 事件2
+            // ...
+        ]
+    }
+}
+```
+
+`"noPass"`为该点是否可通行的标记。`true`代表该点不可通行，`false`代表该点可通行。
+
+对于目前所有的素材，都存在默认的是否可通行状态。如果你在该点指定`noPass`，则原本的可通行状态会被覆盖。
+
+因此，除非你想覆盖默认的可通行选项（比如将一个空地设为不可通行），否则该项可以忽略。
+
+``` js
+"events": { // 该楼的所有可能事件列表
+    "x,y": {
+        // 除非你要覆盖该点已存在的系统默认事件，否则"trigger": "action"可以省略
+        // 该事件初始状态下是启用状态，则可以省略"enable": true；如果是禁用状态则必须加上"enable": false
+        // 除非你想覆盖系统默认的可通行状态，否则"noPass"项可以忽略
         "data": [ // 实际执行的事件列表
             // 事件1
             // 事件2
@@ -86,7 +110,7 @@
 
 ``` js
 "events": { // 该楼的所有可能事件列表
-    // 如果大括号里只有"data"项(没有"action"或"enable")，则可以省略到只剩下中括号
+    // 如果大括号里只有"data"项(没有"action", "enable"或"noPass")，则可以省略到只剩下中括号
     "x,y": [ // 实际执行的事件列表
         // 事件1
         // 事件2
@@ -97,7 +121,7 @@
 
 这种简写方式可以极大方便地造塔者进行造塔。
 
-!> **请注意：如果该点初始的`enable`为`false`，或者该点本身有系统默认事件且需要覆盖（`trigger`），则必须采用上面那种大括号写的方式来定义。**
+!> **请注意：如果该点初始的`enable`为`false`，或者该点本身有系统默认事件且需要覆盖（`trigger`），或者你想覆盖该点的默认通行状态，则必须采用上面那种大括号写的方式来定义。**
 
  
 

docs/personalization.md

@@ -21,6 +21,41 @@
 
 如果你需要某个素材已经存在，则可以直接将其覆盖images目录下的同名文件，就能看到效果。
 
+### 使用自己的图片作为某层楼的背景素材
+
+由于HTML5功能（素材）有限，导致了对很多比较复杂的素材（比如房子内）等无法有着较好的绘图方式。
+
+为了解决这个问题，我们允许用户自己放置一张图片作为某一层的背景素材。
+
+要启用这个功能，我们首先需要在`main.js`中将可能的图片进行加载。
+
+``` js
+this.pngs = [ // 在此存放所有可能的背景图片；背景图片最好是416*416像素，其他分辨率会被强制缩放成416*416
+    // 建议对于较大的图片，在网上使用在线的“图片压缩工具”来进行压缩，以节省流量
+    "bg.png", // "yewai.png",
+];
+```
+
+!> 背景素材只支持png格式，且会被强制缩放到416*416。
+
+!> 请使用网上的一些[在线图片压缩工具](http://www.asqql.com/gifzip/)对png图片进行压缩，以节省流量。一张500KB的png图片可以被压缩到20-30KB，显示效果不会有太大差异。
+
+之后，我们可以在每层剧本的`"png": "xxx"`里来定义该层的默认背景图片素材。
+
+``` js
+"png": "bg.png", // 背景图；你可以选择一张png图片来作为背景素材。
+```
+
+你的图片背景素材将会覆盖原来本身的背景层。
+
+**如果你需要让某些点不可通行（比如你建了个房子，墙壁和家具等位置不让通行），则需在`events`中指定`{"noPass": false}`，参见[自定义事件](event#自定义事件)的写法。
+
+``` js
+"events": {
+    "x,y": {"noPass": true} // (x,y)点不可通行
+}
+```
+
 ### 使用便捷PS工具生成素材
 
 如果我们有更多的素材要求，我们可以使用“便捷PS工具”进行处理。
@@ -52,7 +87,6 @@
 
 如果需要添加一个素材到游戏，则必须为其分配一个唯一标识符，并同时修改`icons.js`和`maps.js`两个文件。
 
-
 #### 新添加自定义地形（路面、墙壁等）
 
 如果你在terrains.png中新增了一行：

main.js

@@ -15,7 +15,7 @@ function main() {
     this.pngs = [ // 在此存放所有可能的背景图片；背景图片最好是416*416像素，其他分辨率会被强制缩放成416*416
         // 建议对于较大的图片，在网上使用在线的“图片压缩工具”来进行压缩，以节省流量
         // 有关使用自定义背景图，请参见文档的“自定义素材”说明
-        "bg.png", // "yewai.png",
+        "bg.png", "yewai.png", // 依次向后添加
     ];
     this.bgms = [ // 在此存放所有的bgm，和文件名一致。第一项为默认播放项
         // 音频名不能使用中文，不能带空格或特殊字符；可以直接改名拼音就好