Peripheral
by Sl0oth_
Peripheral is a Fabric client mod that lets players control Minecraft with Python scripts, which can automate tasks, build HUDs and create custom GUIs.
What it does
Scripts run in the background, and several can start, stop and run independently of each other. Scripts can read live game data, control the player, build custom GUIs and render overlays, all without touching Java. A script folder is dropped into the game directory, then run and watched from the in-game interface.
The mod opens a small local interface inside the game on port 25585 and adds a helper module called mc that scripts import. That interface only accepts connections from the same machine and never reaches out to a remote host. The mod is released under the MIT License and is open source, with its source code and issue tracker public. It requires no extra dependencies beyond Fabric, and works in singleplayer, multiplayer and Realms. Files exist for 1.21 – 26.1.2, and the latest Fabric file is 1.1.0 for 26.1.2, released on 2026-04-27 on the beta channel.
Key features
Script runner
Scripts run in parallel, start and stop individually, and can be triggered from the in-game GUI.
Text and labels
Labels can show text with color and shadow, placed anywhere on screen.
Progress bars
Bars can show progress for health, durability, experience or any other value a script reads.
Panels and item sprites
Rectangles serve as background panels with an optional border, and item sprites draw Minecraft item icons by ID.
Anchored positioning
Elements anchor to a screen corner or the center and scale with the resolution.
Compatibility
Latest build for each game version and loader.
26.x3 of 3 versions with builds
1.21.x12 of 12 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
AnyBind is a Fabric client-side mod for 1.21 – 26.3 under the GNU General Public License v3.0 only, and it is open source. Minescript Addons is a Fabric client-side mod for 1.21.5 – 1.21.11 under the MIT License, and it is open source. JsScripts is a Fabric mod for client and server, covering 1.21.8 – 26.1.1, and it is not open source under All rights reserved.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Peripheral | Fabric | 1.21 – 26.1.2 | Client-side only | 2026-04-27 |
| AnyBind | Fabric | 1.21 – 26.3 | Client-side only | 2026-09-21 |
| Minescript Addons | Fabric | 1.21.5 – 1.21.11 | Client-side only | 2026-07-19 |
| JsScripts | Fabric | 1.21.8 – 26.1.1 | Client and server | 2026-04-01 |
Questions
Does Peripheral need to be installed on the server?
Can scripts access the internet?
In the catalog
Peripheral is one of 8,499 Technology mods on ModsFinder, and one of 4,201 Technology mods for Fabric. 15,189 mods support Minecraft 26.1.2.
More from Sl0oth_
Similar mods
What the author says
Write.py scripts that read live game data, control your player, build custom GUIs, and render always-on HUD overlays — all without touching Java. Drop a script in a folder, hit run, and watch it go. Peripheral runs a lightweight HTTP server inside Minecraft (localhost:25585) and injects a helper module called mc into…
Official listing
- Modrinth page
- modrinth.com/mod/peripheral
- Owner
- Sl0oth_
- Published
- 2026-03-26
- Updated on Modrinth
- 2026-04-27
- Facts verified
- 2026-10-15