Minecraft(我的世界)中文论坛

 找回密码
 注册(register)

!header_login!

只需一步,立刻登录

查看: 147824|回复: 206

[辅助软件] [1.15-1.17] 大憨批 —— VSCode 数据包函数编辑插件

    [复制链接]
SPGoding 当前离线
积分
22720
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2018-1-18
查看详细资料
 楼主| 发表于 2019-11-16 21:20:34 | 显示全部楼层 |阅读模式
https://raw.githubusercontent.com/SPGoding/vscode-datapack-helper-plus/master/img/banner.png
软件资源发布
中文名称: 大憨批
英文名称: Data-pack Helper Plus
来源: 原创
软件版本: 3.1.1
适用版本: 1.16.X 1.15.X 
下载地址: https://marketplace.visualstudio.com/items?itemName=SPGoding.datapack-language-server
原帖地址: https://github.com/SPGoding/datapack-language-server
最后更新: 2020-11-13
编写语言: TypeScript
语言支持: 其它(请注明) 依赖于预先设置的字段语言 日本語 繁體/正體中文 简体中文 English 
安装方法: 绿色软件

您尚未登录,立即登录享受更好的浏览体验!

您需要 登录 才可以下载或查看,没有帐号?注册(register)

x
本帖最后由 SPGoding 于 2020-11-21 06:19 编辑





Data-pack Helper Plus,简称 DHP,中文名大憨批,是一组能够为 Minecraft Java版的数据包文件(包括进度、函数、战利品表、断言、配方、各种标签)提供支持的插件。您可以将其安装在 VSCode 编辑器上。

免责声明

我们尽了最大的努力来保证您的数据包的文件安全。然而,在某些极端情况下,您的文档可能仍会被大憨批破坏。遗憾的是,我们无法为这种情况提供任何帮助。请随时备份您宝贵的数据包作品(如上传到网盘等)。即使您最终选择不使用大憨批,我们也建议您不时进行备份!

安装

点这个图标就可以从网页安装:

或者,您也可以直接打开 VSCode,按 Ctrl + P,复制粘贴 ext install spgoding.datapack-language-server 并回车。

提示:大憨批要求 VSCode 的版本最低为 1.44.0。请确保你安装的 VSCode 在该版本之后发布。

特性

工作区支持

请使用数据包的根文件夹(也就是 data 文件夹与 pack.mcmeta 文件所处的文件夹)作为你的工作区的根文件夹,以获得最佳的体验。

此外,大憨批完全支持多个根文件夹的工作区,只需要确保在使用「文件」→「将文件夹添加到工作区…」功能添加数据包时添加的都是数据包的根文件夹即可。然而,有关 VSCode 的工作区的优质中文资料十分匮乏,不想花时间了解怎么使用多根文件夹的工作区的用户可以忽略掉大憨批的这个特性。工作区中其他的非数据包根文件夹不会受到大憨批影响。

每一个根文件夹中都能访问同一工作区下其他根文件夹中的函数/进度/战利品表等文件内容。工作区中根文件夹的顺序将会影响它们在大憨批当中的优先级。最开始的根文件夹会第一个被加载,最后的根文件夹会在最后加载,也就是说根文件夹出现得越早,它在大憨批中的的优先级越低。这和游戏在加载数据包时决定用哪个数据包中的文件覆盖另一个文件的逻辑是完全一致的。举个例子,如果你的多根文件夹工作区的文件结构是这个样子:

  1. ─── (根文件夹)数据包A
  2.    ├── data
  3.    |   └── spgoding
  4.    |       └── functions
  5.    |           └── foo.mcfunction
  6.    └── pack.mcmeta
  7. ─── (根文件夹)数据包B
  8.    ├── data
  9.    |   └── spgoding
  10.    |       └── functions
  11.    |           └── foo.mcfunction
  12.    └── pack.mcmeta
复制代码

然后你使用 F2 功能在一个函数文件中把函数 spgoding:foo 重命名为了 wtf:foo,只有在数据包 B 中的文件(数据包B/data/spgoding/functions/foo.mcfunction)会被移动到 Datapack B/data/wtf/functions/foo.mcfunction,即使在数据包A中也有一个具有同样命名空间 ID 的函数文件(Datapack A/data/spgoding/functions/foo.mcfunction)。

如果你尝试在 Minecraft 中执行以下命令,你也会发现被执行的函数是数据包B中的。

  1. datapack enable "file/Datapack A" first
  2. datapack enable "file/Datapack B" last
  3. function spgoding:foo
复制代码

通过这样的逻辑,大憨批确保了它处理数据包的行为是和 Minecraft 一致的。

提示:你可以在 VSCode 中拖放根文件夹来排序它们,大憨批会自动更新它们在大憨批中的优先级,十分方便。

多语言支持

