From 1991d081cbbb0807df73ebadd1f9d4d880e1d473 Mon Sep 17 00:00:00 2001
From: Torrin Leonard <82110564+torrinworx@users.noreply.github.com>
Date: Wed, 10 Aug 2022 22:32:35 -0400
Subject: [PATCH 1/7] Update README.md
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 1536408..a2fc350 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
-
Blend_My_NFTs
From 752fa4b6e96447430847145eeeec014de77067a4 Mon Sep 17 00:00:00 2001
From: Torrin Leonard <82110564+torrinworx@users.noreply.github.com>
Date: Wed, 10 Aug 2022 22:47:47 -0400
Subject: [PATCH 2/7] Update README.md
---
README.md | 112 ++++++++++++++++++++----------------------------------
1 file changed, 41 insertions(+), 71 deletions(-)
diff --git a/README.md b/README.md
index a2fc350..e9a7a35 100644
--- a/README.md
+++ b/README.md
@@ -388,25 +388,30 @@ If you need help creating a JSON file, checkout this tutorial: [How to Create JS
To learn more about JSON files and how to structure data read this article: [Working with JSON](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Objects/JSON)
-Material Randomizer compatable materials must follow this naming convention: `__`
-
## Material Randomizer JSON Schema
If you'd like, copy and paste this template into the JSON file you created above:
```
{
- "": {
- "Variant Objects":["", ""],
- "Material List": ["__", "__"]
- },
- "Red Cone_1_0": {
- "Variant Objects":["", ""],
- "Material List": ["__", "__"]
+ "": {
+ "Material List": {
+ "": ,
+ "": ,
+ "": ,
+ "":
+ },
+ "Variant Objects": [
+ "",
+ "",
+ "",
+ ""
+ ]
}
}
```
+TODO: Add more detail to this section regarding the new material system, for now reference this commit: https://github.com/torrinworx/Blend_My_NFTs/commit/3cb2a69c81932e5b882b69c4c4bfbdd153a2dfee
# Custom Metadata Fields
@@ -466,103 +471,68 @@ If you'd like, copy and paste this template into the JSON file you created above
```
{
"Rule-1":{
- "Items-1": [
- ""
+ "IF": [
+ ""
],
- "Rule-Type": "",
- "Items-2":[
- ""
- ]
- },
- "Rule-2":{
- "Items-1": [
- ""
- ],
- "Rule-Type": "",
- "Items-2":[
- ""
+ "THEN":[
+ "", ""
]
}
+ "Rule-2":{
+ "IF": [
+ ""
+ ],
+ "NOT":[
+ "", ""
+ ]
+ }
}
```
### Schema Definition
- ``Rule-#`` A dictionary representing the information of a single defined Rule of an NFT collection. There can be as many as you choose. Increment the ``#`` when you create a new rule.
-- ``Items-1`` A list of strings representing the names of Attribute(s) or Variant(s).
-- ``Rule-Type`` The rule that governs the relation between ``Items-1`` and ``Items-2``. Has two possible values: ``Never with`` and ``Only with``.
-- ``Items-2`` A list of strings representing the names of Attribute(s) or Variant(s).
+- ``IF`` A single String in a list representing the Variant the rule is based off of.
+- ``THEN`` A list of Attributes or Variants that always appear IF the ``IF`` Variant is selected.
+- ``NOT`` A list of Attributes or Variants that never appear IF the ``IF`` Variant is selected.
+
+* Note: ``NOT`` is not currently stable, it's recommended to only use a Single variant per NOT rule to see consistant results.
+
## Example Logic.json File
Say we have the following scene in a .blend file:
:
@@ -85,16 +107,28 @@ def apply_materials(hierarchy, singleDNA, materialsFile):
complete = False
for b in materialsFile:
if singleDNADict[a] == b:
- mat = select_material(materialsFile[b]['Material List'])
- deconstructed_MaterialDNA[a] = mat
+ material_name, materialList, = select_material(materialsFile[b]['Material List'], b, enableRarity)
+ material_order_num = list(materialList.keys()).index(material_name) # Gets the Order Number of the Material
+ deconstructed_MaterialDNA[a] = str(material_order_num + 1)
complete = True
if not complete:
deconstructed_MaterialDNA[a] = "0"
+ # This section is now incorrect and needs updating:
+
+ # Make Attributes have the same materials:
+ # Order your Attributes alphabetically, then assign each Attribute a number, starting with 0. So Attribute 'A' = 0,
+ # Attribute 'B' = 1, 'C' = 2, 'D' = 3, etc. For each pair you want to equal another, add its number it to this list:
+ # synced_material_attributes = [1, 2]
+ #
+ # first_mat = deconstructed_MaterialDNA[synced_material_attributes[0]]
+ # for i in synced_material_attributes:
+ # deconstructed_MaterialDNA[i] = first_mat
+
material_DNA = ""
for a in deconstructed_MaterialDNA:
num = "-" + str(deconstructed_MaterialDNA[a])
material_DNA += num
material_DNA = ''.join(material_DNA.split('-', 1))
- return f"{singleDNA}:{material_DNA}"
+ return f"{singleDNA}:{material_DNA}"
\ No newline at end of file
diff --git a/main/Rarity.py b/main/Rarity.py
index 2cabc49..eff5c7c 100644
--- a/main/Rarity.py
+++ b/main/Rarity.py
@@ -4,6 +4,9 @@
import bpy
import random
+from .Constants import bcolors, removeList, remove_file_by_extension
+
+
def createDNArarity(hierarchy):
"""
Sorts through DataDictionary and appropriately weights each variant based on their rarity percentage set in Blender
@@ -14,7 +17,6 @@ def createDNArarity(hierarchy):
for i in hierarchy:
number_List_Of_i = []
rarity_List_Of_i = []
- count = 0
ifZeroBool = None
for k in hierarchy[i]:
@@ -24,19 +26,25 @@ def createDNArarity(hierarchy):
rarity = hierarchy[i][k]["rarity"]
rarity_List_Of_i.append(float(rarity))
- count += 1
-
for x in rarity_List_Of_i:
if x == 0:
ifZeroBool = True
elif x != 0:
ifZeroBool = False
- if ifZeroBool:
- variantByNum = random.choices(number_List_Of_i, k=1)
- elif not ifZeroBool:
- variantByNum = random.choices(number_List_Of_i, weights=rarity_List_Of_i, k=1)
+ try:
+ if ifZeroBool:
+ variantByNum = random.choices(number_List_Of_i, k=1)
+ elif not ifZeroBool:
+ variantByNum = random.choices(number_List_Of_i, weights=rarity_List_Of_i, k=1)
+ except IndexError:
+ raise IndexError(
+ f"\n{bcolors.ERROR}Blend_My_NFTs Error:\n"
+ f"An issue was found within the Attribute collection '{i}'. For more information on Blend_My_NFTs compatible scenes, "
+ f"see:\n{bcolors.RESET}"
+ f"https://github.com/torrinworx/Blend_My_NFTs#blender-file-organization-and-structure\n"
+ )
singleDNA += "-" + str(variantByNum[0])
singleDNA = ''.join(singleDNA.split('-', 1))
- return singleDNA
+ return singleDNA
\ No newline at end of file
From fa1c2c5883a9838d0ee934d58099824e60e8b7a3 Mon Sep 17 00:00:00 2001
From: Torrin Leonard <82110564+torrinworx@users.noreply.github.com>
Date: Thu, 11 Aug 2022 10:26:16 -0400
Subject: [PATCH 4/7] Fixing issues with failed batches
Resolved conflicts with failed batches recovery related to headless variable integration from previous merge.
Fixed issue where animations would get corrupt when resuming failed batch. The last file to be generated will now be deleted if it exists to avoid this issue.
---
__init__.py | 62 ++++++++++++++++++++++++++++++++----------------
main/Exporter.py | 46 ++++++++++++++++++++++++++++++++---
2 files changed, 85 insertions(+), 23 deletions(-)
diff --git a/__init__.py b/__init__.py
index 6d4a0e8..48fed35 100644
--- a/__init__.py
+++ b/__init__.py
@@ -551,42 +551,64 @@ class resume_failed_batch(bpy.types.Operator):
_fail_state, _failed_batch, _failed_dna, _failed_dna_index = Checks.check_FailedBatches(_batch_json_save_path)
+ render_settings = batchData["Generation Save"][-1]["Render_Settings"]
+
input = BMNFTData(
- nftName=batchData["Generation Save"][-1]["Render_Settings"]["nftName"],
+ nftName=render_settings["nftName"],
save_path=_save_path,
- collectionSize=batchData["Generation Save"][-1]["Render_Settings"]["collectionSize"],
+ nftsPerBatch=render_settings["nftsPerBatch"],
+ batchToGenerate=render_settings["batchToGenerate"],
+ collectionSize=render_settings["collectionSize"],
Blend_My_NFTs_Output=_Blend_My_NFTs_Output,
batch_json_save_path=_batch_json_save_path,
- nftBatch_save_path=batchData["Generation Save"][-1]["Render_Settings"]["nftBatch_save_path"],
+ nftBatch_save_path=render_settings["nftBatch_save_path"],
- enableImages=batchData["Generation Save"][-1]["Render_Settings"]["enableImages"],
- imageFileFormat=batchData["Generation Save"][-1]["Render_Settings"]["imageFileFormat"],
+ enableImages=render_settings["enableImages"],
+ imageFileFormat=render_settings["imageFileFormat"],
- enableAnimations=batchData["Generation Save"][-1]["Render_Settings"]["enableAnimations"],
- animationFileFormat=batchData["Generation Save"][-1]["Render_Settings"]["animationFileFormat"],
+ enableAnimations=render_settings["enableAnimations"],
+ animationFileFormat=render_settings["animationFileFormat"],
- enableModelsBlender=batchData["Generation Save"][-1]["Render_Settings"]["enableModelsBlender"],
- modelFileFormat=batchData["Generation Save"][-1]["Render_Settings"]["modelFileFormat"],
+ enableModelsBlender=render_settings["enableModelsBlender"],
+ modelFileFormat=render_settings["modelFileFormat"],
- enableCustomFields=batchData["Generation Save"][-1]["Render_Settings"]["enableCustomFields"],
- custom_Fields=batchData["Generation Save"][-1]["Render_Settings"]["custom_Fields"],
+ enableCustomFields=render_settings["enableCustomFields"],
- cardanoMetaDataBool=batchData["Generation Save"][-1]["Render_Settings"]["cardanoMetaDataBool"],
- solanaMetaDataBool=batchData["Generation Save"][-1]["Render_Settings"]["solanaMetaDataBool"],
- erc721MetaData=batchData["Generation Save"][-1]["Render_Settings"]["erc721MetaData"],
+ cardanoMetaDataBool=render_settings["cardanoMetaDataBool"],
+ solanaMetaDataBool=render_settings["solanaMetaDataBool"],
+ erc721MetaData=render_settings["erc721MetaData"],
- cardano_description=batchData["Generation Save"][-1]["Render_Settings"]["cardano_description"],
- solana_description=batchData["Generation Save"][-1]["Render_Settings"]["solana_description"],
- erc721_description=batchData["Generation Save"][-1]["Render_Settings"]["erc721_description"],
+ cardano_description=render_settings["cardano_description"],
+ solana_description=render_settings["solana_description"],
+ erc721_description=render_settings["erc721_description"],
- enableMaterials=batchData["Generation Save"][-1]["Render_Settings"]["enableMaterials"],
- materialsFile=batchData["Generation Save"][-1]["Render_Settings"]["materialsFile"],
+ enableMaterials=render_settings["enableMaterials"],
+ materialsFile=render_settings["materialsFile"],
+
+ enableLogic=render_settings["enableLogic"],
+ enable_Logic_Json=render_settings["enable_Logic_Json"],
+ logicFile=render_settings["logicFile"],
+
+ enableRarity=render_settings["enableRarity"],
+
+ enableAutoShutdown=render_settings["enableAutoShutdown"],
+
+ specify_timeBool=render_settings["specify_timeBool"],
+ hours=render_settings["hours"],
+ minutes=render_settings["minutes"],
+
+ emailNotificationBool=render_settings["emailNotificationBool"],
+ sender_from=render_settings["sender_from"],
+ email_password=render_settings["email_password"],
+ receiver_to=render_settings["receiver_to"],
fail_state=_fail_state,
failed_batch=_failed_batch,
failed_dna=_failed_dna,
- failed_dna_index=_failed_dna_index
+ failed_dna_index=_failed_dna_index,
+
+ custom_Fields=render_settings["custom_Fields"],
)
Exporter.render_and_save_NFTs(input)
diff --git a/main/Exporter.py b/main/Exporter.py
index dea61bf..76a67cb 100644
--- a/main/Exporter.py
+++ b/main/Exporter.py
@@ -43,9 +43,9 @@ def save_generation_state(input):
"DNA Generated": None,
"Generation Start Date and Time": [CURRENT_TIME, CURRENT_DATE, LOCAL_TIMEZONE],
"Render_Settings": {
-
"nftName": input.nftName,
"save_path": input.save_path,
+ "nftsPerBatch": input.nftsPerBatch,
"batchToGenerate": input.batchToGenerate,
"collectionSize": input.collectionSize,
@@ -63,7 +63,6 @@ def save_generation_state(input):
"modelFileFormat": input.modelFileFormat,
"enableCustomFields": input.enableCustomFields,
- "custom_Fields": input.custom_Fields,
"cardanoMetaDataBool": input.cardanoMetaDataBool,
"solanaMetaDataBool": input.solanaMetaDataBool,
@@ -76,6 +75,24 @@ def save_generation_state(input):
"enableMaterials": input.enableMaterials,
"materialsFile": input.materialsFile,
+ "enableLogic": input.enableLogic,
+ "enable_Logic_Json": input.enable_Logic_Json,
+ "logicFile": input.logicFile,
+
+ "enableRarity": input.enableRarity,
+
+ "enableAutoShutdown": input.enableAutoShutdown,
+
+ "specify_timeBool": input.specify_timeBool,
+ "hours": input.hours,
+ "minutes": input.minutes,
+
+ "emailNotificationBool": input.emailNotificationBool,
+ "sender_from": input.sender_from,
+ "email_password": input.email_password,
+ "receiver_to": input.receiver_to,
+
+ "custom_Fields": input.custom_Fields,
},
})
@@ -272,12 +289,24 @@ def render_and_save_NFTs(input):
solanaMetadataPath = os.path.join(batchFolder, "Solana_metadata")
erc721MetadataPath = os.path.join(batchFolder, "Erc721_metadata")
+
+ def check_failed_exists(file_path):
+ # Delete a file if a fail state is detected and if the file being re-generated already exists. Prevents
+ # animations from corrupting.
+
+ if input.fail_state:
+ if os.path.exists(file_path):
+ os.remove(file_path)
+
# Generation/Rendering:
if input.enableImages:
+
print(f"{bcolors.OK}---Image---{bcolors.RESET}")
image_render_time_start = time.time()
+ check_failed_exists(imagePath)
+
def render_image():
if not os.path.exists(imageFolder):
os.makedirs(imageFolder)
@@ -302,6 +331,8 @@ def render_and_save_NFTs(input):
animation_render_time_start = time.time()
+ check_failed_exists(animationPath)
+
def render_animation():
if not os.path.exists(animationFolder):
os.makedirs(animationFolder)
@@ -373,40 +404,49 @@ def render_and_save_NFTs(input):
# obj.select_set(False)
if input.modelFileFormat == 'GLB':
+ check_failed_exists(f"{modelPath}.glb")
bpy.ops.export_scene.gltf(filepath=f"{modelPath}.glb",
check_existing=True,
export_format='GLB',
export_keep_originals=True,
use_selection=True)
if input.modelFileFormat == 'GLTF_SEPARATE':
+ check_failed_exists(f"{modelPath}.gltf")
+ check_failed_exists(f"{modelPath}.bin")
bpy.ops.export_scene.gltf(filepath=f"{modelPath}",
check_existing=True,
export_format='GLTF_SEPARATE',
export_keep_originals=True,
use_selection=True)
if input.modelFileFormat == 'GLTF_EMBEDDED':
+ check_failed_exists(f"{modelPath}.gltf")
bpy.ops.export_scene.gltf(filepath=f"{modelPath}.gltf",
check_existing=True,
export_format='GLTF_EMBEDDED',
export_keep_originals=True,
use_selection=True)
elif input.modelFileFormat == 'FBX':
+ check_failed_exists(f"{modelPath}.fbx")
bpy.ops.export_scene.fbx(filepath=f"{modelPath}.fbx",
check_existing=True,
use_selection=True)
elif input.modelFileFormat == 'OBJ':
+ check_failed_exists(f"{modelPath}.obj")
bpy.ops.export_scene.obj(filepath=f"{modelPath}.obj",
check_existing=True,
use_selection=True, )
elif input.modelFileFormat == 'X3D':
+ check_failed_exists(f"{modelPath}.x3d")
bpy.ops.export_scene.x3d(filepath=f"{modelPath}.x3d",
check_existing=True,
use_selection=True)
elif input.modelFileFormat == 'STL':
+ check_failed_exists(f"{modelPath}.stl")
bpy.ops.export_mesh.stl(filepath=f"{modelPath}.stl",
check_existing=True,
use_selection=True)
elif input.modelFileFormat == 'VOX':
+ check_failed_exists(f"{modelPath}.vox")
bpy.ops.export_vox.some_data(filepath=f"{modelPath}.vox")
# Loading Animation:
@@ -417,7 +457,7 @@ def render_and_save_NFTs(input):
model_generation_time_end = time.time()
print(
- f"{bcolors.OK}Generated model in {model_generation_time_end - model_generation_time_start}s.\n{bcolors.RESET}"
+ f"{bcolors.OK}Generated 3D model in {model_generation_time_end - model_generation_time_start}s.\n{bcolors.RESET}"
)
# Generating Metadata:
From 57f8d6defadc2d8b6b24e62ab85f5bf60614db57 Mon Sep 17 00:00:00 2001
From: Torrin Leonard <82110564+torrinworx@users.noreply.github.com>
Date: Thu, 11 Aug 2022 11:39:32 -0400
Subject: [PATCH 5/7] Update README.md
---
README.md | 17 ++++++-----------
1 file changed, 6 insertions(+), 11 deletions(-)
diff --git a/README.md b/README.md
index e9a7a35..87f98f7 100644
--- a/README.md
+++ b/README.md
@@ -11,18 +11,17 @@
## Description
-Blend_My_NFTs is an open source, free to use Blender add on that enables you to automatically generate thousands of 3D Models, Animations, and Images. This add on's primary purpose is to aid in the creation of large generative 3D NFT collections.
+Blend_My_NFTs is an open source, free to use Blender add-on that enables you to easily generate thousands of 3D Models, Animations, and Images. This add on's primary purpose is to aid in the creation of large generative 3D NFT collections. It is the first and easiest 3D NFT generator.
-For support, help, and questions, please join our wonderful Discord community: https://discord.gg/UpZt5Un57t
+For support, help, and questions, please join our wonderful [Discord community!](https://discord.gg/UpZt5Un57t)
-Checkout the newest tutorial on YouTube that goes along with this documentation: https://www.youtube.com/watch?v=ygKJYz4BjRs
-
-This add on was developed to create the This Cozy Place NFT project which is now availabe to mint on [ThisCozyStudio.com](https://www.thiscozystudio.com/cozy-mint/)
+[Checkout the newest YouTube tutorial!](https://youtu.be/ygKJYz4BjRs)
+Blend_My_NFTs was initially developed to create Cozy Place, an NFT collection by This Cozy Studio Inc.
https://user-images.githubusercontent.com/82110564/147833465-965be08b-ca5f-47ba-a159-b92ff775ee14.mov
-The video above illustrates the first 10 Cozy Place NFTs generated with Blend_My_NFts.
+The video above illustrates the first 10 Cozy Place NFTs generated with a very early prototype version of Blend_My_NFTs.
## Official Links:
@@ -41,7 +40,7 @@ Reddit: https://www.reddit.com/r/ThisCozyPlace/
## Quick Disclaimer
-Blend_My_NFTs works with Blender 3.1.0+ on Windows 10 or macOS Big Sur 11.6. Linux is supported, however we haven't had the chance to test and guarantee this functionality. Any rendering engine works; Cycles, Eevee, and Octane have all been used by the community. This add-on only works in Blender, a Cinima 4D port is being investigated.
+Blend_My_NFTs works with Blender 3.2.2 on Windows 10 or macOS Big Sur 11.6. Linux is supported, however we haven't had the chance to test and guarantee this functionality. Windows 11 has not been tested as of yet. Any rendering engine works; Cycles, Eevee, and Octane have all been used by the community. This add-on only works in Blender, a Cinima 4D port is being investigated.
## Example Files
The YouTube tutorials use three different .blend example files. This repository has all three and includes a readme.md file that outlines which videos use which files and by what date: https://github.com/torrinworx/BMNFTs_Examples
@@ -68,11 +67,7 @@ The YouTube tutorials use three different .blend example files. This repository
- [Custom Fields Schema](#custom-fields-schema)
- [Logic](#logic)
- [Logic JSON File Schema](#logic-json-schema)
- - [Schema Definition](#schema-definition)
- - [Rule Types](#rule-types)
- [Example Logic.json File](#example-logicjson-file)
- - [Never with, Logic Rule Examples](#never-with-logic-rule-examples)
- - [Only with, Logic Rule Examples](#only-with-logic-rule-examples)
- [Notes on Rarity and Weighted Variants](#notes-on-rarity-and-weighted-variants)
- [.Blend File Rarity Example](#blend-file-rarity-examples)
- [More complex Rarity Example](#more-complex-rarity-example)
From 9dbe3bbe469e14ce9b71894b6c561d7549adb286 Mon Sep 17 00:00:00 2001
From: Torrin Leonard <82110564+torrinworx@users.noreply.github.com>
Date: Thu, 11 Aug 2022 12:01:56 -0400
Subject: [PATCH 6/7] Fixing Logic UI Layout
---
UILists/Logic_UIList.py | 18 ++++++++++--------
1 file changed, 10 insertions(+), 8 deletions(-)
diff --git a/UILists/Logic_UIList.py b/UILists/Logic_UIList.py
index 8bed03f..0f82f42 100644
--- a/UILists/Logic_UIList.py
+++ b/UILists/Logic_UIList.py
@@ -58,7 +58,7 @@ class CUSTOM_OT_logic_actions(Operator):
if self.action == 'ADD':
if context.object:
item = scn.logic_fields.add()
- item.name = "Rule" # The name of each object
+ item.name = "Rule"
scn.logic_fields_index = len(scn.logic_fields) - 1
info = '"%s" added to list' % (item.name)
self.report({'INFO'}, info)
@@ -93,14 +93,16 @@ class CUSTOM_OT_logic_clearList(Operator):
# ======== UILists ======== #
class CUSTOM_UL_logic_items(UIList):
def draw_item(self, context, layout, data, item, icon, active_data, active_propname, index):
- split = layout.split(factor=0.1)
- split.label(text=f"{index + 1}")
- row = split.row()
- row.label(text=item.name) # avoids renaming the item by accident
- row.prop(item, "item_list1", text="")
+ layout = layout.split(factor=0.1)
+ col = layout.column()
+ col.label(text=f" Rule {index + 1}")
- row.prop(item, "rule_type", text="")
- row.prop(item, "item_list2", text="")
+ col = layout.column()
+ col.label(text="")
+ col.prop(item, "item_list1", text="")
+
+ col.prop(item, "rule_type", text="")
+ col.prop(item, "item_list2", text="")
def invoke(self, context, event):
pass
From 54f57b794f7a9cd3f8b4ad0b113112881c295d06 Mon Sep 17 00:00:00 2001
From: Torrin Leonard <82110564+torrinworx@users.noreply.github.com>
Date: Thu, 11 Aug 2022 12:19:39 -0400
Subject: [PATCH 7/7] Update README.md
---
README.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index 87f98f7..34885ca 100644
--- a/README.md
+++ b/README.md
@@ -19,8 +19,10 @@ For support, help, and questions, please join our wonderful [Discord community!]
Blend_My_NFTs was initially developed to create Cozy Place, an NFT collection by This Cozy Studio Inc.
+
https://user-images.githubusercontent.com/82110564/147833465-965be08b-ca5f-47ba-a159-b92ff775ee14.mov
+
The video above illustrates the first 10 Cozy Place NFTs generated with a very early prototype version of Blend_My_NFTs.
@@ -50,8 +52,6 @@ The YouTube tutorials use three different .blend example files. This repository
- [Blend_My_NFTs](#blend_my_nfts)
- [Description](#description)
- [Official Links](#official-links)
- - [Case Studies](#case-studies)
- - [Donations](#donations)
- [Quick Disclaimer](#quick-disclaimer)
- [Example Files](#example-files)
- [Table of Contents](#table-of-contents)
+ 