Skip to content

PySpigot

一个用于Minecraft服务器的Python脚本引擎。

中文翻译供DC商业梦想城社区学习使用

GitHub release (latest by date) Latest snapshot Develop GitHub commits since latest stable release (by SemVer)

PySpigot是什么?

PySpigot是一个Spigot/Bukkit插件,作为运行在Minecraft中的Python脚本引擎。用户可以编写Python脚本,简单来说就像是"迷你插件"。由于PySpigot完全在Minecraft环境中运行在Java上,脚本可以访问整个服务器,包括整个Bukkit API,以及其他插件的API。使用PySpigot,您可以编写一个脚本,实现与插件相同的功能,但耗时仅为其中的一小部分。PySpigot也非常适合那些懂Python但不懂Java的个人。PySpigot很像Skript,但功能更加强大。

PySpigot能做什么?

  • 快速编写Python脚本


    PySpigot脚本可以做与插件相同的事情。不过,编写PySpigot脚本只需写插件所需时间的一小部分。

    PySpigot对于懂Python但不懂Java的人来说也很方便-无需Java经验!

  • 编写多模块项目


    PySpigot完全支持编写多模块项目。这些类似于多模块Python项目,提供更理想的代码组织和结构化。

  • 易于使用


    PySpigot的功能设计考虑了使用便捷性。对于简单任务易用,但你也可以创建非常复杂的脚本。可能性无限!

  • 无限制的Bukkit API访问


    由于PySpigot运行在Minecraft/Java环境中,PySpigot脚本可以完全访问Bukkit/Spigot API。

    注册事件监听器,创建命令,调度任务,处理配置文件等等!

  • 全面的错误记录


    PySpigot包括基于每个脚本的全面错误记录,可输出到控制台和特定脚本的日志文件,使调试变得尽可能简单。

  • 完全支持外部Java/Python库


    PySpigot完全支持加载和使用外部库,如Apache Commons库。

  • 高度可配置


    PySpigot 的设计目的是尽可能可配置。有几个可编辑的脚本特定选项,以及各种可配置的插件级选项。

  • 全面支持MySQL、MongoDB和Redis


    PySpigot 包括对 MySQL、MongoDB 和 Redis 的支持,并大大简化了这些操作。

  • 完整支持 ProtocolLib


    PySpigot 内置了对 ProtocolLib 的支持,使得处理数据包变得轻松。支持注册数据包监听器、数据包修改和发送数据包。

  • 完整支持 PlaceholderAPI


    PySpigot 也内置了对 PlaceholderAPI 的支持,方便注册占位符扩展。

  • 开源,使用 Apache 2.0 许可


    PySpigot 的源代码完全开放在 GitHub 上,并在 Apache 2.0 许可 下授权使用。

  • 以及更多!


    我在不断努力开发新功能和改进,致力于让 Minecraft 中的脚本编写体验更加完美。

    欢迎提供建议。如果您有新功能的想法,请提交功能请求

示例

查看任何 示例 以了解 PySpigot 脚本的一些示例。

入门指南

请查看 快速入门指南 进行简要教程。查看文档的其余部分以获取更高级的用法。

Discord

PySpigot有一个官方Discord服务器,里面有帮助频道、bug报告等。我通常会在Discord上活跃,所以如果你想联系我,加入Discord服务器是一个很好的方式。点击这里加入Discord服务器。

统计信息

PySpigot使用bStats来收集匿名的PySpigot使用数据。我利用这些数据来了解PySpigot的用户,包括他们来自哪个国家(这样我就可以提供流行的非英语语言支持),以及用户最喜欢使用的Minecraft和Java版本。bStats还搜集一些其他有用的数据,包括服务器软件(Spigot、Paper、Purpur等)、插件版本和加载的脚本数量。不会搜集敏感或可识别的信息。

如果你想选择退出此功能,在PySpigot的配置文件中将metrics-enabled设置为false。另外,你也可以通过在/plugins/bStats/config.yml中将enabled设置为false来在整个服务器范围内禁用bStats。

授权信息

PySpigot采用Apache 2.0许可证。更多信息请查看许可证信息页面。