大憨批支持多种语言。目前以下语言已经完全支持:

语言VSCode Language ID
德语de
英语en
法语fr
意大利语it
日语ja
简体中文zh-cn

如果您愿意帮助翻译大憨批至其他语言,我们将不胜感激!请查看 CONTRIBUTING.md 了解更多信息。

语义化高亮


所有命令参数都可以被语义化高亮。我们同时建议您安装  Arcensothlanguage-mcfunction extension 插件以获得实时的颜色反馈。



签名信息

您可以在敲打命令的过程中得到该命令的签名提示。这些信息通常会在你按下空格后自动显示。

您也可以使用 Ctrl + Shift + 空格手动触发签名信息。



自动补全

当您敲击了以下任意字符时,大憨批将自动计算补全提示:[' ', ',', '{', '[', '=', ':', '/', '!', "'", '"', '.', '@']。此外您也可以使用 Ctrl + 空格快捷键(或其他自行设定的按键)来手动触发自动补全。

大憨批能够提供简单命令的自动补全:

复杂的 NBT 标签的自动补全(感谢 Yurihaia 维护的 mc-nbtdoc):

以及 NBT 路径的自动补全:

以及 JSON 文本的自动补全:

甚至能把它们套起来

代码片段

大憨批提供了一些有用的代码片段。有关代码片段是什么可以参考 VSCode 的官方文档。大憨批与 VSCode 均提供了让你自定义代码片段的功能,并且由于大憨批基于 VSCode,它们定义代码片段的语法也完全一致。对于 mcfunction 函数文件来说,由大憨批添加的代码片段将只会在光标位于命令开头时出现在补全提示的列表中,而由 VSCode 的 Code/User/snippets/mcfunction.json 文件添加的代码片段则会在任何情况下都能出现在补全提示中。如果你想用 VSCode 来自定义代码片段,看他们的官方文档;如果你想用大憨批来自定义代码片段,则需要看本文的配置部分.



定义注释


你可以使用形如 #define <类型:字符串> <标识符: 字符串> [<描述: 字符串>] 的格式来定义一个字符串。这些被定义的内容将会参与到补全提示的计算、符号的重命名、查找引用或定义等操作当中。Minecraft 本身会把这些定义注释当作普通的注释并直接忽略掉,只有大憨批会读取这些注释。



别名注释


你可以使用形如 #alias <类型:字符串> <别名: 字符串> <值: 字符串> 的格式来定义一个字符串别名,其将会出现在指定参数的补全列表中。



错误提示与代码操作


大憨批能够提供实时的错误提示。它既能像 Minecraft 一样展现语法错误,也能给予你更加详细的警告信息。

有些错误提示还附带代码操作,能够帮你快速修正问题。



格式化与校验


您可以通过按下 Shift + Alt + F 或其他自行设定的快捷键来格式化当前文档。

您可以在配置中设置一些格式化与校验的规则,大憨批将给不符合设定的命令进行标注。



折叠区域

您可以使用 #region#endregion 注释来定义折叠区域,使得 mcfunction 文件结构更加清晰。

  1. #region 这是一吨穷举命令,不穷举你会变得更强?
  2. execute if score @s test matches 1 run say 1
  3. execute if score @s test matches 2 run say 2
  4. execute if score @s test matches 3 run say 3
  5. execute if score @s test matches 4 run say 4
  6. execute if score @s test matches 5 run say 5
  7. #endregion
复制代码

除此之外,您还可以使用不同个数的井号来创建不同层级的折叠区域(不过井号后面需要有至少一个空格):

  1. #region 这是一吨穷举命令,不穷举你会变得更强?
  2. # 壹
  3. ## 壹?一
  4. execute if score @s foo matches 1 run say 1
  5. execute if score @s foo matches 2 run say 2
  6. ## 壹?二
  7. execute if score @s bar matches 1 run say 1
  8. execute if score @s bar matches 2 run say 2
  9. # 贰
  10. execute if score @p test matches 1 run say 1
  11. #endregion
复制代码



调用层级

该特性依赖于 proposed 阶段的 API,只能在开发环境下使用。

调用层级可以让你很方便地浏览各个函数。你可以获取到一个函数、函数标签、进度的调用者以及被调用者。该特性的默认快捷键为 Shift + Alt + H



颜色信息

大憨批能够为 dust 粒子以及一些 NBT 标签提供颜色信息,这是真正的憨批行为。你可以把光标悬浮在颜色上几秒钟,这样就能直接更改颜色了。



悬浮信息

不好意思,没做。

解析命名空间 ID

您可以通过按着 Ctrl 左击进度、战利品表、函数、断言以及各种标签的命名空间 ID 来跳转到对应的文件。



跳转到定义

您可以通过按着 Ctrl 左击记分项名、实体名、标签名、队伍名、bossbar ID、数据储存 ID 来跳转到对应的定义行数。



