[支持26.x]VanillaAPI_26x_v1.26.0原创依赖库，二创api

fhchbhh***

灵感来源
来自于java版的模组启动器和很多的依赖库
模组注意点
可能必须开启测试版beta api，以及(如果创作的话)开启模组内部的中期beta才能完成加载，暂无多语言！
并且js和json脚本还有点bug，请小心使用！
本模组永远不支持低版本(26.x及以下)，所以导致开启全局资源后和开发低版本文件时无法使用和导入导出等等的情况！
模组简介
此创作由minecraft原版基岩版api进行二次开发，并且使用元宝ai进行辅助开发，其目的让原版游戏模组开发更简单
可让游戏小白两三分钟可以了解js和json大概的文件结构
除此之外还有更好的沙箱和更好的日志文件，让你一秒钟知道报错在哪里
此外本模组不修改游戏文件和添加额外功能！
模组版权
本模组使用MIT开源协议进行开源并且你可以任意修改文件，甚至可以分享文件！
允许二次创作和再次开发等等前，必须署名
本模组遵循EULA(及最终用户协议)不允许商业开发！
本模组只有最基础的原版api二创，不参与游戏核心文件修改！
本模组允许上传到代码仓库和其他minecraft平台分享，参与核心本模组文件修改时必须授权我同意才能开始，否则解释权归我和苦力怕论坛平台(最初发行地)拥有！
©原版minecraft和api版权由mojang和微软所拥有
©本模组原创依赖库所有版权来自于元宝 AI (Yuanbao AI)，代码作者https://yuanbao.tencent.com/
苦力怕论坛 (klpbbs.com)发布/维护        https://klpbbs.com/home.php?mod=space&uid=2223249
fhchbhhvhjbhjbj发布/维护链接如上
minecraft_fiower (B站)发布/测试        https://b23.tv/pqw050L
莉娜 (Lina)Wiki 文档        https://zh.minecraft.wiki/w/User:%E8%8E%89%E5%A8%9C
模组依赖库下载
本模组文件已经开源了，解压zip你可以二次创作模组哟~
解压第一个zip后，可以直接导入至minecraft并且激活附加包后可以自动依赖或者找到BP和RP进行分别导入和激活也是一样的效果滴~
必须要下载minecraft原版本体哟~
可以通过我的123云盘下载压缩包哟~
使用123云盘下载zip解压并导入minecraft激活附加包可直接导入存档
模组实景
只有游戏截图，并没有太多的游戏修改！

fhchbhh***

对话链接
欢迎广大朋友们进行查看哟~
"那就帮我先搜索minecraft基岩版2..."点击查看元宝的回答
https://yb.tencent.com/s/czjAhI4hyhnV

fhchbhh***

VanillaAPI6.0-7.0火热补丁更新
修复
修复了VanillaAPI无法在游戏中触发脚本的问题
兼容性
兼容绝大多数PC端和移动端(包括windows，mac，linux，ipad，xbox，ps，switch，android，暂不支持小米和华为可能会在下个版本单独支持)
道具
添加VanillaAPI调试棒(vanillaapi:ui_opener)，专为移动设备设计可以打开VanillaAPI脚本界面
火热按键添加
添加AIT+G打开命令宏
添加AIT+D打开VanillaAPI脚本界面
VanillaAPI脚本界面
添加大量独有功能和调试官方API的功能
指令
添加
/va可以更方便的调试
/va beta register <id> <名称> <最低版本> 开启或者调试脚本，暂时只能支持beta最低版本，但是正式版不支持！
/va ui 打开VanillaAPI调试脚本
下载
火热补丁源码已发布，可以随时支持！
在123云盘下载并导入minecraft激活附加包或激活BP和RP即可使用

fhchbhh***

VanillaAPI8.0火热补丁已发布！
兼容性
由于mojang官方api的限制导致玩家只能选择哪个和输入设备，这不影响后来操作！
输入指令时请不要输入未知设备的名字防止可能有部分无法兼容！
重要是已经支持独有的小米和华为了！
指令
添加/va macro trigger <id> 可输入你的设备ID
添加/va run <script> 运行脚本，测试代码
下载
火热补丁源码已发布，你可以随时修改和兼容此库！
 VanillaAPI8.0火热补丁.zip(86.48 KB, 下载次数: 14)

