added blender addon for sar viewing & editing

Author: ArthurHeitmann

.gitignore

@@ -0,0 +1,2 @@
+.vscode
+__pycache__

tools/NierSarBlenderTools/README.md

@@ -0,0 +1,47 @@
+# Installation
+
+(Requires Blender 3 or later)
+
+1. Download zip from [Releases](https://github.com/ArthurHeitmann/NierDocs/releases).
+
+2. In Blender: Edit > Preferences > Add-ons > Install
+
+# Usage
+
+# Importing
+
+File > Import > Sar
+
+If you have a map file open (from wd1/wd3/wd5) you can check "Try Applying Offsets". This will try to convert the global game coordinates to local coordinates.
+
+Locations where you can find sar files:
+
+- data002/data012
+	- st1/st2/st5
+- data003/data013
+	- wd1/wd3
+
+More information [here](../../sar/sarContents.md).
+
+## Exporting
+
+File > Export > Sar
+
+If you have imported multiple sar files into the scene, only one will be exported. The object called "Field-Root" will be used as the root object.
+
+## Editing shapes
+
+| Shape Type Description | Shape Type Id | Things you can edit                                  |
+|------------------------|---------------|------------------------------------------------------|
+| Sphere                 | 0             | Core Sphere Loc, Rot, Scale + Edge Sphere Scale      |
+| Curve/Tube             | 1             | Core Curve points + Core/Edge bevel depth            |
+| Tall Curve             | 2             | Parent Loc, Rot + Vertices Pos XY & Vertices Scale Z |
+| Cube                   | 10            | Cube Loc, Rot, Scale                                 |
+| Extruded Polygon       | 11            | Parent Loc, Rot + Vertex Pos XY                      |
+| Cylinder               | 15            | Core Cylinder Loc, Rot, Extrude + Core/Edge Scale XY |
+| Sphere with scale ?    | 100           | Sphere Loc, Rot, Scale                               |
+| Volume between faces?  | 200           | Parent Loc, Rot + Vertex Pos + Modifier Z Property   |
+
+## Good to know
+
+Most objects have xml data attached to them in the custom properties. Some interesting properties: "ShapeGroup" objects have "InEvent" and "OutEvent" properties for entering/exiting the shape. The Param property is the distance of the player to the shape.

tools/NierSarBlenderTools/__init__.py

@@ -0,0 +1,87 @@
+import os
+import bpy
+import bpy_extras
+from bpy_extras.io_utils import ImportHelper, ExportHelper
+import xml.etree.ElementTree as ET
+
+bl_info = {
+    "name" : "NierSarTools",
+    "author" : "RaiderB",
+    "description" : "",
+    "blender" : (3, 0, 0),
+    "version" : (0, 1, 0),
+    "location" : "",
+    "warning" : "",
+    "category" : "Generic"
+}
+
+
+class ImportSar(bpy.types.Operator, ImportHelper):
+    '''Load a Nier:Automata Sar (Skeleton) File.'''
+    bl_idname = "import_scene.sar"
+    bl_label = "Import Sar Data"
+    bl_options = {'PRESET', 'UNDO'}
+    filename_ext = ".sar"
+    filter_glob: bpy.props.StringProperty(default="*.sar", options={'HIDDEN'})
+
+    tryApplyingOffsets: bpy.props.BoolProperty(name="Try Applying Offsets", default=False)
+
+    onlyToXml: bpy.props.BoolProperty(name="Only Convert To XML", default=False)
+    recursivelyImport: bpy.props.BoolProperty(name="Import all recursively", default=False)
+
+    def doImport(self, filepath):
+        from . import sarImporter
+        from . import sar
+
+        if self.onlyToXml:
+            xml = sar.bxmToXml(filepath)
+            with open(filepath + ".xml", "wb") as f:
+                f.write(ET.tostring(xml))
+        else:
+            sarImporter.importSar(filepath, self.tryApplyingOffsets)
+
+    def execute(self, context):
+        if self.recursivelyImport:
+            directory = os.path.split(self.filepath)[0]
+            for root, dirs, files in os.walk(directory):
+                for file in files:
+                    if file.endswith(".sar"):
+                        self.doImport(root + '\\' + file)
+            print("Imported all file!")
+        else:
+            self.doImport(self.filepath)
+        
+        return {'FINISHED'}
+
+class ExportSar(bpy.types.Operator, ExportHelper):
+    '''Export a Nier:Automata Sar (Skeleton) File.'''
+    bl_idname = "export_scene.sar"
+    bl_label = "Export Sar Data"
+    bl_options = {'PRESET', 'UNDO'}
+    filename_ext = ".sar"
+    filter_glob: bpy.props.StringProperty(default="*.sar", options={'HIDDEN'})
+
+    def execute(self, context):
+        from . import sarExporter
+        sarExporter.exportSar(self.filepath)
+        return {'FINISHED'}
+
+def importMenuAdditions(self, context):
+    self.layout.operator(ImportSar.bl_idname, text="Sar for Nier:Automata (.sar)")
+
+def exportMenuAdditions(self, context):
+    self.layout.operator(ExportSar.bl_idname, text="Sar for Nier:Automata (.sar)")
+
+def register():
+    bpy.utils.register_class(ImportSar)
+    bpy.utils.register_class(ExportSar)
+
+    bpy.types.TOPBAR_MT_file_import.append(importMenuAdditions)
+    bpy.types.TOPBAR_MT_file_export.append(exportMenuAdditions)
+
+def unregister():
+    bpy.utils.unregister_class(ImportSar)
+    bpy.utils.unregister_class(ExportSar)
+
+    bpy.types.TOPBAR_MT_file_import.remove(importMenuAdditions)
+    bpy.types.TOPBAR_MT_file_export.remove(exportMenuAdditions)