**Minescript** is a platform for controlling and interacting with Minecraft using scripts written in the Python programming language.<\/p>\n
Before using **Minescript**, please review the Terms of Use.<\/p>\n
Join the Minescript Discord Server for announcements and to engage with the Minescript community.<\/p>\n
Check out Minescript documentation for details about commands and APIs.<\/p>\n
Download Python scripts developed for use with Minescript.<\/p>\n
**Setup**
\n1. Download and install the Minescript mod for either Fabric (requires Fabric API) or Forge.<\/p>\n
2. Download and install Python 3 if you don’t already have it: https:\/\/www.python.org\/downloads\/ (or from the Microsoft Store on Windows)<\/p>\n
3. 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.<\/p>\n
4. Create Python scripts in the minescript folder.<\/p>\n
5. Run Python scripts from the Minecraft in-game chat by entering backslash (“\\”) followed by the script name without the “.py” extension.<\/p>\n
Minescript expects Python to be installed at the following location:<\/p>\n
– on Windows: `%userprofile%AppDataLocalMicrosoftWindowsAppspython3.exe`
\n– on Mac, Linux, etc: `\/usr\/bin\/python3`<\/p>\n
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. <\/p>\n
**Example**<\/p>\n
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.<\/p>\n
**Compatibility**
\nTested on the following platforms:
\n– Fabric, Forge, and NeoForge mod loaders
\n– Python 3.7 through 3.10
\n– macOS up to Sonoma
\n– Linux (Pop!_OS, NixOS, Bazzite, and SteamOS)
\n– Windows 10 and 11 (x86)<\/p>\n","protected":false},"excerpt":{"rendered":"
Python scripting for Minecraft<\/p>\n","protected":false},"featured_media":102456,"template":"","meta":{"_minecraft_slug":"minescript","_minecraft_project_id":"KcpXWngB","_minecraft_author":"maxuser","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":50653,"_minecraft_follows":128,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"minescript.zip","_minecraft_size_bytes":124710990,"_minecraft_version_count":158,"_minecraft_updated_at":"2026-05-16T08:51:28.447611Z","_minecraft_date_created":"2023-12-03T00:29:46.182674Z","_minecraft_date_modified":"2026-04-16T01:57:07.508106Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/minescript","_minecraft_icon_attachment_id":102456,"_minecraft_imported_at":"2026-06-05T21:15:05+00:00","_minecraft_import_hash":"49ab9290c6c851eb063b5652e485c7b2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,89,126,158,123,92],"mod_loader":[99,160],"minecraft_version":[53,56,57,58,59,36,60,94,102,62,37,40,41,74,38,78,79,80,81,83,163],"class_list":["post-102455","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-management","mod_category-neoforge","mod_category-technology","mod_category-utility","mod_loader-fabric","mod_loader-neoforge","minecraft_version-1-18-2","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-4","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-26-1","minecraft_version-26-1-2"],"yoast_head":"\n