You should know that I am not responsible for any misuse.
Some people might use it in inappropriate ways, but that is beyond my control.
I am also not responsible for anyone who adds custom dances to ActMod.
However, I may remove or block inappropriate dances from being included if necessary.
(In short, you are responsible for your own custom dances.)

🙏 I hope everyone understands this.

---

To add your own custom dance, first create a folder for the required files:
1. Go to the path: ....steamapps\common\GarrysMod\garrysmod\addons

2. Create a new folder (recommended: plain text, no special characters).
Example: myDance

3. Inside that folder, create the following path: lua/actmod/am_animc

4. Inside am_animc, create a file, for example: mdance01.lua

5. Open the file you just created and add your dance data inside it, It must contain data for that dance, something like:
❕ Important: The file must contain only a single table, otherwise it will be ignored.
You can also check my example file[github.com], which includes the instructions and rules for creating a valid data table.

6. After filling in the table for your custom dance, make sure of the following:

• [Dance image file]: The image file name must match the custom dance table name (the title at the start of your dance table). The image must be in .png format, recommended size 250x250.
  
• [Sound file (if added) ]: Make sure the sound file path used for your custom dance is correct.
  
• [Animation file (if added) ]: Ensure your custom dance animation is included in the player animations. You can verify this by using the command: am4_manim
  (This shows all player animations from list Base Anim-AM4 ).

---

If your custom dance does not appear in the menu, make sure that:

• Make sure the table is not duplicated or already exists, either from the base mod or another creator.
  
• The image name for your custom dance matches the dance title in the table.
  - The title is taken from the start of the table.
  - Do not include file extensions or formats (only the image name).
  
• The image format must be .png, and it is recommended to use dimensions of 250x250.
  
• The image for your custom dance is in the correct path:
  *YourAddonDance*/
  materials/actmod/cumact/

If your custom dance doesn’t work (even though it shows in the custom menu):

• Make sure the custom dance table is written correctly.
  
• Check that all ActMod requirements are installed and working properly.
  
• Verify that your custom dance is actually included in the player’s animations.
  You can check this by viewing the player’s animations using the command: am4_manim

If it still doesn’t work correctly, you can use these console commands:

• actmod_getlog → Opens a log window in the middle of the screen. If you see any text in red, it means there’s a problem preventing custom dances from loading.
  
  
• actmod_cl_showbterr → Shows a small window with simple logs about custom dance files and their operations.
  
  
• actmod_reloadact → reloads the dance tables. Use it after editing your custom dance table to apply changes immediately without restarting the map.
  
  
  These commands can help you identify the root of the problem.

---

We hope you enjoy using ActMod! 🎉
Feel free to share your custom dances on the Steam Workshop so everyone can see them.

ActMod is now easier than ever to use at any time.
✨ Thank you to everyone who shares their ideas and dances with the community!
Show off your dance! Use the hashtag #ActMod_Dance to share it with the community!

Note: More instructions will be added in future updates.
⭐ Don’t forget to show your support for AhmedMake400! ⭐

---