2026-8-4 10:07 上传

点击文件名下载附件
原创依赖库，请勿随意修改本核心文件

fhchbhh***

基岩版原创VanillaAPI依赖库已经移植到java版了你可以随时调用哦~
并且完美支持绝大多数模组加载器！
源码已发布，你可以随时改编！
此处暂不给予jar模组文件，你需要自己打包和编译文件！
编译文件代码

1. //确保你的电脑安装了 JDK 17+ 或更高版本。
   
2. //解压源码文件并且打开进入  VanillaAPI-Java  目录。
   
3. //Windows (新建  build.bat )
   
4. [url=home.php?mod=space&uid=4803]@echo[/url] off
   
5. echo ==========================================
   
6. echo Building VanillaAPI 1.26.0-beta.1
   
7. echo ==========================================
   
8. .\mvnw.cmd clean package -DskipTests
   
9. echo.
   
10. echo Build finished! Check the target folders.
    
11. pause
    
12. //Mac / Linux (新建  build.sh )
    
13. #!/bin/bash
    
14. echo "=========================================="
    
15. echo "Building VanillaAPI 1.26.0-beta.1"
    
16. echo "=========================================="
    
17. ./mvnw clean package -DskipTests
    
18. echo ""
    
19. echo "Build finished! Check the target folders."
    
20. //运行脚本后，你会在这个位置找到标准的、可直接塞进 mods 文件夹的模组文件：
    
21. 
    
22. NeoForge (26.x):  vanillaapi-neoforge/target/vanillaapi-neoforge-1.26.0-beta.1.jar 
    
23. 
    
24. Fabric (1.26.x):  vanillaapi-fabric/target/vanillaapi-fabric-1.26.0-beta.1.jar 
    
25. 
    
26. Forge (1.20.1):  vanillaapi-forge/target/vanillaapi-forge-1.26.0-beta.1.jar

复制代码

爱发电创作者:
账号名与b站账号一致
https://www.ifdian.net/setting/account
按键和模组特性
✅ 依赖隔离：Core 代码已被重定位到  net.vanillaapi.shaded.core ，绝不发生冲突。

✅ 游戏内开关：按 B 键打开 Beta 功能菜单。

✅ 热修改代码：按 H 键打开代码编辑器，游戏运行中写代码并运行。

✅ 跨加载器：同一个 API 接口，四个加载器都能用。
下载
方法如上
 VanillaAPI java移植版.zip(70.55 KB, 下载次数: 2)

2026-8-5 10:21 上传

点击文件名下载附件
源码已开源，你可以随时随地修改哦~

瓜瓜***

感谢分享

fhchbhh***

Minecraft 模组开发简明教程 (2026年8月)

本教程基于以下两个参考资料：

1. Minecraft 基岩版 26.x 版本体系说明
2. VanillaAPI 1.26.0-beta.1.0 跨平台模组API实现方案

---

第一部分：核心概念区分

在开始之前，必须明确一个核心事实：基岩版和 Java版的模组开发是两套完全不同的逻辑。

特性 基岩版 (Bedrock) Java版 (Java Edition)
开发语言 JSON (数据驱动) Java (代码驱动)
核心文件 manifest.json, 各种.json行为/资源文件 .java 源代码文件
运行依赖 游戏本身直接加载 需要 Fabric / Forge / NeoForge 等加载器
修改能力 受限于游戏提供的数据接口 几乎可以修改游戏的一切底层逻辑
适用人群 配置型、轻量级修改 编程型、大型模组开发

一句话总结： 做基岩版模组像是在“填表”，而做Java版模组是在真正的“写代码”。

---

第二部分：基岩版模组开发 (数据驱动篇)

基岩版的模组在官方术语中称为 “附加包 (Add-ons)” ，由行为包 (修改逻辑) 和资源包 (修改外观) 组成。

1. 理解版本体系 (基于链接1)

从2026年开始，基岩版和Java版都采用了按年份编号的新体系。

· “26.x”不是某一个特定版本，而是2026年所有版本的总称。
· 例如：26.0 是年度首版，26.10 是“小鬼当家”更新，26.30 是“混沌立方”更新。
· 开发时必须注意： 你的模组 manifest.json 中的 "min_engine_version" 字段，需要根据目标玩家所处的版本来填写，比如 [26, 0, 0]。

