?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
PySpigot

PySpigot

A Python scripting engine (plugin) for Minecraft servers running Bukkit or one of its forks (Spigot, Paper, etc.).

173
7

Compatibility

Minecraft: Java Edition

1.21–1.21.4
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x

Platforms

75% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Links

Report issues View source Visit wiki Join Discord server

Creators

magicmq Member

Details

Licensed Apache-2.0
Published 3 months ago
Updated last month

PySpigot 0.8.0

by magicmq on Mar 6, 2025
Download

This update contains key bug fixes and performance improvements, as well as some minor additions/changes.

Additions:

  • Script start and stop functions now optionally accept one parameter, the script object, which is passed to the functions by PySpigot when they are called
  • Added support for relational placeholders in script PlaceholderAPI expansions
  • Added a new function.py helper module, bundled into the PySpigot JAR file, that wraps Java functional inferfaces in a Python-friendly format
  • Added Jython-specific options to the config.yml, including initialization on startup, Jython properties, and args/sys.argv

Changes:

  • The pyspigot.py helper library is now precompiled and bundled into the /Lib folder within the PySpigot JAR file. It is no longer copied into the python-libs folder. You can safely delete the pyspigot.py and corresponding pyspigot$py.class files from the python-libs folder.
  • The auto-pyspigot-lib-update-enabled was removed
  • Jython is now initialized on server startup/plugin load by default, rather than when loading the first script, which increases performance in most cases
  • Updated several example scripts to use the latest recommended PySpigot features
  • Reformatted and removed some redudancy from script error messages in console
  • The plugin prefix is now hard-coded (no longer defined in the config.yml), and the footer was removed from the /pyspigot help command
  • Increased precision when reporting Java library load times
  • A lot of code cleanup and miscellaneous improvements
  • Updated several dependencies to their latest versions

Bug Fixes:

  • Fixed an issue where Paper was unnecessarily relocating Jython internals, which resulted in diminished performance
  • Fixed an issue where PySpigot managers were being shut down if they weren't initialized first
  • The Database manager now specifies default HikariCP properties if none are explicitly defined

This release also contains a preliminary release for a BungeeCord-compatible version of PySpigot. This is not an official release because I have not comprehensively tested it. Download it here. Feel free to test it out and report issues on GitHub or Discord.

See the complete change log for this update here: https://github.com/magicmq/pyspigot/releases/tag/v0.8.0

PySpigot 0.7.1

by magicmq on Dec 22, 2024
Download

0.7.1 Update

This update is a minor release, and it only contains one new feature (custom script events) as well some minor bug fixes and code improvements.

The bigger news with this update is that the new documentation site is live! Check it out here.

Additions:

  • Added a CustomEvent that an be created and called by scripts to signal a custom event to other scripts/plugins (visit the docs for more information)
  • Added another example script

Changes:

  • Updated all dependencies to latest versions (including Jython to 2.7.4)
  • Minor code improvements/cleanup
  • Minor improvements to config file comments and JavaDocs

Bug Fixes:

  • Fixed an issue with log messages not being printed correctly when running regular Spigot server software
  • Fixed an issue with the library manager attempting to load non-JAR files and folders

See the complete change log here.