📝 Minescript FAQ
💬 Some information may be outdated or incorrect. If you notice any issues, please let me know!
🔧 What is Minescript?
- Official site: minescript.net
- Discord Community: https://discord.gg/NjcyvrHTze
(A great place to ask questions or find community-made scripts) - Overview:
Minescript allows you to control and interact with Minecraft using Python scripts. - Mod availability:
You can download the mod from Modrinth or CurseForge.
It supports Fabric, Forge, and NeoForge mod loaders. - Supported environments:
Client-side - 📄 Please review the Terms of Service of Minescript to ensure that your usage is compliant.
🛠️ How to Set Up Minescript
🟩 Default Launcher (Official Minecraft Launcher)
- 🎬 Sample My Movie: How to Set Up Minescript (no launcher) - YouTube
- Download the required mods (Minescript + dependencies).
- Set your Python path in
config.txt
. - Test it with a sample script.
🟦 Modrinth App (Recommended for Beginners)
- 🎬 Sample My Movie: How to Set Up Minescript (4 Simple Steps) - YouTube
- Download Modrinth and create a new instance.
- Install the required mods (Minescript + dependencies).
- Set your Python path in
config.txt
. - Test it with a sample script.
💡 Modrinth is a free Minecraft launcher available for Windows, macOS, and Linux.
▶️ Running a Minescript
You can run your .py
scripts directly in Minecraft via the chat console:
-
Example: A script located at
minecraft/minescript/example.py
can be run as:\example
🎥 Sample My Movies and 📝Sample My Code
📁 Where to Find Your Minecraft Folder
💬 Note: Some of these paths may be unverified on Windows or with CurseForge.
💡 Each instance has its ownmods/
,saves/
, and other folders.
🟩 Official Minecraft Launcher
OS | Folder Location |
---|---|
Windows | %APPDATA%\.minecraft\minescript\ |
macOS | ~/Library/Application Support/minecraft/minescript/ |
Linux | ~/.minecraft/minescript/ |
🟦 Modrinth App
OS | Folder Location |
---|---|
Windows | %APPDATA%\ModrinthApp\profiles\<Instance>\minescript\ |
macOS | ~/Library/Application Support/ModrinthApp/profiles/<Instance>/minescript/ |
Linux | ~/.config/ModrinthApp/profiles/<Instance>/minescript/ |
🟧 CurseForge Launcher
OS | Folder Location |
---|---|
Windows | %HOMEDRIVE%%HOMEPATH%\curseforge\minecraft\instances\<Instance>\minescript\ |
macOS | ~/Library/Application Support/curseforge/minecraft/instances/<Instance>/minescript/ |
Linux | ~/.curseforge/minecraft/instances/<Instance>/minescript/ |
Tips
⊞ Windows
- Press ⊞ Windows + R, type
%APPDATA%\.minecraft
, and press OK. -
%APPDATA%
equals:
C:\Users\<Username>\AppData\Roaming\
- ⚠️ The
AppData
folder is hidden.
In File Explorer, go to the View tab and enable Hidden items to see it.
🍎 macOS
- Press ⇧ Shift + ⌘ Command + G in Finder, or open Spotlight from the menu bar.
- Enter:
~/Library/Application Support/minecraft
-
~/Library/
equals:
/Users/<Username>/Library/
- ⚠️ The
Library
folder is hidden.
Use the Go to Folder shortcut or press Command + Shift + . to show hidden files. - The
~
symbol refers to your home directory (e.g.,/Users/you/
).
🐧 Linux
- The
~
symbol refers to your home directory (e.g.,/home/you/
). - Folders starting with a dot (
.
), like.minecraft
, are hidden by default. - Most file managers toggle hidden files with Ctrl + H.
🐍 How to Find Your Python Installation Path
◾ Windows
- Open Command Prompt (
Win + R
→ typecmd
→ Enter) - Run:
where python
- Example path:
C:\Users\yourname\AppData\Local\Programs\Python\Python311\python.exe
◾ macOS
- Open Spotlight (
Cmd + Space
) → typeTerminal
- Run:
which python3
- Example output:
/usr/bin/python3
💬 Note: which python
may show Python 2.