2. 开发环境与工具

· 国际版： 任意文本编辑器 (如 VS Code) 即可。
· 中国版： 推荐使用官方提供的 “我的世界开发工作台 (MC Studio)” ，它集成了编辑器、测试和打包功能。

3. 核心文件：manifest.json

这是每个附加包的“身份证”，必须放在根目录。

1. ```json
   
2. {
   
3.   "format_version": 2,
   
4.   "header": {
   
5.     "name": "我的第一个附加包",
   
6.     "description": "一个示例模组",
   
7.     "uuid": "这里填写一个唯一的UUID",
   
8.     "version": [1, 0, 0],
   
9.     "min_engine_version": [26, 0, 0]
   
10.   },
    
11.   "modules": [
    
12.     {
    
13.       "type": "data",
    
14.       "uuid": "这里填写另一个唯一的UUID",
    
15.       "version": [1, 0, 0]
    
16.     }
    
17.   ]
    
18. }
    
19. ```

复制代码

4. 实战案例：修改一个物品

· 在行为包的 items/ 文件夹下创建一个 .json 文件。
· 通过JSON数据定义一个“更强力的钻石剑”，修改其攻击伤害和耐久度。
· 打包文件夹为 .mcaddon 或 .mcpack 文件，双击即可导入游戏。

---

第三部分：Java版模组开发 (代码驱动篇)

Java版模组开发需要真正的编程。我们以你提供的 VanillaAPI 项目为例，它是一个跨加载器的模组API。

1. 环境搭建

· JDK： 必须安装 JDK 17 或更高版本。
· IDE： 推荐 IntelliJ IDEA。
· 项目构建： 使用 Gradle 或 Maven。VanillaAPI 项目内置了 Maven Wrapper，无需手动安装Maven。

2. 理解“依赖隔离” (Shade 重定位)

这是Java版模组开发中的一个高级但重要的概念。

· 问题： 不同模组可能依赖了同一个库 (如 Guava) 的不同版本，这会导致冲突。
· 解决： VanillaAPI 通过 “Shade 重定位” 解决了这个问题。
· 做法： 将依赖库的包名进行修改。例如，将 com.google.common 重定位到 net.vanillaapi.shaded.guava。这样，你的模组使用的Guava版本就不会和其他模组冲突了。

3. 核心亮点：热修改代码

VanillaAPI 实现了一个非常强大的功能：在游戏运行时修改和测试代码。

· 在游戏中按 H 键可以打开代码编辑器GUI。
· 你可以直接编写或修改Java代码，游戏会尝试在运行时编译并执行它。
· 这极大地缩短了“修改代码 -> 重启游戏 -> 查看效果”的漫长开发循环。

4. 跨平台支持

VanillaAPI 展示了现代Java模组的一个重要趋势：跨加载器支持。

· 它通过不同的模块，同时支持了 NeoForge、Fabric、Forge 和 Quilt 这四大主流加载器。
· 这意味着模组开发者可以编写一次核心代码 (vanillaapi-core)，然后通过不同的平台模块将其适配到不同的加载器上，无需为每个加载器重写一遍逻辑。

---

总结与建议

1. 如果你只想做简单的功能修改 (如新武器、新方块、修改掉落物)，请选择 [基岩版] 路线。 你只需要了解JSON语法和游戏的数据驱动格式即可。
2. 如果你想实现颠覆性的玩法、添加复杂的系统或API，请选择 [Java版] 路线。 这需要你投入更多时间学习Java编程、Gradle/Maven构建工具以及特定加载器 (如Fabric) 的API。

希望这份TXT格式的教程能帮助你理清思路，选择适合自己的开发道路！

fhchbhh***

Q:我可以维护吗?
A:可以，只要不动java和基岩版核心文件就行
Q:我怎么写基础的测试代码和新功能?
A:你只需要会js和json就可以维护基岩版mcaddon文件
Q:如果我有更好的想法，而且维护过了，以及我想在基岩版的测试项目转正该怎么办?
A:或者你会java或转基岩版的等等写法可以轻松移植转到java正式版上