About PySpigot
From SpigotMCA Python scripting engine for your Minecraft server.
PySpigot is a Python scripting engine for your Minecraft server. It allows you to create scripts, which act as "mini-plugins": they can register event listeners, commands, schedule tasks, and more!
PySpigot is a lot like Skript, but much more powerful. PySpigot utilizes Jython, a Python implementation that runs entirely on Java. This means that PySpigot scripts have full access to the entire Bukkit/Spigot API, as well as APIs of any other loaded plugins. In general, a PySpigot script can do anything Python can do, and anything a plugin can do as well.
Currently supports Spigot and Paper, on 1.16 and newer. There is currently an unofficial, preliminary release of PySpigot for BungeeCord available for open testing. Download it here.
For complete documentation on the plugin and writing scripts, visit https://pyspigot-docs.magicmq.dev.
For support, and to stay in the loop regarding updates, join the official Discord: https://discord.gg/f2u7nzRwuk
Features
- Load scripts on server start and via commands
- Stop, reload, and unload server scripts via commands
- Support for both single-file scripts and multi-file projects
- Register event listeners
- Register commands
- Schedule tasks (synchronous and asynchronous)
- Work with config files
- Register ProtocolLib packet listeners
- Register PlaceholderAPI placeholder expansions
- Comprehensive logging of errors and exceptions on a per-script basis, to file
- Load Java libraries you'd like to work with at runtime
- Write scripts in Python syntax
- Scripts have complete access to the Bukkit/Spigot API, as well as APIs of other plugins, so anything is possible.
- Support for working with SQL, Mongo, and redis servers
- And more!
/pyspigot info <scriptname/projectname>: Displays detailed information about a script or project, including uptime, registered listeners, commands, and more info
/pyspigot listscripts: List loaded and unloaded scripts and projects
/pyspigot load <scriptname/projectname>: Load a script or project with the given name
/pyspigot loadlibrary <libraryname>: Load a Java library with the given name
/pyspigot reloadall: Reload the entire plugin, including scripts, projects, libraries, and config
/pyspigot reload <scriptname/projectname>: Reload a loaded script or project
/pyspigot reloadconfig: Reload PySpigot's config.yml
/pyspigot unload <scriptname/projectname>: Unload a script or project
metrics-enabled : true
# The delay for loading scripts (in ticks) after the server finishes loading.
script-load-delay : 20
# List of relocation rules for libraries in the libs folder. Format as <pattern>|<relocated pattern>
library-relocations : [ ]
# Date/time format for timestamps in script log files, written in Java's SimpleDateFormat pattern: https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/format/DateTimeFormatter.html
log-timestamp-format : 'MMM dd yyyy HH:mm:ss'
# If true, will print log messages to console every time a script is loaded, run, and unloaded.
script-action-logging : true
# If true, will log all redis events to the console and to a script's logger. If false, will only log reconnect events (reconnect attempts and failures)
verbose-redis-logging : true
# If true, scripts will be automatically unloaded if a plugin the script depends on is unloaded. This is especially useful to ensure script shutdown tasks that require a depending plugin complete successfully (prior to the plugin being unloaded).
script-unload-on-plugin-disable : true
# Options that pertain to Jython. Changing options in this section requires a server restart.
jython-options :
# If true, the Jython runtime will be initialized during plugin load/server start. If false, the Jython runtime will not be initialized until the first script is loaded.
init-on-startup : true
# A list of system properties that will be passed to Jython. For a complete list, see https://javadoc.io/doc/org.python/jython-standalone/latest/org/python/core/RegistryKey.html
properties :
- 'python.cachedir.skip=true'
# A list of args to pass to Jython when initialized. Equivalent to sys.argv in Python.
args :
- ''
Highlights
From source dataGame versions
Supports 7 Minecraft versions, the newest being 1.21.
Loaders
Runs on Spigot and Paper.
Footprint
Rated a light load on a server.
PySpigot on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Spigot, Paper
- Server load
- light
- Smallest plan we suggest
- Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 0.9.1, released 2025-07-27
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 1.16 to 1.21 (7 versions) | 1.21 |
| Spigot | 1.16 to 1.21 (7 versions) | 1.21 |
From 10 recorded builds of PySpigot.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 0.9.1 | 2025-07-27 | 1.16 to 1.21 (7 versions) | Spigot, Paper |
| 0.9.0 | 2025-04-30 | n/a | Spigot, Paper |
| 0.8.0 | 2025-03-06 | n/a | Spigot, Paper |
| 0.7.1 | 2024-12-17 | n/a | Spigot, Paper |
| 0.7.0 | 2024-08-19 | n/a | Spigot, Paper |
| 0.6.0 | 2024-05-22 | n/a | Spigot, Paper |
Run PySpigot on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogAdmin & protection
Permissions, moderation, anti-cheat and land protection for the people running the server.
Runs on your server
From source side supportSpigotMC lists PySpigot as required on the server. Check its SpigotMC page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- SpigotPaper
- Runs on
- Serverrequired on the server
- Game versions
- 1.21 and 6 earlier
- Requires
- One-click install needs a Paper server.
Verified at the source
- ✓SpigotMCOfficial listing, checked 2026-10-16Open ↗
- ✓Authormagicmq, as published on SpigotMC
- ✓LicenseNot published by the sourceFree
PySpigot, answered
Generated from the mod’s own source data.
Do my players need to install PySpigot?
SpigotMC lists PySpigot as required on the server. Check its SpigotMC page to see whether players need it too.
Which loaders does it support?
Spigot and Paper.
Is it free?
Yes. PySpigot is free to download from SpigotMC.
How do I add it to my Nxeon server?
Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

Run PySpigot on a Minecraft server.
Deploy in about a minute from $4.20 a month, then add PySpigot in one click.









