diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4c2130c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# Configure Trenchbroom
+
+## Trenchbroom HEDZ game
+
+TB needs to now about our custom entites, so we need to map a [games folder](https://trenchbroom.github.io/manual/latest/#game_configuration_files) to the generated files in `trenchbroom/hedz`.
+
+## TB asset files
+
+TB needs to now where to find the games files.
+
+Go to `Preferences`, select `HEDZ` in the list and choose repo folder.