第九十章 命名空间ID
(本章已于2022年7月25日修改)
你该如何通过/give指令获取到一颗钻石?
在Minecraft PC1.7.2(Java版1.7.2)之前的版本中,物品只有数字ID,加上目标选择器没有@s,所以你只能这样子获得钻石:
/give @br / 264
对于原版来说数字ID就够了,但这对于模组来说就很不友好。举个例子,工业时代2(Industrial Craft 2)模组添加了一个叫做『工业钻石』的物品,它的数字ID为30135。为什么这个ID要跑到这么后面?答案很简单:如果放在很前面的话,万一原版添加了个新的物品,或者某个MOD也添加了ID一样的物品,那游戏岂不是分分钟崩掉?所以对于Minecraft1.7.2版本之前的模组来说,物品的ID就得弄成一个大数以降低冲突的风险,防止玩家的游戏因为ID冲突崩掉。
但随着Minecraft玩家群体的增大,模组数量的增多,原版那一丁点儿ID分配空间就显得捉襟见肘了。Mojang官方估计也注意到了这一点,于是自1.7.2版本开始,Mojang开始尝试放弃数字ID,转为使用更加先进的:命名空间ID。
什么是命名空间ID?这个名词其实我们在第八章已经遇见过了,你也知道它大概长什么样:
xxxxxxxxx:xxxxxxxxx
命名空间ID(Namesbr /aced identifier),又称资源路径(Resource location)或命名空间字符串(Namesbr /aced string),是Minecraft中一种为了正确识别到特定对象而尽量不产生歧义和冲突的一种方式。它普遍的格式如下:
命名空间:名称
不难发现,一个命名空间ID由左边的命名空间和右边的名称ID组成,两者使用英文半角冒号『:』分开。
在Java版,命名空间和名称只能含有阿拉伯数字『0123456789』、小写字母(旧版本也能含有大写字母)『abcdefghijklmnobr /qrstuvwxyz』、下划线『_』、连字符『-』和点『.』,在名称中还能够使用正斜杠『/』。
在基岩版,命名空间和名称能够含有除英文半角冒号『:』和正斜杠『/』以外的所有字符,但有一些特殊情况:在战利品表和函数名称中,正斜杠『/』也可以使用。
『命名空间ID』中的『命名空间』是什么?有什么用呢?
回到上面的钻石例子。我们现在有一个数字ID为264的钻石,但如果此时有另外一个模组也添加了一个相同ID的物品,也叫做『钻石』,这时候264这个数字ID就代表着两个物品:原版的钻石和这个模组的钻石。这时候游戏就会出现混乱,不出意外的话应该会崩掉。那么我们该如何解决这个问题呢?
要解决这个问题,我们就要找到一种方式,能够区分这两个『钻石』。区分的方式有很多,比如可以判断两个钻石引用的材质文件,可以判断两个钻石的代码,但万一材质也是同一个文件该怎么办?代码一模一样怎么办?我们必须找出一个最容易方便辨别的,也最不容易相同的,且两个钻石都具有的东西来判断。
这个东西究竟是什么呢?
假如你在某个B 站上发表了这么一句话来表达你宏大的志向:
『我是胡桃的狗!』
问题来了,这个『胡桃』指的是哪个胡桃呢?是《原神》的胡桃,还是《胡桃日记》的胡桃,还是东方旧作的胡桃,还是《公主连结》的胡桃,甚至是属于植物的胡桃?
不难发现,我们在描述不同的『胡桃』时,往往会在前面加上定语『XXX的』,其中XXX往往是某一个更高层面的东西,『的』用来区分两者。等等,让我们把『的』换成冒号,然后你就会发现:
原神:胡桃
胡桃日记:胡桃
东方Project旧作:胡桃
公主连结:胡桃
植物:胡桃
虽然字符用的是中文,不符合Minecraft Java版的规范。但如果抛开这点来说,这完完全全不就是『命名空间ID』吗?!其中『原神』、『胡桃日记』、『东方Project旧作』等就是『命名空间』。
但是这还不足以解释『命名空间』,让我们再换一个例子。
张三的电脑上有两个文件夹A和B,两个文件夹都具有一个叫做『music.mbr /3』的文件。由于这两个文件在不同的文件夹下面,因此不会发生冲突,计算机能够正常识别它们。如果它们是在同一个文件夹下面,那么计算机识别的时候就会发生混乱,可能会直接跳出那个众所周知的蓝色窗口。在这边,文件夹『A』和『B』就代表命名空间。
但是我们仍然不能够清楚解释『命名空间』究竟是什么。其实,『命名空间』本身也并没有一个很准确的定义,它在不同的场合可能具有完全不同的意义,比如种类、游戏、公司、文件夹、数据库、国家、学科等等等等。当然,如果你的抽象思维比较好的话,你当然可以把它想象成一个空间,至于这个空间究竟是什么你不用去管。同样的名称在不同的空间被赋予上不同的意义,并且不会和其他名称发生冲突,因为两个名称虽然一样,但处于不同的命名空间之中。
回到最开始的钻石例子,你应该已经想到如何区分原版和模组的钻石吧?这两个钻石就算本身完全一样,但它们所处的『空间』并不一样。其中一个钻石是『原版的钻石』,另外一个钻石是『模组的钻石』。我们只需要对比两个钻石所处的『空间』,也就是对比拥有这两个钻石的两个东西即可。Mojang和其他第三方模组开发者也是这么想,所以在Minecreaft Java1.7.2版本中引入的命名空间,就是这么干:
minecraft:diamond
\\我的世界的钻石\\
mod:diamond
\\模组的钻石\\
如今,随着版本的更迭,『命名空间ID』正在被用于越来越多的东西上。截止Minecraft Java1.19.1和基岩版1.19.10版本,在原版中,命名空间已经用于这些东西:
方块、方块实体[JE]、液体[JE]、物品、实体种类、生物记忆[JE]、画[JE]、村民职业[JE]、村民种类[JE]、状态效果、药水效果[JE]、魔咒、粒子种类、维度[JE]、生物群系、统计[JE]、配方种类[JE]、配方序列化器[JE]、声音、战利品表、函数、进度[JE]、谓词[JE]、结构、配方[JE]、标签[JE]、方块状态文件[BE]、模型[BE]、纹理[BE]、Boss栏[JE]、命令存储[JE]、命令参数[JE]、战利品表函数[JE]和战利品表种类[JE]。
这不列没事,一列出来吓一大跳,这么多。其实,一些第三方模组加载器早已为更多的东西加入了『命名空间ID』。比如在SPONGE FORGE海绵模组服务端中,为指令加上了『命名空间ID』。未来,随着Mojang官方对数据包、行为包、附加包等『官方模组』的持续支持,原版游戏内必定会有更多的东西用上『命名空间ID』。
所以,你现在清楚『命名空间ID』是什么了吗?让我们重新获取一遍钻石,加深一下你对这东西的理解:
/give @s minecraft:diamond
本章到此为止。
附表①:『命名空间ID』历史
Java
1.6.1——加入了『命名空间ID』和命名空间minecraft
1.7.2——命令现在能够使用『命名空间ID』
1.8——几乎所有命令现在不再接受数字ID
1.11——命名空间ID现在不允许使用大写字母,并加入了字符限制
1.13——命名空间ID现在变为唯一可以被接受的ID形式,数字ID被完全移除
1.14.4——客户端资源包加入了realms命名空间
1.16——实体的属性现在也使用命名空间ID
携带版/基岩版
1.12.0——加入了命名空间和minecraft前缀,使得附加包能够向游戏内添加新的东西
附表②:Dinnerbone对命名空间ID的评论
This isn't a new concebr /t, but I thought I should reiterate what a “namesbr /ace“ is. Most things in the game has a namesbr /ace, so that if we add something and a mod (or mabr /, or whatever) adds something, they're both different somethings. Whenever you're asked to name something, for exambr /le a loot table, you're exbr /ected to also br /rovide what namesbr /ace that thing comes from. If you don't sbr /ecify the namesbr /ace, we default to minecraft. This means that something and minecraft:something are the same thing.
这不是一个新概念,但是我想我应重申一下什么是“命名空间”。游戏中的大多数东西都有一个命名空间,以便在我们加入了something的同时一个mod(或地图,或其他)也加入了something时来区分它们两个。当您要为某个东西命名时,例如一个战利品表,您还需要指定这个东西所属的命名空间。如果您不指定命名空间,我们默认它是minecraft。这意味着something和minecraft:something是一回事。
——原文来自『www.minecraft.net/zh-hans/article/minecraft-snabr /shot-17w43a』
——翻译来自中文Minecraft Wiki