前言
约 607 字大约 2 分钟
2024-09-26
重要
本笔记基于
- Minecraft 1.21.1
- KubeJS 2101.7.0
- ProbeJS 7.4.0
代码编译器
在进行我的世界的魔改之前我们得需要一个代码编辑器来帮助我们写代码,当然你也可以使用Windows自带的记事本(我勒个记事本编程大佬),但是记事本没有代码提示能力,所以我推荐使用 Visual Studio Code (简称为 VSC )这是一个对 TS/JS 具有良好支持的代码编辑器。
ProbeJS
ProbeJS 对于 KubeJS 是一个重要的附属模组,它通过扫描游戏中加载过的类来生成 TypeScript 文件。这些文件可以帮助我们快速查找方法和字段,并为方法、函数和事件处理程序提供文档。
要使用 ProbeJS,首先需要在安装了 ProbeJS 和 KubeJS 的情况下启动游戏,进入一个世界,然后运行命令 /probejs dump。过一段时间后 ProbeJS 将会生成该 modpack 的所有类型文件。
接下来需要在 Visual Studio Code 中打开你的 modpack 的文件夹,并打开 kubejs 文件夹。然后为你的 VSC 安装 ProbeJS 插件,然后开始愉快的 KubeJS 魔改之旅。
注
如果你发现在 VSC 中 ProbeJS 没有为你提供补全,起尝试按下键盘上的 F1 然后选择 TypeScript:重启 TS 服务器 选项来重启 TS 服务器。
文件结构
在首次打开装有 KubeJS 的游戏时,你会发现在游戏目录下会自动生成一个名为 kubejs 的文件夹,在其下有这么几个文件夹:
kubejs
assets
\<namespace># <namespace>及其以下文件夹不会自动生成
textures
xxx.png
lang
zh_cn.json
sounds
xxx.ogg
models
xxx.json
……
data
\<namespace># <namespace>及其以下文件夹不会自动生成
tags
xxx.json
……
config
xxx.json
client_scripts
xxx.js
server_scripts
xxx.js
startup_scripts
xxx.js