Nautilus Studio - Packs Editor IDE

Nautilus Studio - Packs Editor IDE

资源包和数据包通用IDE的JSON编辑器和生成器。自动支持任何模组的编解码器,并为其生成友好的用户界面,包含预览和语法高亮。

Discord Patreon Twitter YouTube


📖 关于 📖

Nautilus Studio 是一个游戏内的数据包和资源包工作台。它无需手写 JSON 并猜测正确的字段,而是在游戏旁打开一个完整的编辑器:选择一个文件,填写生成的表单,点击重新加载,更改就会出现在正在运行的游戏中。

这些表单会根据游戏自身的内容定义自动构建,因此它既适用于模组内容,也适用于原版内容。


🖼️ 媒体 🖼️

Nautilus Studio 工作台,包含文件树、生成表单和实时 JSON


📦 功能 📦

它可以编辑什么

  • 世界生成:已配置和已放置的特征、雕刻器、生物群系、噪声设置、密度函数、世界预设
  • 结构:结构、结构集、拼图池
  • 战利品和谓词:战利品表、物品修饰器、谓词
  • 配方和进度
  • 附魔
  • 世界和维度:维度、维度类型
  • 生物变种、装饰和纹饰、物品和音效等
  • 模组注册的任何内容。例如,Polytone 会注册其颜色映射、粒子效果和自定义模型
  • 任何自定义编解码器,通过类名指定,即使编辑器从未见过该内容
  • 任何无法解析的内容都会回退到带有语法高亮的实时验证原始 JSON 编辑器

使用方法

  • 先加入一个世界:编辑器需要实时的注册表来构建表单并重新加载
  • 在 Fabric 上从 Mod Menu 条目打开它,或在 NeoForge 上的模组列表中的配置屏幕按钮打开它
  • 工作台会在游戏旁边的一个独立窗口中打开
  • 点击重新加载以将更改应用到正在运行的游戏中

Nautilus Studio 在 Fabric 上运行最佳。在 NeoForge 上,由于 Java 的无头窗口限制,编辑器窗口偶尔可能无法打开。


🛠️ 对于模组开发者 🛠️

对于大多数情况,模组应该可以正常工作。但是,如果您想要获得更好的兼容性,可以这样做:

要注册您的编解码器,使其默认出现在编辑器中,您可以这样注册:

NautilusStudioApi.register(
    "My Mod",                  // 组名,显示在 "Minecraft" 旁边
    "Widget Layout",           // 此内容类型的标签
    MY_CODEC,                  // 您的每文件 Codec(即 DIRECT_CODEC)
    Side.CLIENT_RESOURCES,     // CLIENT_RESOURCES (assets/) 或 SERVER_DATA (data/)
    "mymod/widgets"            // 文件所在的文件夹
);

要获得更好的组件(如颜色选择器、滑块、总和类型的下拉菜单),请将您的编解码器构建为 CodecUI 的 SchemaCodec,并传入该对象。它仍然是具有相同数据格式的真正 Codec。任何 CodecUI 无法读取的内容都会回退到经过验证的原始 JSON 编辑器,因此注册永远是安全的。

只需添加以下依赖行(使用 jar-in-jar,这样 CodecUI 就可以打包在您的模组内),并按照该类中的 API,将您的 Codec 调用替换为 SchemaCodec 调用:

repositories {
    maven { url "https://registry.somethingcatchy.net/repository/maven-public/" }
}

dependencies {
    // Fabric (Loom)
    modImplementation "net.mehvahdjukaar:codecui-fabric:1.21.11-0.4.0"
    include           "net.mehvahdjukaar:codecui-fabric:1.21.11-0.4.0"

    // NeoForge (ModDevGradle)
    implementation "net.mehvahdjukaar:codecui-neoforge:1.21.11-0.4.0"
    jarJar         "net.mehvahdjukaar:codecui-neoforge:1.21.11-0.4.0"
}

有关完整的 DSL 和示例,请参阅 CodecUI 仓库。


❓ 常见问题解答 ❓

问:这是仅客户端模组吗?

答: 是的。这个编辑器是一个客户端工具:它编辑磁盘上的包文件并重新加载您的客户端。您不需要在服务器上安装它。

问:玩家需要使用这个才能使用我的包/模组吗?

答: 不需要。Nautilus Studio 是一个创作工具。您用它制作的包是普通的原版数据/资源包,对所有人都有效。

问:它能用于模组内容吗?

答: 可以。任何注册了其编解码器的模组(借助 CodecUI,只需一行代码)都会自动显示。您也可以通过类名自行添加自定义编解码器。

问:如果 Nautilus Studio 无法理解某个文件怎么办?

答: 它会回退到带有语法高亮的实时验证原始 JSON 编辑器,因此您仍然可以编辑任何内容。

问:我需要将 CodecUI 作为依赖项吗?

答: 不需要。Nautilus Studio 已将其捆绑在内。只有您想手动调整编辑器组件时,才需要直接使用 CodecUI。

问:支持 Fabric 还是 NeoForge?

答: 两者都支持。Fabric 的体验更流畅;在 NeoForge 上,外部窗口偶尔会遇到 AWT 无头模式的限制。


❤️ 支持我 ❤️

模组开发花费了我大量时间。如果您喜欢我的作品并想支持我,您将获得一个专属于您的定制地球仪和/或雕像 - 如果您使用下面的代码从 Akliz 购买服务器,同样适用。

Ko-Fi

需要服务器吗?Akliz 提供专为模组 Minecraft 打造的一流服务器,拥有优秀的社区和支持团队。 使用代码 "supplementaries" 即可获得 20% 的折扣,同时支持我!

Akliz Server Hosting


🦉 我们的模组 🦉

Supplementaries Amendments Every Compat (Wood Good) Supplementaries Squared Map Atlases Universal Sawmill Polytone Snowy Spirit Haunted Harvest Sleep Tight Smarter Farmers Mystical Oak Tree Storage Labels Goated A Good Place Vista Heartstone Fast Paintings MmmMmmMmmMmm JEED JEPP Advancement Frames Randomium Moyai