diff --git a/.gitignore b/.gitignore
index 53b8ad4..91a7731 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,5 +3,7 @@
 # Whitelist all folders/files under weiss2
 !weiss2*/
 !weiss2*/**
+# Whitelist readme.md
+!readme.md
 # Obviously add in .gitignore
 !.gitignore
\ No newline at end of file
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..bdc971a
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,13 @@
+ronelm2000's Weiss Schwarz Plugin for MSE2
+===========
+[![Discord](https://img.shields.io/discord/831048458608705627?label=Discord)](https://discord.gg/9T55jJGHJD)
+[![Downloads](https://img.shields.io/github/downloads/ronelm2000/weiss-mse-plugin/total.svg)](https://tooomm.github.io/github-release-stats/?username=ronelm2000&repository=weiss-mse-plugin)
+[![WS Discord](https://img.shields.io/badge/WS%20Discord-%3F%3F%3F-lime)](https://discord.gg/B5RbYXH)
+
+Weiss Schwarz ©bushiroad All Rights Reserved.
+
+This plugin for MSE2 (or Magic Set Editor 2) is designed to make custom cards for Weiss Schwarz, a TCG from Bushiroad. There's actually 2 major card forks for this plugin; one is by Benitez and is currently developed by Chairman, and the other (which is the the older one from sion) is currently this fork.
+
+This fork supports the newest mechanics, including "Link", "Choice", "Replay", "Standby", etc., but does not support "Japanese Text Name Bar" found exclusively in English Imported Sets. This set also supports foil/SP mechanics, but not SEC.
+
+![MSE UI](https://i.imgur.com/ItDhJpT.png)
\ No newline at end of file