1.17.1 Paper服务器加载数据包函数报Not Supported错误求因

错误根因 #

该报错属于1.17.1早期版本Paper核心的已知内置bug，和数据包开发内容无关：该版本Paper的非默认函数权限等级校验逻辑未完成实现，加载函数时就会抛出对应的Not supported yet异常。

可行解决方案（按优先级排序） #

• 优先替换Paper核心版本：当前使用的构建版本（git-Paper-08f746f）属于1.17.1的不稳定测试版，直接下载1.17.1的最新正式稳定版Paper核心，替换服务器目录下的现有paper.jar即可，不需要修改任何数据包内容或服务器配置，重启后即可正常加载函数。
• 临时修复方案：如果暂时不想更换服务端核心，可以先把server.properties里的function-permission-level参数从3改回默认值2，即可避开触发该bug的校验分支，重启服务器后即可正常加载函数。
• 备选测试方案：如果以上操作都暂时无法执行，可以临时用同版本的Spigot核心替换Paper核心跑开发测试，Spigot 1.17.1不存在该逻辑bug，不影响正常调试数据包功能。

内容的提问来源于stack exchange，提问作者DarkyyBoi