SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedAdmin & protection

PySpigot

by magicmq · for Minecraft

A Python scripting engine for your Minecraft server.

3.6KDownloads
16 mo agoLast updated
Spigot · PaperLoaders
1.21Latest game version

About PySpigot

From SpigotMC

A Python scripting engine for your Minecraft server.

Description
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!
Commands​
/pyspigot help: List some useful links (Documentation, Discord, etc.)
/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

Configuration​
Code (YAML):
[/SIZE ] [/SIZE ] # If false, will disable collection of metrics information by bStats for PySpigot. You may also disable bStats server-wide in the bStats config.yml under /plugins/bStats.
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 :
   - ''

Read the full description on SpigotMC →

Highlights

From source data

Game 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

LoaderGame versionsNewest
Paper1.16 to 1.21 (7 versions)1.21
Spigot1.16 to 1.21 (7 versions)1.21

From 10 recorded builds of PySpigot.

Recent builds

BuildReleasedGame versionsLoaders
0.9.12025-07-271.16 to 1.21 (7 versions)Spigot, Paper
0.9.02025-04-30n/aSpigot, Paper
0.8.02025-03-06n/aSpigot, Paper
0.7.12024-12-17n/aSpigot, Paper
0.7.02024-08-19n/aSpigot, Paper
0.6.02024-05-22n/aSpigot, 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 catalog
Listed on SpigotMC as “Admin”

Admin & protection

Permissions, moderation, anti-cheat and land protection for the people running the server.

Runs on your server

From source side support

SpigotMC 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.

NxLabs

Run PySpigot on a Minecraft server.

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