diff --git a/CHANGELOG.md b/CHANGELOG.md
index 58f9cdee7..60eb1d17a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,16 @@
+## Version 2.3.1
+
+This patch update fixes a couple of bugs.
+
+**Compatible** with McLib `2.3.1`, Metamorph `1.2.7` and Aperture `1.6`. It doesn't mean that future versions of Metamorph and Aperture would be incompatible, but older versions are most likely incompatible.
+
+* Added a feature when duplicating a scene, all player recordings will be renamed using rename prefix algorithm to avoid overwriting player recordings from previous scene
+* Added a feature to pack manually models into Blockbuster's jar (see `assets/blockbuster/models/user/` folder)
+* Added anchor point option to `structure` morph
+* Added support for loading n-gons in OBJs models
+* Added shadow option to `image` morph
+* Removed eye height animation to being laggy
+
 ## Version 2.3
 
 This update doesn't have any aim, but rather has a lot of random features, nothing groundbreaking though.
@@ -74,6 +87,7 @@ This update doesn't have any aim, but rather has a lot of random features, nothi
     * `blockbuster/textures/entity/eye_masks/` are eyes masks that allow erasing 2 and 1 pixel high eye holes with multi-skin
     * `blockbuster/textures/entity/skin_masks/` are skin masks (by Silverx) that allow erasing body parts on Minecraft player skins
     * `blockbuster/textures/entity/mchorse/` are McHorse's eyes, head and skin textures
+    * `blockbuster/textures/entity/pixel.png` is a white pixel that can be used with image morph for glow effects (use the color filter to change the color of the pixel)
 * Changed shape keys' relative option to be enabled by default
 * Fixed shape keys incorrectly calculating after morph merging
 * Fixed OBJ files not being copied when duplicating a model (reported by SergiDPlay)
diff --git a/version.json b/version.json
index 645f4f3da..033d35baa 100644
--- a/version.json
+++ b/version.json
@@ -1,6 +1,7 @@
 {
     "homepage": "https://curseforge.com/minecraft/mc-mods/blockbuster/",
     "1.12.2": {
+        "2.3.1": "This patch update fixes a couple of bugs.",
         "2.3": "This update doesn't have any aim, but rather has a lot of random features, nothing groundbreaking though.",
         "2.2.2": "This patch update was made to complement BB guns tutorial video.",
         "2.2.1": "This patch update adds a couple of neat features and fixes.",
@@ -52,8 +53,8 @@
         "1.4.10": "Patch 1.4.10 adds few nice misc. features (model block and OBJ loading without JSON model) which generally should improve UX a bit and simplify decorating set with Blockbuster models/Metamorph morphs, and lay down a foundation for future new features (which involves removing old useless code)."
     },
     "promos": {
-        "1.12.2-latest": "2.3",
-        "1.12.2-recommended": "2.3",
+        "1.12.2-latest": "2.3.1",
+        "1.12.2-recommended": "2.3.1",
         "1.11.2-latest": "1.6.6",
         "1.11.2-recommended": "1.6.6",
         "1.10.2-latest": "1.6.6",