From 829e2e193cbeca574b2f3f2dbbb25a2443b36804 Mon Sep 17 00:00:00 2001
From: poikilos <7557867+poikilos@users.noreply.github.com>
Date: Wed, 9 Oct 2019 21:14:46 -0400
Subject: [PATCH] Add instructions that are visible in Text Editor

---
 .../blender/generate_lua_collisionbox.py      | 25 +++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/utilities/blender/generate_lua_collisionbox.py b/utilities/blender/generate_lua_collisionbox.py
index 381c07c..650f83a 100644
--- a/utilities/blender/generate_lua_collisionbox.py
+++ b/utilities/blender/generate_lua_collisionbox.py
@@ -1,5 +1,26 @@
-print("How to use: paste into a Blender Text Editor panel, select"
-      " object, Run Script")
+#!/usr/bin/env python
+
+# collisionbox Lua generator
+# 1. Select a mob mesh or an Empty
+# 2. Press the "Run Script" button below
+# - The script copies the collisionbox the the clipboard.
+# - An 'Empty' with the object's name will appear,
+#   which visually represents the collisionbox
+#   (which MUST be symmetrical on horizontal axes and
+#   centered at 0,0,0 for Minetest, since
+#   collision boxes to not turn).
+# 3. To adjust, scale the Empty.collisionbox.* object
+#    in Blender then repeat steps 1-2. To keep the Empty
+#    symmetrical for Minetest, scale ONLY with one
+#    of the following hotkey sequences (with
+#    the mouse pointer in the 3D View):
+#    - 's'
+#    - 's', 'z'
+#    - 's', "shift z"
+
+print("How to use: Paste this script into a Blender"
+      " Text Editor panel, select an object,"
+      " press the 'Run Script' button")
 
 y_up = True
 enable_minetest = True