PyFish (python)
by OesphyGG
PyFish lets players and modpack makers run Python 3.12 scripts inside Minecraft, with GraalPy and its own Python runtime bundled.
What it does
Scripts placed in the pyfish/scripts folder run automatically when the game starts. Each script can use the Minecraft API to set blocks, summon entities, listen for events and register items, blocks, creative tabs and tags under a chosen namespace. Since the last update, registration covers the full set of content types, so a script can build a small content pack without any Java code.
No Python installation is needed on the player's machine, because the runtime comes with the mod. Pure Python packages can be added to the mod as well, and common standard-library pieces such as requests, sqlite3, asyncio, logging, pathlib and websocket are included. Some native packages were recoded in Java and ship inside PyFish, so they work without a separate build step.
PyFish is published for Fabric and NeoForge, with builds for 1.21.1 and 1.21.11 and the latest file, 1.2.5, dated 2026-09-20. Every player and the server need a copy of the mod. The code is open source under the GNU Lesser General Public License v3.0 only, and the project has public source code and a wiki.
Key features
Python 3.12 scripting
Scripts written in Python 3.12 run in the game and can call the Minecraft API to change the world.
Automatic script loading
Files in pyfish/scripts run on startup, and content registered from a script uses the namespace the author picks.
Bundled runtime
GraalPy and the Python pieces it needs are built in, so players install nothing extra on their computers.
Pure Python packages
Any pure Python package can be installed for a mod, and several standard libraries are already available.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
PyCraft IDE is a Fabric mod for 1.21.1 that runs on client and server under a custom license and is not open source. JsMacros Community Edition is open source under the Mozilla Public License 2.0, supports Fabric and NeoForge for 1.21.5 – 1.21.11, and is client-side only, so it needs nothing on the server. JythonMC uses Jython, is open source under the MIT License, and targets 1.16.2 – 1.17.1 on Fabric, with a client or server optional environment.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| PyFish (python) | Fabric and NeoForge | 1.21.1 – 1.21.11 | Client and server | 2026-09-20 |
| PyCraft IDE | Fabric | 1.21.1 | Client and server | 2026-09-29 |
| JsMacros Community Edition | Fabric and NeoForge | 1.21.5 – 1.21.11 | Client-side only | 2026-03-24 |
| JythonMC | Fabric | 1.16.2 – 1.17.1 | Client or server, optional | 2021-10-06 |
Questions
Does PyFish have to be installed on the server?
Do players need Python installed to use PyFish?
Which loaders and versions does PyFish support?
Where do scripts go?
In the catalog
PyFish (python) is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 19,862 mods support Minecraft 1.21.11.
More from OesphyGG
Similar mods
What the author says
A mod that allows you to execute python scripts or to make your own mods using python. It has a "Minecraft" API that allows you to set blocks, summon entities, listen to events, etc. and since the last update you can also register items, blocks, creative tabs, tags, etc. under the namespace you want.
Official listing
- Modrinth page
- modrinth.com/mod/pyfish-python
- Owner
- OesphyGG
- Published
- 2026-01-25
- Updated on Modrinth
- 2026-09-20
- Facts verified
- 2026-10-15