finish version 2.0

README.md

@@ -6,7 +6,7 @@
 
 This is a Blender plugin which is served for Ballance mapping in Blender.
 
-Currently, it only contain fundamental functions. More useful features will be added in future.
+The latest commit may not be stable to use, please visit the Release page to get a stable version.
 
 ## Technical infomation
 
@@ -14,6 +14,8 @@ Used BM file spec can be found in [there](https://github.com/yyc12345/gist/blob/
 
 Used tools chain principle and the file format located in `meshes` can be found in [there](https://github.com/yyc12345/gist/blob/master/BMFileSpec/YYCToolsChainSpec_ZH.md)(Chinese only).
 
+The format of the files which are under the `jsons` folder and belong to the BMERevenge section, can be found in [here](https://github.com/yyc12345/gist/blob/master/BMERevenge/DevDocument_ZH.md)
+
 This plugin will continuously support Blender lastest **LTS** version. This plugin will migrate to new version when the new LTS version released. Currently, it based on Blender 2.83.x.
 
 ## Function introduction
@@ -36,19 +38,43 @@ It should be noted that once the BM is exported, all the faces in the file will
 
 Ballance 3D is a set of light tools related to 3D operations, which can be found in the upper right corner of the 3D view.
 
-#### Super Align
+#### 3ds Max Align
 
 Provide 3ds Max like align tools. Current active will be seen as reference object. All selected objects(except active object) will be seen as operating object (So you can select multiple objects to align to the reference object).
 
 #### Create Rail UV
 
-Create UV for rails. You should select the object which you want add rail like UV to. Then, click this menu. Before doing this, you need make sure all selected object have at least 1 UV map (If it have more than 1 UV map, only the first UV map will be changed).
+To create UVs for the rails in the map, you need to select the objects that need to add UVs similar to the rails, and then click this button to create.
+
+In the dialog, you can select the material to be used. You can also choose the unfolding mode. For shorter rails, you can choose Point mode. For longer rails, you can use Uniform mode. If you need to manually adjust the zoom ratio, please select Scale mode and specify the ratio (not recommended).
+
+You can also select the projection axis for better UV distribution.
+
+### Flatten UV
+
+In the object editing mode, it is a operator which is used to attach the currently selected surface to the UV. And you can specific the edge which will be attached into the V axis. Note that only convex faces are supported.
+
+In the edit mode, select the surface, click Flatten UV, and then scroll the slider to select an edge as a reference. If the generated UV is not attached correctly, such as the FloorSide's band is pasted to the bottom, you can reselect the reference edge and redo the operation until it is correct.
+
+### Add Menu
+
+In the add menu, we have added a set of commonly used objects. After adding, the object will move to the 3D cursor.
+
+#### Elements
+
+Add elements, you can also specify attributes such as section when adding (it will not be displayed for unique objects such as start point)
+
+#### Rail section
+
+Add rail section, you can choose monorail or rail (just decide the number of rail section loops added, and will not help you rotate the angle), as well as rail radius and rail span.
+
+#### Floors
+
+Adding floor is part of the BMERevenge project. Basic floor is a basic floor component, and Derived floor is a common component composed of basic components. The extension(length) and the side configuration can be set according to its properties. It also has the advantage of reducing vertices.
+
+It is recommended to merge the vertices by distance, unless there is a need to delete the surface after adding it
 
 ## Install
 
 Put `ballance_blender_plugin` into Blender's plugin folder, `scripts/addons_contrib`. Then enable this plugin in Blender's preferences (Don't forget to configure this plugin's settings).
 
-## Dev plan
-
-* Add elements in Add menu.
-* The assisted tools for creating custom floor in Blender (for example: add UV for floor).

README_ZH.md

@@ -6,8 +6,6 @@
 
 这是一个用于Blender的插件，其主要是服务于Ballance制图。
 
-目前仅仅包含比较基本的功能，其余的更多有用的功能将在未来版本中进行开发。
-
 请使用Release中打tag的最新版本，最新的commit不能保证其是稳定可用的
 
 ## 技术信息
@@ -50,15 +48,17 @@ Ballance 3D是一套简单的用于制图3D相关的轻型工具集合，可以
 
 在弹出设置窗口中，可以选择使用的材质。还可以选择展开模式，对于较短的钢轨，可以选择Point模式，对于较长的钢轨，可以使用Uniform模式，如果需要手动调整缩放比，请选择Scale模式并指定比率（不推荐）。
 
+还可以选择投影轴以获取更好的UV分布。
+
 ### Flatten UV
 
 在物体编辑模式下，用于将当前选中面按某一边贴附到V轴上的模式，展开到UV上。注意，只支持凸边面。
 
-编辑模式下，选中面，点击Flatten UV，然后滚动滑条选中一个边作为参考，如果最后生成的边贴附不对，比如把路面花纹贴到了下部，可以撤销并重新选择参考边，直到正确为止。
+编辑模式下，选中面，点击Flatten UV，然后滚动滑条选中一个边作为参考，如果最后生成的边贴附不对，比如把路面花纹贴到了下部，可以重新选择参考边再进行操作，直到正确为止。
 
 ### 添加菜单
 
-在添加菜单中我们添加了一套较为常用的物体。添加后物体会移动到3D游标处。可以用Shift+A调出。
+在添加菜单中我们添加了一套较为常用的物体。添加后物体会移动到3D游标处。
 
 #### Elements
 

ballance_blender_plugin/__init__.py

@@ -2,7 +2,7 @@ bl_info={
 	"name":"Ballance Blender Plugin",
 	"description":"Ballance mapping tools for Blender",
 	"author":"yyc12345",
-	"version":(1,1),
+	"version":(2,0),
 	"blender":(2,83,0),
 	"category":"Object",
 	"support":"TESTING",

ballance_blender_plugin/threedsmax_align.py

@@ -12,7 +12,7 @@ class BALLANCE_OT_super_align(bpy.types.Operator):
     align_z: bpy.props.BoolProperty(name="Z position")
 
     current_references: bpy.props.EnumProperty(
-        name="Current",
+        name="Reference",
         items=(('MIN', "Min", ""),
                 ('CENTER', "Center (bound box)", ""),
                 ('POINT', "Center (axis)", ""),