Minescript
ModRun Python scripts to control and interact with your game world.
Why gradeA
How grades workStrengths
Points lost
- Under 5 million downloads−1 point
All 11 criteria
Maintenance
Full points27 / 27Last releaseHow long ago the newest file came out, or an existing file was marked as working on a new Minecraft version.5 weeks ago (22 Sep 2026) 12 / 12Supports popular versionsWhether the project has a file for a Minecraft version that 15% or more of the popular mods updated in the last 6 months also support. A version many modpacks use, like 1.20.1 or 1.21.1, also counts after a release in the last 12 months.26.3 (latest) on Fabric and NeoForge, 1.21.6 on Forge 9 / 9Regular releasesIn how many of the last 24 months a new file came out. Full points at 8 months.Releases in 15 of the last 24 months 6 / 6Stability
Full points22 / 22Removed from modpacksHow many modpacks removed it in a later version of the pack. We can only see this in modpacks with two or more versions. A pack that swaps it for another edition of the same project, or that is rebuilt from scratch, does not count.1 of the 12 modpacks with two or more versions removed it in a later one (8%) 10 / 10Quick fixesHow often a release needed a quick fix: a new release within 3 days to fix a problem in it.1 of its 29 releases in 2 years needed a quick fix (3%) 7 / 7Known conflictsHow many projects say they do not work with it, compared with how widely it is used. Packs, small projects, forks, ports, add-ons, alternatives and old versions do not count.None 5 / 5Transparency
Full points10 / 10Source codeWhether the project page links to its source code, so anyone can read what it does.GitHub · maxuser0/minescript 7 / 7Place to report problemsWhether the project page links to a place where players can report problems: an issue tracker.GitHub issues · maxuser0/minescript 3 / 3Popularity
1 point lost3 / 4DownloadsDownloads on Modrinth and CurseForge. Full points from 5 million.102,145 3 / 4Track record
Full points8 / 8AgeHow long the project has existed. It counts less when no new file came out recently.4.2 years, 203 releases 8 / 8Security
PassedFile checksThis check adds no points. It can only take points away.Our checks found nothing harmful in all 30 latest files for recent Minecraft versions. See Security
70 of the 71 points that apply = 99 out of 100.
Images
About
Minescript is a platform for controlling and interacting with Minecraft through scripts written in Python and other scripting languages. Scripts can be launched as commands from the in-game chat, and the built-in library lets them read player position, inspect blocks, inventory, and nearby entities, send chat messages, and execute Minecraft commands. This enables practical automation and custom interactions, such as creating a sign that displays the block beneath the player along with its coordinates, with a script argument controlling the sign’s rotation. Built-in commands also support evaluating code directly, copying and pasting block regions between locations or worlds, and managing running script jobs. Minescript 5 integrates Pyjinn, an interpreter for Python-syntax scripts that runs within Minecraft’s Java process without a separate Python installation, while continuing to support standard Python scripts run as separate processes. Pyjinn scripts can respond to events such as ticks, rendering, keyboard and mouse input, chat, block updates, and entity additions, and can use asynchronous event handling with async/await.
Written from Modrinth and the GitHub README . How we write it
In-game changes
Changes the game's code in 5 areas: Game optionsChanges 3 game code files in this area: settings, key bindings and the option screens., User interfaceChanges 2 game code files in this area: menus, screens, tooltips, the chat window and the in-game overlay., Networking and multiplayerChanges 2 game code files in this area: connections, the server list and what is sent between your game and a server., World renderingChanges 1 game code file in this area: drawing the terrain, sky, clouds and weather. and Rendering and graphicsChanges 1 game code file in this area: drawing mobs, items, particles and textures on screen..
Adds no new blocks, items or other content.
Keeps all of vanilla Minecraft's textures, models and sounds.
Details
- Creator
- maxuser
- Downloads
- 102K
- Created
- 9 Aug 2022
- Official pages
- Modrinth , CurseForge
- Links
- Source code , Issues , Wiki , Discord
Security
No harmful code found
We checked its files and read their code, without running it.
What it can do on your computer
- Starts other programs
- It can start another program on your computer, for example to open a link in your browser.
- Uses folders outside the game
- It can read or write files outside your Minecraft folder, on the rest of your computer. Found: your user folder.
- Creates settings files
- The mod keeps its settings in the config folder of your game, where you can change or delete them. 4 files in your config folder.
Why we show this: a mod runs on your computer like any program, so harmful code in it can take your accounts or files. Our checks look for known signs of harm. They cannot prove that a file is harmless. In the grade: malware means no grade, and a Warning in a latest file for a recent Minecraft version lowers it.
How we checked
- FilesWe download the files from Modrinth or CurseForge and look at what is inside them and what their code can do, without running them. Fixed rules tell what is harmful.57 latest files: the newest file for each Minecraft version and loader. The answer above is about the 30 for recent versions. Recent versions: those released in the last 2 years, plus 1.20.1 and 1.21.1, among the most played in modpacks. See each file in Releases
- Their codeWe turn the code of the files back into readable code and follow what it does, without running it. This shows what it downloads, what it sends and where your login goes.Read without running it
- Author on ModrinthThe disclosure form on Modrinth, where the author declares that the project reads or edits things on your system outside the game. Since 13 Aug 2026, Modrinth's rules require it when this applies.Nothing declared about your system outside the game.
- Starts other programsPurpose not known.
- Looked for, not foundWe looked for these in the file and did not find them.The internet, updating itself, the webcam or microphone, an AI service.
Privacy
We found nothing it sends
We read its code without running it: it contacts no web address while you play.
Why we show this: a mod can send things about you over the internet, like your player name or your login. Contacting an address to check for updates or download files sends nothing about you. Not in the grade: sending data can be normal for what a mod does.
How we checked
- Files readWe read the code without running it. We list each web address the code contacts while you play, and what it sends. Code that is never used is left out.The code of all 30 files, for recent Minecraft versions. See each file in Releases
- Author on ModrinthThe disclosure form on Modrinth, where the author declares crash reports, usage data and advertisements. Since 13 Aug 2026, Modrinth's rules require it when a project collects data on its users or shows advertisements.Nothing declared about crash reports, usage data or advertisements.
AI
No sign so far that AI was used to make it
We looked for AI tools in its texts, files and images and found none.
We have not read its code history yet.
No sign of AI in the game
We found no AI service, AI library or AI model file in its code.
Why we show this: some players and servers avoid projects made with AI, and AI in the game can send what you write to an online service. Not in the grade: using AI does not tell whether a project works well or is kept up to date.
How we checked
- Author on ModrinthThe disclosure form on Modrinth. Since 13 Aug 2026, Modrinth's rules require it when a substantial part of the code is AI output, when an asset is mainly AI output, or when the project or its page relies on generative AI.No AI content or AI features declared.
- Code historyThe public code on GitHub: who made each change, credit lines such as "Co-authored-by", and its files.Not read yet
- Description and changelogsThe description, project page and newest changelogs: sentences saying an AI tool was used, and text pasted from an AI chat.Nothing found2 of 40 changelogs read
- Its filesFiles that AI coding tools leave behind (like AGENTS.md), and the texts inside the files you download.Nothing found
- Images in its filesHidden data in the images of the files you download, where AI image tools write their name and settings.Nothing found1 image read
- Code of the modThe code and files of the mod, read without running it: addresses of AI services, AI libraries, AI model files and a place for your own AI key.No AI service, AI library or AI model file833 code files read
Compatibility
See all 203 filesPoint at or tap a version to see its loaders.
Related projects
Projects that need Minescript to work.
Modpacks using this project
Find modpacks with itModpacks that include Minescript in at least one of their versions, most downloaded first.
Builder's Delight2.5K downloadslast version with it 14 Dec 2024
TheBlockAcademy1.6K downloadslast version with it 23 May 2026
hy(pixel)1.3K downloadslast version with it 27 Mar 2026
Artemiscraft: Awakening of the Elements1.2K downloadslast version with it 7 Dec 2025
Create The Creator1.2K downloadslast version with it 3 Nov 2025
PitCraft709 downloadslast version with it 4 Nov 2024
BestOFBedrock [Fabric]626 downloadslast version with it 5 Sep 2022
Cow-Chan Modpack Mini531 downloadslast version with it 20 Mar 2024
Carbonized520 downloadslast version with it 8 Apr 2024
Minecraft Enhanced489 downloadslast version with it 22 Jan 2025Latest files
The newest file for each Minecraft version and loader. The files for recent versions come first. Recent versions: those released in the last 2 years, plus 1.20.1 and 1.21.1, among the most played in modpacks.
203 releases
Quick fixes
In the last 2 years, 1 release needed a quick fix: a new release within 3 days to fix a problem. This counts in the grade, but it is too few to lose points.
See them, newest first
Quick fixesReleases followed within 3 days by a new release that fixes a problem in them.1
- minescript-neoforge-1.21.5-5.0b5…Fix missing JobInfo.self returned from job_info() ([f733d2e…