查找引用

您可以通过 Shift + F12 快捷键或其他自行设定的按键来查找所有该进度、战利品表、函数、断言、数据包标签、实体、标签、计分项、队伍、bossbar 或数据储存在当前工作区中的所有引用。



重命名

您可以通过 F2 或其他自行设定的按键来重命名进度、战利品表、函数、断言、数据包标签、实体、标签、队伍、bossbar 或数据储存。

在整个工作区中相应的引用都会被重命名。

警告:重命名可能导致您的函数内容损坏,请及时备份。使用风险请自行承担。



此外,如果您重命名了一个有着文件定义的命名空间 ID(例如进度、战利品表、函数、断言以及各种标签的命名空间 ID),在工作区当中的对应文件也将会被移动或重命名。



然而,直接手动重命名工作区中的一个文件并不会更新它的命名空间 ID,并且可能会导致缓存错误。

配置

使用 Ctrl + ,(或其他绑定的快捷键)来打开 VSCode 的设置页,并搜索 datapack 来查看所有由大憨批提供的配置选项。通过修改这些选项,你可以自行添加代码片段、设置格式化与校验偏好,以及修改运行环境的相关信息。这些选项既可以是为当前用户设置的,也可以是为当前工作区设置的。有关修改配置选项的具体内容请查看 VSCode 的官方文档

贡献者

感谢所有大憨批的贡献者!

2.0.1 版本的贡献者



点此查看详细列表。

往期版本贡献者


贡献

如果您有意进行贡献,可以提交漏洞或建议给我打钱等。

查看 CONTRIBUTING.md 以获取更多信息。

常见问题

为什么补全提示卡死了?

这是网络原因。请按 Ctrl + , 打开设置界面,搜索 datapack.env.dataSource,将其从 GitHub 切换至 码云

有漏洞/少功能!

请把您的意见、建议、遇到的问题等发布在 GitHub issues,或直接回复在论坛发布帖之下。发布在 GitHub 有利于本人对其进行追踪,发布在论坛有利于我个人给予您相应积分奖励。请不要在两处都进行反馈。

大憨批真好用!

谢谢。您有很多种对大憨批表示支持的方式。

  • 如果您喜欢大憨批的话,这就足够了。
  • 如果您的 MCBBS 帐号有权限的话,在本人的论坛发布页评满各项分值,这对本人申请精华有很大帮助;
  • 如果您有微软帐号的话,在本人的插件发布页给一个五星好评。
  • 如果您有 CBer 朋友的话,把大憨批安利给 TA;
  • 如果您有钱的话,本人有一个爱发电页面。

[afd]SPGoding[/afd]

来自群组: Command Block Logic

评分

参与人数 96人气 +168 金粒 +1674 宝石 +48 贡献 +7 收起 理由
Martintin + 1 + 15 MCBBS有你更精彩~
一水合氨 + 1 MCBBS有你更精彩~
DarcJC + 2 MCBBS有你更精彩~
lovewwwww + 2 + 30 MCBBS有你更精彩~
郁离子 + 1 + 40 只剩一人气了
盲猜派高层 + 1 神乎其技!6的飞起!
Amo_ms + 1 + 15 太厉害了,支持
zymooll + 1 MCBBS有你更精彩~
唔咩 + 2 + 5 MCBBS有你更精彩~
张文昊 + 1 az,大憨批.........起名鬼才!
S_iver + 1 + 20 神乎其技!6的飞起!
ColorPencil + 2 神乎其技!6的飞起!
乙烯_中国 + 48 MCBBS有你更精彩~
12tianxun + 15 爱了爱了
晴路卡 + 2 + 30 宝贝收到了 孩子很喜欢
齿轮-gear + 5 大憨批,NB!!!
英雄360 + 1 + 5 MCBBS有你更精彩~
Dreamlie + 1 神乎其技!6的飞起!
随便吧土豆 + 2 MCBBS有你更精彩~
搜索中 + 1 amazing!

查看全部评分

雷鸣·翾鹗 当前离线
积分
4969
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2015-1-16
查看详细资料
发表于 2019-11-16 21:51:19 | 显示全部楼层
我曾经是一个弱小的cber,命令十分钟,debug一小时那种,自从用了大憨批,大憨批能帮我找到命令中的语法错误,我再也不用因为自己的憨批行为而迷茫彷徨了,大憨批就像指引前路的光明一样,再次激起了我写命令的激情和自信。感谢大憨批,感谢spg,感谢各位小可爱们!

评分

