Refactor modules and start on that tutorial series

Author: Kade-github

assets/content/cookbook/Expert/01.ScriptedModules.md

@@ -6,6 +6,11 @@ Most articles about scripting will cover basic functionality of overriding alrea
 
 A module is a class which runs very similarly to global scripts in other game engines. They are basically mini-states that run parallel to the original state.
 
+You can use these modules to create entirely custom functionality, examples include:
+- Custom HUDs
+- Custom Menu's (Mod Menu, Pause Menu, Main Menu, etc)
+- Retroactively affect gameplay (Creating chances of sprites appearing on screen, and adding your own version of ghost tapping. Among other things)
+
 ## Creating a Module
 
 ```haxe

assets/content/cookbook/Expert/02.ModPackages.md

@@ -0,0 +1,128 @@
+[tags]: / "expert,hscript"
+
+# Mod Pacakges
+
+As your mods complexity increases, with many different scripts (modules, custom objects/states, etc) it is vital to eventually organize this code. You can do this in the same way as regular haxe: **Package names**.
+
+```haxe
+package kade.hex.modules;
+
+import funkin.modding.module.Module;
+
+// ...
+
+class Hex_Hud extends Module
+{
+    // ... some code here ...
+}
+```
+
+As seen in the code snippet, the module 'Hex_Hud' has the package of 'kade.hex.modules' which will allow for better organization of your code, and to keep stack traces nice and clean.
+
+# Referencing modules/scripted classes
+
+Referencing other modules (and also scripts), can be done by using the ModuleHandler, or by creating a scripted version of that object.
+
+```haxe
+
+import funkin.modding.module.ModuleHandler;
+
+// ...
+
+public override function onStateCreate(event:ScriptEvent):Void
+{
+    // The first argument is the 'id' of the module (the one used in the constructor *OF* that module)
+    var hexHud = ModuleHandler.getModule("Hex_Hud");
+
+    // ... some code using it, the variable acts like a singleton of that module.
+}
+
+// ...
+```
+
+# Instantiating your own custom scripted class
+
+Since modules are created (instantiated) by the game, they are already accessible via the game itself. But if you want to create your own scripted classes, you can do a couple of things.
+
+## Game provided class
+
+If the game already provides it, and your script extends it. It is very simple:
+
+```haxe
+// The FlxTypeSpriteGroup class (base game provided)
+
+import funkin.modding.base.ScriptedFlxSpriteGroup;
+
+// ...
+
+class HEXDialogueBox extends FlxTypedSpriteGroup
+{
+    // ... dialogue code
+}
+```
+
+Then you can simply create this class in a song like so:
+
+```haxe
+import funkin.play.song.Song;
+import funkin.play.PlayState;
+import funkin.modding.base.ScriptedFlxSpriteGroup;
+import funkin.play.PlayStatePlaylist;
+
+class RamSong extends Song {
+    var cutscenePlayed = false;
+
+    public override function onCountdownStart(event:CountdownScriptEvent):Void {
+	    if (!PlayStatePlaylist.isStoryMode)
+            cutscenePlayed = true;
+        
+		if (!cutscenePlayed) {
+            event.cancel();
+
+            PlayState.instance.camHUD.visible = false;
+            playDialogue();
+		}
+		super.onCountdownStart(event);
+	}
+
+
+    public function playDialogue() {
+        var hexDiag:HEXDialogueBox = ScriptedFlxSpriteGroup.init("HEXDialogueBox"); // this line with instantiate this class (based on its name, or name and package)
+        
+        // ... setup dialogue code
+    }
+}
+```
+
+## Custom class
+
+If you created the class yourself, you can simply instance itself with the 'new' operator.
+
+```haxe
+package kade.hex.states;
+
+import funkin.ui.MusicBeatState;
+
+class HexMainMenu extends MusicBeatState {
+
+    // ... surely there is code here
+}
+```
+
+```haxe
+import kade.hex.states.HexMainMenu;
+import flixel.FlxG;
+
+// ...
+
+public function someFunction() {
+    var mm:HexMainMenu = new HexMainMenu();
+    FlxG.switchState(mm);
+}
+
+// ...
+```
+
+With this knowledge you are now able to reference modules dynamically, and create custom objects.
+
+> Author: [Kade](https://github.com/Kade-github)

assets/content/cookbook/Expert/03.ScriptedStates.md

@@ -0,0 +1,7 @@
+[tags]: / "expert,hscript,module"
+
+# Scripted States
+
+todo :P
+
+> Author: [Kade](https://github.com/Kade-github)