Uniporter - 统一端口服务器

Uniporter

Uniporter 是一个基于 Netty 的 Minecraft 插件，它允许在同一个服务器端口上运行多种协议。目前支持 HTTP/1.1 标准和常规 SSL，未来将添加更多协议。插件未直接使用 NMS 代码，已在 Spigot 1.17 和 1.12.2 上测试通过。

💡快速开始

• 将 jar 文件放入 /plugins 文件夹。
• 启动或重载服务器。
• 修改 /plugins/Uniporter/route.yml 配置文件。
• 将一些 HTML 文件放入 /plugins/Uniporter/static/ 目录，或 route.yml 中指定的其他路径。
• 重启或重载服务器。

完成！默认情况下，访问 http://服务器IP:25565（假设你的 Minecraft 服务器运行在 25565 端口）将会显示内容。

🔧开发者提示

如果你想利用编程能力实现更高级的功能，虽然开发者文档尚未完成，但 Javadoc 已经就绪。

• Javadoc 在哪里？在源代码中！
• 查看 cn.apisium.uniporter.Uniporter 和 cn.apisium.uniporter.example 包，你就能明白其工作原理。

❓常见问题

兼容性

• Q: 它支持版本 x.xx.x 吗？

由于插件使用的是常规 Netty 代码和一个非硬编码的反射辅助工具，它很可能兼容所有现代 Minecraft Bukkit/Spigot/Paper 服务器。但不能保证在任何 Forge 或 Fabric 混合服务器上工作，因为不确定它们如何处理 Netty 通道实例。此问题将在未来解决。

• Q: 它会破坏原版机制吗？

-   **游戏性方面**：不会。代码设计上对原版游戏玩法是无害的。

-   **网络方面**：某种程度上会，但不会破坏任何东西。技术解释如下：插件需要读取握手数据包的第一个字节（就像旧版服务器 Ping 处理器那样）。因此，如果存在一个来自原版、以特定字节开头的握手数据包，它就会失效。幸运的是，据我所知，至少在 1.17.x 及以下版本中不存在这样的数据包。

• Q: 它会与插件 xxx 兼容吗？

很可能兼容，除非那些插件改变了服务器的默认 Netty 行为（这种情况应该非常非常罕见）。

其他

• Q: 为什么不创建一个中文版 Readme？

因为我不想重写整个文档两次。当然，欢迎你进行翻译！PR 欢迎！

> 我知道这份文档信息尚不充分，我稍后会做更多工作。目前，如果你有任何疑问，请提交 Issue。

官方支持的语言

提交 Issue 时，官方支持以下语言

• 英语（你可能已经注意到这不是我的母语）
• 中文（简体或繁体均可，但我会用简体中文回复）
• “火星文”，即中文风格的火星语言