diff --git a/README.md b/README.md
new file mode 100644
index 000000000..cad687bb2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,74 @@
+
+# JA2 v1.13
+
+
+
+
+
+
+ 
+
+
+
+
+
+
+
+### Preamble
+
+Jagged Alliance 2 v1.13 is a modification for the Jagged Alliance 2 game.
+
+Original development was done through SVN, this however ended abruptly in 2022, to keep the development going the step to Github has been made.
+
+Feel free to participate in the development!
+
+
+For more information you can visit the following locations:
+
+[The Bear's Pit Forum](https://thepit.ja-galaxy-forum.com)
+
+[Jagged Alliance 2 v1.13 - Starter Documentation](https://github.com/1dot13/documentation)
+
+[How to get: latest 1.13, 7609, feature-descriptions and more](http://thepit.ja-galaxy-forum.com/index.php?t=msg&th=24648&start=0&)
+
+[JA2 v1.13 pbworks wiki (outdated)](http://ja2v113.pbworks.com/w/page/4218339/FrontPage)
+
+[The Bear's Pit Discord](https://discord.gg/GqrVZUM)
+
+
+
+In case of any issues, look at [Reports](#Reports) or [Participation](#Participation)
+
+### Downloads
+
+
+- [JA2 v1.13 latest release]("link to release")
+
+For the time being, Bear's Pit Forum "How-to-get..."-thread.
+A gitHub workflow for releases is w.i.p., the link will be updated when finished.
+
+
+### Installation
+
+1. Install original Jagged Alliance 2
+2. Download latest release and copy its content to JA2 game directory. Overwrite when asked.
+3. Modify Ini settings if you like.
+4. Play the game.
+
+ Some additional information on can be found in folder "docs" inside download.
+
+ If you face issues with higher resolutions, alt+tab not working, blackscreen, etc.,
+ run the "cnc-ddraw-config.exe" in game-folder and adjust settings to your liking.
+ (those issues can occur due to the combination of old game and modern OS/hardware, cnc-ddraw helps to avoid those)
+
+
+### Reports
+
+For more information and reports, visit [Bug reports at Bear's Pit Forum](http://thepit.ja-galaxy-forum.com/index.php?t=thread&frm_id=216&) or join the [Bear's Pit Discord](https://discord.gg/GqrVZUM "Bear's Pit Discord")
+
+
+### Participation
+
+Feel free to participate on gitHub. If you want to know how, or simply wanna share your thoughts on a topic join the [Bear's Pit Discord](https://discord.gg/GqrVZUM "Bear's Pit Discord")
+
+
diff --git a/ja2v1.13.png b/ja2v1.13.png
new file mode 100644
index 000000000..c34a77f6a
Binary files /dev/null and b/ja2v1.13.png differ
diff --git a/readme.txt b/readme.txt
deleted file mode 100644
index 57b14dcdc..000000000
--- a/readme.txt
+++ /dev/null
@@ -1,25 +0,0 @@
-Last 1.13 SVN 4721
-
-Compilation of UB :
-
-Set #define JA2UB and #define JA2UBMAPS in file builddefines.h.
-
-Compilation of JA2 :
-
-Rem #define JA2UB and #define JA2UBMAPS in file builddefines.h.
-
-
-Example :
-
-UB :
-
-#define JA2UB
-#define JA2UBMAPS
-
-JA2 :
-
-//#define JA2UB
-//#define JA2UBMAPS
-
-
-www.legion.zone.zg.pl
\ No newline at end of file