Skip to content

PyFish (python)

Allows to execute python 3.12 scripts, add content, etc. in minecraft and also to make minecraft mod using GraalPy so no python installation is needed to play

FabricNeoForge
Loaders
FabricNeoForge
Downloads on Modrinth
875
Followers on Modrinth
8
versions
19
Updated
September 20, 2026Sep 20
Published
in 2026
This is a library — other mods need it, and it adds nothing to the game by itself

At a glance

A library: other mods need it
Runs on Fabric and NeoForge
For Minecraft 1.21.1, 1.21.11
Needed in the game and on the server
Latest version — 1.2.5 from September 20, 2026
License LGPL-3.0-only — free
Where it's needed
In gamerequiredOn serverrequired

Needed both in the game and on the server

Game versions1.21.1, 1.21.11

curseforge modrinth discord-singular

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.

You can do whatever you want from adding blocks and crafts to your modpack to connecting your LLM API key to your server.

The user don't have to have anything installed for Python to work. This mod has GraalPy (a java Python) and pip integrated in its jar.

You can install every python package that is pure python you want in your mod.

Some Native packages are recoded in Java and included in PyFish. Native libs built-in now : requests, sqlite3, asyncio, logging, pathlib, and websocket

You have to put your scripts in <your_mc_instance>/pyfish/<your_folder>/scripts/ (the name of "your_folder" will be the namespace used to register items, etc.) or in <your_mc_instance>/pyfish/scripts/ (if you put in pyfish/scripts it will register under pyfish's namespace), they are executed automatically.

You can also make .jar mods and also .pyz (100% python) mods.

Fully detailed Documentation (IDE Support now !) here and Support on Discord (the documentation contains the list of every functions available from the MCAPI and how to use them and also all needed informations)

FAQ

How to install PyFish (python)?

Install Fabric for your Minecraft version, download PyFish (python) for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does PyFish (python) support?

PyFish (python) has builds for Minecraft 1.21.1, 1.21.11.

Is PyFish (python) needed on the server?

Needed in the game and on the server

License and source
GNU Lesser General Public License v3.0 onlyfree to use and share; changes to the mod itself must be published under the same license
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More