Minescript is a platform for controlling and interacting with Minecraft using scripts written in the Python programming language.
Before using Minescript, please review the Terms of Use.
Join the Minescript Discord Server for announcements and to engage with the Minescript community.
Check out Minescript documentation for details about commands and APIs.
Download Python scripts developed for use with Minescript.
Setup
-
Download and install the Minescript mod for either Fabric (requires Fabric API) or Forge.
-
Download and install Python 3 if you don't already have it: https://www.python.org/downloads/ (or from the Microsoft Store on Windows)
-
Run Minecraft with the Minescript mod installed. The first time the Minescript mod runs, it will automatically create a minescript folder inside the minecraft folder.
-
Create Python scripts in the minescript folder.
-
Run Python scripts from the Minecraft in-game chat by entering backslash ("\") followed by the script name without the ".py" extension.
Minescript expects Python to be installed at the following location:
- on Windows:
%userprofile%\AppData\Local\Microsoft\WindowsApps\python3.exe - on Mac, Linux, etc:
/usr/bin/python3
If Python is installed somewhere else on your system, you can point Minescript at it by changing the python variable in the file config.txt in the minescript folder.
Example
See this example script that demonstrates how to access the player's coordinates, read blocks at a given location, and create blocks like signs with custom text all from a Python script.
Compatibility Tested on the following platforms:
- Fabric, Forge, and NeoForge mod loaders
- Python 3.7 through 3.10
- macOS up to Sonoma
- Linux (Pop!_OS, NixOS, Bazzite, and SteamOS)
- Windows 10 and 11 (x86)
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Minescript 5.0 for Fabric 26.3 5.0-fabric-26.3 |
26.3
|
fabric
|
Download |
|
Minescript 5.0 for Neoforge 26.3 5.0-neoforge-26.3 |
26.3
|
neoforge
|
Download |
|
Minescript 5.0 for Fabric 26.2 5.0-fabric-26.2 |
26.2
|
fabric
|
Download |
|
Minescript 5.0 for Neoforge 26.2 5.0-neoforge-26.2 |
26.2
|
neoforge
|
Download |
|
Minescript 5.0 for Fabric 26.1.2 5.0-fabric-26.1.2 |
26.1.2
|
fabric
|
Download |
|
Minescript 5.0 for Neoforge 26.1.2 5.0-neoforge-26.1.2 |
26.1.2
|
neoforge
|
Download |
|
Minescript 5.0 for Fabric 26.1 5.0-fabric-26.1 |
26.1
|
fabric
|
Download |
|
Minescript 5.0 for Neoforge 26.1 5.0-neoforge-26.1 |
26.1
|
neoforge
|
Download |
|
Minescript 5.0 for Fabric 1.21.11 5.0-fabric-1.21.11 |
1.21.11
|
fabric
|
Download |
|
Minescript 5.0 for Neoforge 1.21.11 5.0-neoforge-1.21.11 |
1.21.11
|
neoforge
|
Download |
|
Minescript 5.0 for Fabric 1.21.10 5.0-fabric-1.21.10 |
1.21.10
|
fabric
|
Download |
|
Minescript 5.0 for Neoforge 1.21.10 5.0-neoforge-1.21.10 |
1.21.10
|
neoforge
|
Download |
|
Minescript 5.0 for Fabric 1.21.8 5.0-fabric-1.21.8 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0 for Neoforge 1.21.8 5.0-neoforge-1.21.8 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b11 for Fabric 26.2 5.0b11-fabric-26.2 |
26.2
|
fabric
|
Download |
|
Minescript 5.0b11 for Neoforge 26.2 5.0b11-neoforge-26.2 |
26.2
|
neoforge
|
Download |
|
Minescript 5.0b11 for Fabric 26.1.2 5.0b11-fabric-26.1.2 |
26.1.2
|
fabric
|
Download |
|
Minescript 5.0b11 for Neoforge 26.1.2 5.0b11-neoforge-26.1.2 |
26.1.2
|
neoforge
|
Download |
|
Minescript 5.0b11 for Fabric 26.1 5.0b11-fabric-26.1 |
26.1
|
fabric
|
Download |
|
Minescript 5.0b11 for Neoforge 26.1 5.0b11-neoforge-26.1 |
26.1
|
neoforge
|
Download |
|
Minescript 5.0b11 for Fabric 1.21.11 5.0b11-fabric-1.21.11 |
1.21.11
|
fabric
|
Download |
|
Minescript 5.0b11 for Neoforge 1.21.11 5.0b11-neoforge-1.21.11 |
1.21.11
|
neoforge
|
Download |
|
Minescript 5.0b11 for Fabric 1.21.10 5.0b11-fabric-1.21.10 |
1.21.10
|
fabric
|
Download |
|
Minescript 5.0b11 for Neoforge 1.21.10 5.0b11-neoforge-1.21.10 |
1.21.10
|
neoforge
|
Download |
|
Minescript 5.0b11 for Fabric 1.21.8 5.0b11-fabric-1.21.8 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0b11 for Neoforge 1.21.8 5.0b11-neoforge-1.21.8 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b11 for Neoforge 1.21.5 5.0b11-neoforge-1.21.5 |
1.21.5
|
neoforge
|
Download |
|
Minescript 5.0b11 for Fabric 1.21.5 5.0b11-fabric-1.21.5 |
1.21.5
|
fabric
|
Download |
|
Minescript 5.0b10 5.0b10 |
1.21.11
|
fabric
|
Download |
|
Minescript 5.0b10 5.0b10 |
1.21.11
|
neoforge
|
Download |
|
Minescript 5.0b10 5.0b10 |
1.21.10
|
fabric
|
Download |
|
Minescript 5.0b10 5.0b10 |
1.21.10
|
neoforge
|
Download |
|
Minescript 5.0b10 5.0b10 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0b10 5.0b10 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b10 5.0b10 |
1.21.5
|
fabric
|
Download |
|
Minescript 5.0b10 5.0b10 |
1.21.5
|
neoforge
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.11
|
fabric
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.11
|
neoforge
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.10
|
fabric
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.10
|
neoforge
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.7
|
fabric
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.7
|
neoforge
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.5
|
fabric
|
Download |
|
Minescript 5.0b9 5.0b9 |
1.21.5
|
neoforge
|
Download |
|
Minescript 5.0b8 5.0b8 |
1.21.10
|
fabric
|
Download |
|
Minescript 5.0b8 5.0b8 |
1.21.10
|
neoforge
|
Download |
|
Minescript 5.0b8 5.0b8 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0b8 5.0b8 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b8 5.0b8 |
1.21.7
|
fabric
|
Download |
|
Minescript 5.0b8 5.0b8 |
1.21.7
|
neoforge
|
Download |
|
Minescript 5.0b8 5.0b8 |
1.21.5
|
fabric
|
Download |
|
Minescript 5.0b8 5.0b8 |
1.21.5
|
neoforge
|
Download |
|
Minescript 5.0b7 5.0b7 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0b7 5.0b7 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b7 5.0b7 |
1.21.7
|
fabric
|
Download |
|
Minescript 5.0b7 5.0b7 |
1.21.7
|
neoforge
|
Download |
|
Minescript 5.0b7 5.0b7 |
1.21.5
|
fabric
|
Download |
|
Minescript 5.0b7 5.0b7 |
1.21.5
|
neoforge
|
Download |
|
Minescript 5.0b6 5.0b6 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0b6 5.0b6 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b6 5.0b6 |
1.21.7
|
fabric
|
Download |
|
Minescript 5.0b6 5.0b6 |
1.21.7
|
neoforge
|
Download |
|
Minescript 5.0b6 5.0b6 |
1.21.5
|
fabric
|
Download |
|
Minescript 5.0b6 5.0b6 |
1.21.5
|
neoforge
|
Download |
|
Minescript 5.0b5 5.0b5 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0b5 5.0b5 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b5 5.0b5 |
1.21.7
|
fabric
|
Download |
|
Minescript 5.0b5 5.0b5 |
1.21.7
|
neoforge
|
Download |
|
Minescript 5.0b5 5.0b5 |
1.21.5
|
fabric
|
Download |
|
Minescript 5.0b5 5.0b5 |
1.21.5
|
neoforge
|
Download |
|
Minescript 5.0b4 5.0b4 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0b4 5.0b4 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b4 5.0b4 |
1.21.7
|
fabric
|
Download |
|
Minescript 5.0b4 5.0b4 |
1.21.7
|
neoforge
|
Download |
|
Minescript 5.0b4 5.0b4 |
1.21.5
|
fabric
|
Download |
|
Minescript 5.0b4 5.0b4 |
1.21.5
|
neoforge
|
Download |
|
Minescript 5.0b3 5.0b3 |
1.21.8
|
fabric
|
Download |
|
Minescript 5.0b3 5.0b3 |
1.21.8
|
neoforge
|
Download |
|
Minescript 5.0b3 5.0b3 |
1.21.7
|
fabric
|
Download |
|
Minescript 5.0b3 5.0b3 |
1.21.7
|
neoforge
|
Download |
|
Minescript 5.0b3 5.0b3 |
1.21.5
|
fabric
|
Download |
|
Minescript 5.0b3 5.0b3 |
1.21.5
|
neoforge
|
Download |
|
5.0b2 for Fabric 1.21.5 5.0b2 |
1.21.5
|
fabric
|
Download |
|
5.0b2 for NeoForge 1.21.5 5.0b2 |
1.21.5
|
neoforge
|
Download |
|
5.0b2 for Fabric 1.21.8 5.0b2 |
1.21.8
|
fabric
|
Download |
|
5.0b2 for NeoForge 1.21.8 5.0b2 |
1.21.8
|
neoforge
|
Download |
|
5.0b2 for Fabric 1.21.7 5.0b2 |
1.21.7
|
fabric
|
Download |
|
5.0b2 for NeoForge 1.21.7 5.0b2 |
1.21.7
|
neoforge
|
Download |
|
5.0b1 for Fabric 1.21.8 5.0b1 |
1.21.8
|
fabric
|
Download |
|
5.0b1 for NeoForge 1.21.8 5.0b1 |
1.21.8
|
neoforge
|
Download |
|
5.0b1 for Fabric 1.21.7 5.0b1 |
1.21.7
|
fabric
|
Download |
|
5.0b1 for NeoForge 1.21.7 5.0b1 |
1.21.7
|
neoforge
|
Download |
|
5.0a4 for Fabric 1.21.8 5.0a4 |
1.21.8
|
fabric
|
Download |
|
5.0a4 for NeoForge 1.21.8 5.0a4 |
1.21.8
|
neoforge
|
Download |
|
5.0a4 for Fabric 1.21.7 5.0a4 |
1.21.7
|
fabric
|
Download |
|
5.0a4 for NeoForge 1.21.7 5.0a4 |
1.21.7
|
neoforge
|
Download |
|
5.0a3 for Fabric 1.21.7 5.0a3 |
1.21.7
|
fabric
|
Download |
|
5.0a3 for NeoForge 1.21.7 5.0a3 |
1.21.7
|
neoforge
|
Download |
|
5.0a2 for Fabric 1.21.7 5.0a2 |
1.21.7
|
fabric
|
Download |
|
5.0a2 for NeoForge 1.21.7 5.0a2 |
1.21.7
|
neoforge
|
Download |
|
4.1 for Fabric 1.21.7 4.1 |
1.21.7
|
fabric
|
Download |
|
4.1 for NeoForge 1.21.7 4.1 |
1.21.7
|
neoforge
|
Download |
|
5.0a1 for Fabric 1.21.6 5.0a1 |
1.21.6
|
fabric
|
Download |
|
5.0a1 for NeoForge 1.21.6 5.0a1 |
1.21.6
|
neoforge
|
Download |
|
4.0.1 for NeoForge 1.21.6 4.0.1 |
1.21.6
|
neoforge
|
Download |
|
4.0 for Forge 1.21.6 4.0 |
1.21.6
|
forge
|
Download |
|
[BROKEN!] 4.0 for NeoForge 1.21.6 4.0 |
1.21.6
|
neoforge
|
Download |
|
4.0 for Fabric 1.21.6 4.0 |
1.21.6
|
fabric
|
Download |
|
4.0 for NeoForge 1.21.5 4.0 |
1.21.5
|
neoforge
|
Download |
|
4.0 for Forge 1.21.5 4.0 |
1.21.5
|
forge
|
Download |
|
4.0 for Fabric 1.21.5 4.0 |
1.21.5
|
fabric
|
Download |
|
4.0 for NeoForge 1.21.4 4.0 |
1.21.4
|
neoforge
|
Download |
|
4.0 for Forge 1.21.4 4.0 |
1.21.4
|
forge
|
Download |
|
4.0 for Fabric 1.21.4 4.0 |
1.21.4
|
fabric
|
Download |
|
4.0 for Forge 1.21.3 4.0 |
1.21.3
|
forge
|
Download |
|
4.0 for NeoForge 1.21.3 4.0 |
1.21.3
|
neoforge
|
Download |
|
4.0 for Fabric 1.21.3 4.0 |
1.21.3
|
fabric
|
Download |
|
4.0 for NeoForge 1.21.1 4.0 |
1.21.1
|
neoforge
|
Download |
|
4.0 for Forge 1.21.1 4.0 |
1.21.1
|
forge
|
Download |
|
4.0 for Fabric 1.21.1 4.0 |
1.21.1
|
fabric
|
Download |
|
4.0 for NeoForge 1.21 4.0 |
1.21
|
neoforge
|
Download |
|
4.0 for Forge 1.21 4.0 |
1.21
|
forge
|
Download |
|
4.0 for Fabric 1.21 4.0 |
1.21
|
fabric
|
Download |
|
4.0 for NeoForge 1.20.6 4.0 |
1.20.6
|
neoforge
|
Download |
|
4.0 for Forge 1.20.6 4.0 |
1.20.6
|
forge
|
Download |
|
4.0 for Fabric 1.20.6 4.0 |
1.20.6
|
fabric
|
Download |
|
4.0 for NeoForge 1.20.4 4.0 |
1.20.4
|
neoforge
|
Download |
|
4.0 for Forge 1.20.4 4.0 |
1.20.4
|
forge
|
Download |
|
4.0 for Fabric 1.20.4 4.0 |
1.20.4
|
fabric
|
Download |
|
4.0 for NeoForge 1.20.2 4.0 |
1.20.2
|
neoforge
|
Download |
|
4.0 for Forge 1.20.2 4.0 |
1.20.2
|
forge
|
Download |
|
4.0 for Fabric 1.20.2 4.0 |
1.20.2
|
fabric
|
Download |
|
4.0 for Forge 1.20.1 4.0 |
1.20.1
|
forge
|
Download |
|
4.0 for Fabric 1.20.1 4.0 |
1.20.1
|
fabric
|
Download |
|
4.0 for Forge 1.20 4.0 |
1.20
|
forge
|
Download |
|
4.0 for Fabric 1.20 4.0 |
1.20
|
fabric
|
Download |
|
4.0-beta2 for Fabric 1.21 4.0-beta2 |
1.21
|
fabric
|
Download |
|
4.0-beta2 for NeoForge 1.21 4.0-beta2 |
1.21
|
neoforge
|
Download |
|
4.0-beta2 for Fabric 1.20.6 4.0-beta2 |
1.20.6
|
fabric
|
Download |
|
4.0-beta2 for NeoForge 1.20.6 4.0-beta2 |
1.20.6
|
neoforge
|
Download |
|
4.0-beta2 for Forge 1.20.1 4.0-beta2 |
1.20.1
|
forge
|
Download |
|
4.0-beta2 for Fabric 1.20.1 4.0-beta2 |
1.20.1
|
fabric
|
Download |
|
4.0-beta2 for NeoForge 1.20.2 4.0-beta2 |
1.20.2
|
neoforge
|
Download |
|
4.0-beta2 for Forge 1.20.2 4.0-beta2 |
1.20.2
|
forge
|
Download |
|
4.0-beta2 for Fabric 1.20.2 4.0-beta2 |
1.20.2
|
fabric
|
Download |
|
4.0-beta2 for NeoForge 1.20.4 4.0-beta2 |
1.20.4
|
neoforge
|
Download |
|
4.0-beta2 for Forge 1.20.4 4.0-beta2 |
1.20.4
|
forge
|
Download |
|
4.0-beta2 for Fabric 1.20.4 4.0-beta2 |
1.20.4
|
fabric
|
Download |
|
4.0-beta for Forge 1.20.1 4.0-beta |
1.20.1
|
forge
|
Download |
|
4.0-beta for Fabric 1.20.1 4.0-beta |
1.20.1
|
fabric
|
Download |
|
4.0-beta for NeoForge 1.20.2 4.0-beta |
1.20.2
|
neoforge
|
Download |
|
4.0-beta for Forge 1.20.2 4.0-beta |
1.20.2
|
forge
|
Download |
|
4.0-beta for Fabric 1.20.2 4.0-beta |
1.20.2
|
fabric
|
Download |
|
4.0-beta for NeoForge 1.20.4 4.0-beta |
1.20.4
|
neoforge
|
Download |
|
4.0-beta for Forge 1.20.4 4.0-beta |
1.20.4
|
forge
|
Download |
|
4.0-beta for Fabric 1.20.4 4.0-beta |
1.20.4
|
fabric
|
Download |
|
3.2 for Forge 1.20.4 3.2 |
1.20.4
|
forge
|
Download |
|
3.2 for Fabric 1.20.4 3.2 |
1.20.4
|
fabric
|
Download |
|
3.2 for Forge 1.20.2 3.2 |
1.20.2
|
forge
|
Download |
|
3.2 for Fabric 1.20.2 3.2 |
1.20.2
|
fabric
|
Download |
|
3.2 for Forge 1.20.1 3.2 |
1.20.1
|
forge
|
Download |
|
3.2 for Fabric 1.20.1 3.2 |
1.20.1
|
fabric
|
Download |
|
3.2 for Forge 1.20 3.2 |
1.20
|
forge
|
Download |
|
3.2 for Fabric 1.20 3.2 |
1.20
|
fabric
|
Download |
|
3.2 for Forge 1.19.4 3.2 |
1.19.4
|
forge
|
Download |
|
3.2 for Fabric 1.19.4 3.2 |
1.19.4
|
fabric
|
Download |
|
3.2 for Forge 1.19.3 3.2 |
1.19.3
|
forge
|
Download |
|
3.2 for Fabric 1.19.3 3.2 |
1.19.3
|
fabric
|
Download |
|
3.2 for Forge 1.19.2 3.2 |
1.19.2
|
forge
|
Download |
|
3.2 for Fabric 1.19.2 3.2 |
1.19.2
|
fabric
|
Download |
|
3.2 for Forge 1.18.2 3.2 |
1.18.2
|
forge
|
Download |
|
3.2 for Fabric 1.18.2 3.2 |
1.18.2
|
fabric
|
Download |