Skip to main content

​
限制与安全

​
默认限制

网格上限还会按可用内存预算进一步收紧。

​
--force-limits

--force-limits 会提高以下上限：
  • 输入文件和总 NBT 分配预算
  • 场景/region 体积
  • mesh quads、vertices、pages
  • render 像素上限
它不会绕过线程、纹理、NBT 深度、NBT tag 数等固定限制。该选项可能让进程耗尽 内存，只应对可信输入使用。

​
安全边界

  • serve/supervise 只通过 stdio 通信，不监听网络端口
  • 输入必须是普通文件；目录、FIFO、设备和超限文件会被拒绝
  • 输入路径和输出目录由调用方控制；请使用专用低权限用户运行
  • 不要在未校验路径和资源包的情况下把服务暴露给不可信客户端
  • 资源包和客户端 jar 由部署者提供，仓库不分发 Minecraft 资产

​
错误码

协议错误码、可重试性和 manifest 字段见 引擎协议 v1。常见错误：
  • INPUT_TOO_LARGE：输入或资源超限
  • INVALID_REQUEST：请求格式错误、相对路径或非普通文件
  • INVALID_RENDER_OPTIONS：尺寸、光照、背景或线程数非法
  • MESH_LIMIT_EXCEEDED / PAGE_LIMIT_EXCEEDED：网格上限
  • INVALID_NBT / INVALID_LITEMATIC：文件损坏或格式不支持
  • ASSET_SOURCE_REQUIRED：materials 缺少资源包或客户端 jar

​
相关文档