参与人数 16人气 +10 金粒 +35 收起 理由
Amo_ms + 1 Ssssssssssssssssssss
tang_wenqi + 1 + 5 在?有钱一起恰
星际要塞 + 1 在?有钱一起恰?
Aurora_Feather + 1 在?有钱一起恰
HYFan_Meng + 5 所以这个是多少钱一条有钱赚也让我赚点awa.
晓夜Port + 1 Ssssssssssssssssssss
名为123的貘 + 1 商业互吹23333还行,这个置顶我给满分.
gooding300 + 1 有钱一起赚
brooke_zb + 1 括号居然删干净了了?!(
S速风 + 1 五毛,删了我发
轻光233 + 5 有钱赚别瞒着坛友们
ETW_Derp + 5 八群领钱
海螺螺 + 5 群号发一下
ruhuasiyu + 1 有钱一起赚
夜之暗夜 + 5 会说话就多说点
SPGoding + 5  

查看全部评分

回复

使用道具 举报

L1tPunkp1n 当前离线
积分
61
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-9-11
查看详细资料
发表于 2021-11-28 13:12:29 | 显示全部楼层
本帖最后由 L1tPunkp1n 于 2021-11-28 13:15 编辑


有bug,地形特征全没了
9I6DK6Q)GUEJOW9BX5A7F{5.png
回复

使用道具 举报

慕容�_EvcIw 当前离线
积分
96
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-8-20
查看详细资料
发表于 2021-11-24 17:09:39 | 显示全部楼层
MCBBS有你更精彩~
回复

使用道具 举报

Poxet 当前离线
积分
188
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2017-1-12
查看详细资料
发表于 2021-11-22 09:31:04 | 显示全部楼层
虽然看不懂,不过大佬nb
回复

使用道具 举报

wydgg 当前离线
积分
48
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-9-19
查看详细资料
发表于 2021-9-21 23:54:15 | 显示全部楼层
这可太棒了吧
回复

使用道具 举报

347378240 当前离线
积分
34
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2015-5-10
查看详细资料
发表于 2021-9-21 23:03:50 | 显示全部楼层
好厉害的样子研究一下
回复

使用道具 举报

845648 当前离线
积分
106
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-8-12
查看详细资料
发表于 2021-9-18 10:24:03 | 显示全部楼层
感谢分享!!
回复

使用道具 举报

TheASun 当前离线
积分
95
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2018-11-26
查看详细资料
发表于 2021-9-11 10:54:26 | 显示全部楼层
太实用了!!可以大大提高效率!
回复

使用道具 举报

didiii 当前离线
积分
1065
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-8-16
查看详细资料
发表于 2021-9-8 14:04:33 | 显示全部楼层

太屌了 支持   
回复

使用道具 举报

厉害且牛人 当前离线
积分
81
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-7-23
查看详细资料
发表于 2021-9-8 09:22:42 | 显示全部楼层
感谢楼主分享
回复

使用道具 举报

请叫我老猹 当前离线
积分
337
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-7-31
查看详细资料
发表于 2021-9-7 04:12:12 | 显示全部楼层
感谢分享
回复

使用道具 举报

楼上我②子 当前离线
积分
181
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2017-7-7
查看详细资料
头像被屏蔽
发表于 2021-8-19 17:17:36 | 显示全部楼层
MCBBS有你更精彩~
回复

使用道具 举报

martin_zzy 当前离线
积分
155
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2016-1-29
查看详细资料
发表于 2021-8-19 16:41:08 | 显示全部楼层
VSCode Ver:1.59.0
DHP:3.3.14
nbt路径补全似乎不太全 比如give @s diamond_sword{CanDestroy:}后没有提示
give @s diamond_sword{display 打完之后依然没有补全提示
以前好像是有的
回复

使用道具 举报

kaiwenlong2 当前离线
积分
727
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-7-22
查看详细资料
发表于 2021-8-15 16:30:07 | 显示全部楼层
可以可以感谢作者分享
回复

使用道具 举报

这是街舞 当前离线
积分
100
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-1-29
查看详细资料
发表于 2021-7-22 09:49:24 | 显示全部楼层
mcbbs有你更精彩~
回复

使用道具 举报

wjzspeed 当前离线
积分
74
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-1-13
查看详细资料
发表于 2021-7-11 04:13:32 | 显示全部楼层
感谢作者的分享
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 注册(register)

本版积分规则

Archiver|小黑屋|Mcbbs.net ( 京ICP备15023768号-1 ) | 京公网安备 11010502037624号 | 手机版

GMT+8, 2021-12-6 18:07 , Processed in 0.099681 second(s), Total 33, Slave 32 queries, Release: Build.2021.11.26 1022, Gzip On, Redis On.

"Minecraft"以及"我的世界"为Mojang Synergies AB的商标 本站与Mojang以及微软公司没有从属关系

© 2010-2020 我的世界中文论坛 版权所有 本站原创图文内容版权属于原创作者,未经许可不得转载

快速回复 返回顶部 返回列表