Skip to content

导入与管理拓展 ​

拓展管理页在 设置 → 拓展。刚装好的拓展一律是禁用状态,看完权限再启用。

导入 ​

两种方式都支持一次装多个:

方式操作说明
按钮导入点「导入拓展」,在文件对话框里多选接受 .tmlext 和 .jar
拖拽导入把文件直接拖进启动器窗口拓展页内两种格式都收;其它页面只拦 .tmlext,.jar 仍按 Mod 处理

拖进拓展页时会出现全页提示「松开鼠标,导入拓展」,松开就开始安装;夹在里面的非拓展文件会被忽略,并提示忽略了几个。 以管理员身份运行时,窗口拖放走的是另一条系统通道,.tmlext 也一样会被接住,不会当成 Mod 装进游戏目录。

TIP

导入只是把包放进数据目录的 extensions/,不会立刻运行。先点「详情」看它申请了什么,再决定要不要启用。

页面上的信息 ​

顶部一行是概要:已安装、已启用、出错、缺少运行环境各有多少。下面每个拓展一张卡片:

  • 名称、版本、状态徽标(已启用 / 已禁用 / 出错 / 缺少运行环境)。
  • 作者、运行时、包格式、是否已解包。
  • 描述,以及申请的权限和订阅的事件。

每个卡片三个按钮:

按钮作用
详情标识、版本、作者、运行时、入口、支持平台、权限、订阅事件、SHA-256、解包目录、私有数据目录;出错时还会显示错误原因
启用 / 禁用启用前弹出权限清单让你确认;禁用会停掉独立子进程,文件保留
卸载二次确认后删除拓展包与它的私有数据

页面顶部另有「刷新」(重新扫描 extensions/)和「打开拓展目录」。

权限确认与自动启动 ​

  • 首次启用会列出这个拓展申请的权限,确认后才会拉起独立子进程。
  • 同一个包确认过一次就会记住,之后再启用不再重复弹窗;换了包或包内容变了(SHA-256 对不上)才会重新问一次。
  • 上次退出时处于启用状态的拓展,下次启动会自动拉起。
  • 启用状态与信任记录写在 extensions/trusted.json;包内容被改动会提示「拓展已被修改」并拒绝加载。

出错时 ​

现象处理
缺少运行环境装好对应解释器 / 运行时后点「刷新」;启动器不会自动下载运行时
导入了但列表里没有清单 JSON 语法错,或 id 和已装的重复,看 logs/ext-*.log
卡片显示「出错」点「详情」看错误信息
拖进去没反应确认扩展名是 .tmlext(拓展页内也支持 .jar),且拖的是文件不是文件夹

相关 ​