diff --git a/.tool-versions b/.tool-versions
new file mode 100644
index 0000000..c675395
--- /dev/null
+++ b/.tool-versions
@@ -0,0 +1,2 @@
+java adoptopenjdk-8.0.322+6
+gradle 6.8.3
diff --git a/README.md b/README.md
index 2ca8463..34f6806 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,20 @@
 # ws3d
 WorldServer3D - A Virtual Environment for Experiments with Artificial Creatures
+
+## Utils for setup (optional)
+
+### ASDF
+[asdf github](https://github.com/asdf-vm/asdf)
+
+[Install asdf](http://asdf-vm.com/guide/getting-started.html#_1-install-dependencies)
+
+* what is asdf?
+tldr: it's a package manager to rule all package managers
+
+* is it mandatory to run this project?
+tldr: no, there are other methods
+
+* what is the advantage of `asdf`?
+tldr: once installed, run `./utils/asdf-setup.sh`
+
+You have a running project :)
\ No newline at end of file
diff --git a/utils/asdf-setup.sh b/utils/asdf-setup.sh
new file mode 100755
index 0000000..fe9d2bd
--- /dev/null
+++ b/utils/asdf-setup.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/sh
+
+asdf plugin-add java https://github.com/halcyon/asdf-java.git
+asdf plugin-add gradle https://github.com/rfrancis/asdf-gradle.git
+asdf install
+gradle run