[笔记][长期缓更]收集一些自己开发中遇到的问题 - 编程开发

fgfgfgfg

本帖最后由 fgfgfgfg 于 2021-5-12 01:58 编辑

经过一次痛苦的构建环境经历之后，作为一个刚入门的菜鸟我开始编写mod，不过写mod也并不是一番风顺的，各种奇奇怪怪的问题接踵而来于是我决定把遇到的问题都收集到这个帖子里，并且(尽量)提供解决方案，也算是做做笔记了；同样的对于没有解决的问题我也会挂上来，希望路过的热心大佬看到能顺手分享分享经验；顺带一提我的开发版本是Forge 16.3,使用的IDE是Idea,参考的教程是Boson，Neutrino和Minecraft中文开发者指南

这个帖子更新频率取决于我遇到bug的频率，由于我几乎没有开发经验，所以一开始这个帖子的内容会很少，不过慢慢来吧....

错误区

1.材质加载错误

2.mods.toml找不到[modid]

3.Non [a-z0-9/._-] character in path of location

4.添加lang文件后，物品仍显示注册名称

5.编写的新物品,没有在游戏中出现

6.[modid] encountered an error during the load_registeries event phrase

7.战利品表/配方表加载失败

笔记区

凡事不会先想想原版有没有类似实现，有的话就抄过来，没有的话再考虑调用方法/自己实现

1.绘画材质/建模的一点经验

我绘画物品材质使用的是pixly这个软件，板内有汉化下载，b站有相关的教程，对绘画材质很有帮助
不过这个软件目前只有app，没有PC端的，搓玻璃板还是有点不方便，不过我目前没有找到PC上比较好的像素绘画软件(求推荐?)
这里讲四点小建议：
1.透明背景
点击右上角的齿轮，打开设置界面，右滑找到颜色一栏，打开开关透明通道
注意这个上面的条目是可以左右滑动的！不要以为就四个条目！
这样输出的图片背景就是透明的了，如果不是勾选这一项输出的图片会是白色背景的

2.快速上色
有时候人比较懒，不想从头开始画材质，就想着把原版材质变个色
可是原版的材质比较细致，有高光颜色渐变什么的，上色也好麻烦
这个时候可以巧用透明度，点击右下角颜色选择，把透明度拉到50%到70%左右，这样填色的时候既能覆盖颜色，又能保留渐变和高光，很方便(当然，如果你真的很懒只想给原版物品换个色，我推荐你使用在线PS直接改色阶)

3.不要直接从wiki上扒材质

不要直接从wiki上扒材质，虽然从wiki上扒下来的材质是32x32的，但它是模糊的！带了一层模糊边框的！

如果你想要基于原版材质重绘材质，请在.minecraft/verisons/[版本号]/[版本号].jar内部的assets/minecraft/textures里面找

如果你懒得去翻，或者刚好手边没有游戏本体，我这里可以提供一个1.16.5版本的材质文件提取码:8szu

4.建模/盔甲,生物,人物材质绘画

强烈推荐BlockBench与酒石酸大大的教程！

5.常备份,多迭代

有些人(比如我)，有时候图偷懒，在绘画完新材质/建模并导出后，就不保留源文件了。或者是在更新了材质后直接拿去覆盖原来的材质。这是一个非常坏的习惯，特别是当绘画的材质比较复杂的时候。材质的绘画并不常常是一蹴而就的，有时候一些材质可能会重绘两次甚至更多，重绘的效果也不一定比原来的好，所以保留多个历史版本就非常有必要。模型同理，用BB建模完之后一定要保留model文件，这样也方便材质的重绘和模型的修改。

6.复杂的材质要注意重新定义粒子效果

对于一些比较复杂的方块模型，如果不重新指定粒子效果(particle)，那么在破坏方块的时候冒出的粒子效果就会非常难看(特别是建模时偷懒只上一面色的时候)。指定方块的粒子效果需要找到方块的model.json文件，并且添加"particle": "minecraft:block/green_wool"，这里举例的是物品被破坏时使用绿色羊毛的颗粒效果

7.使用色差来划分物品边缘

虽然建议在使用深颜色来话物品轮廓，可是对于在"材质内部"的轮廓如果画出线条来就会非常难看，这里拿我画的奶酪举例

可以看到中间的线显得非常的怪异不说，还挤占了宝贵的上色空间；而如果我们使用色差来勾画轮廓的话

可以看到效果就非常柔和，还附带了不错的立体效果

8.模型位置参考图

对于体积比较小的模型，模型碰撞箱设置错位是常有的事情，划定起始点和中止点容易出错。我这里稍微改了一幅图以供参考：

2.添加物品“注释”

3.创建一个半透明的方块

这里要感谢594524502大大的回答
在开发中，我想要创建一个透光的半透明方块，可是我发现即便我添加了RenderTypeRegistry类并设置为Translucent类型，方块周围依旧出现了诡异的阴影

后来我尝试把RenderTypeRegistry类中方块的类型改为cutout_mipped，可是这个类型是全透明的，不支持半透明材质
最后在594524502大大的提醒下，发现可以通过重写Block类下的getAmbientOcclusionLightValue方法来修改环境光遮盖的问题，具体操作如下

@Override
public float getAmbientOcclusionLightValue(BlockState state, IBlockReader worldIn, BlockPos pos) {
return 1.0f;
}

复制代码

return的值越大，环境光遮蔽越小，最大值为1.0，下图为修改后的效果

虽然依旧无法达到100%透光，不过已经足够了

5.10更新:
可以看到上面的实际效果并不完美，方块本身还不是完全透光，而且方块与方块之间有难看的"隔板"
那么怎么解决这个问题呢，其实直接继承AbstractGlassBlock类就可以了

public class [方块名] extends AbstractGlassBlock

复制代码

接下来仔细看看这个父类干了什么，他重写了下面的三个方法：

@Override
@OnlyIn(Dist.CLIENT)
public float getAmbientOcclusionLightValue(BlockState state, IBlockReader worldIn, BlockPos pos) {
return 1.0F;
}
@Override
public boolean propagatesSkylightDown(BlockState state, IBlockReader reader, BlockPos pos) {
return true;
}
@Override
@OnlyIn(Dist.CLIENT)
public boolean isSideInvisible(BlockState state, BlockState adjacentBlockState, Direction side) {
return adjacentBlockState.isIn(this) ? true : super.isSideInvisible(state, adjacentBlockState, side);
}

复制代码

三个方法分别对应：环境光遮蔽最小，透光，和不渲染周围相同的方块

继承这个父类之后就可以看到，方块已经完全和原版的玻璃一个效果了

值得一提的是，这三个方法中有两个已经被弃用了(有了新的写法)，从原版的bamboo_large_leaves.json中可以看到，在新添加的原版物品中，使用"ambientocclusion": false的新方式在json文件中关掉了环境光遮蔽；我暂时还没有找到isSideInvisible的新调用方法

4.给食物添加复数的药水效果 & 让食物清除所有药水效果

这功能还是卡了我挺久的，最后没想到实际的解决方法如此简单....

这里有两种实现方法：
1.重写Item类下的onItemUseFinish方法
具体操作如下：

@Override
public ItemStack onItemUseFinish(ItemStack stack,World worldIn, LivingEntity entityLiving) {
if(!worldIn.isRemote){
entityLiving.addPotionEffect(new EffectInstance(Effects.NAUSEA, 3 * 20, 1));
entityLiving.addPotionEffect(new EffectInstance(Effects.BLINDNESS, 3 * 20, 1));
}
return super.onItemUseFinish(stack,worldIn,entityLiving);
}

复制代码

当食物被食用后，给予目标两种药水效果。
这里注意一定要添加(!worldIn.isRemote)条件，否则药水效果最后会卡在00:00不消失；此外return的值也别写错了，否则可能会导致游戏崩溃
2.重复调用Food类下的effect方法
具体操作如下：

private static final Food food = (new Food.Builder())
.saturation(10)
.hunger(20)
.effect(() -> new EffectInstance(Effects.NAUSEA, 2 * 20, 1), 1)
.effect(() -> new EffectInstance(Effects.BLINDNESS, 2 * 20, 1), 1)
.build();

复制代码

这个代码是参考了原版的附魔金苹果的代码，可以看到相比方法1更方便，也可以方便的自定义效果的触发概率。当然方法1的好处是有更强的拓展性和泛用性。
总结一下：遇到想要实现但不会的功能，优先想想原版有没有类似的功能，然后抄原版的代码
如果你(像我一样)还不会翻原版代码的话,举个例子,我的原版代码在左侧栏External Library下,Gradle: net.minecraftforge:forge:1.16.4-35.1.4_mapped_snapshot_20201028-1.16.3下,net.minecraft里面.如果我要找金苹果的代码,它很可能是在Item下Foods类里面,进去翻翻就可以看到了

附加更新：如何让食物像牛奶一样移除所有药水效果
操作方法如下，参考了原版牛奶的实现，特别需要注意的点是curepotioneffect()方法里面的参数不能和原版牛奶一样直接填stack，不然不会产生任何实际效果

@Override
public ItemStack onItemUseFinish(ItemStack stack, World worldIn, LivingEntity entityLiving) {
if(!worldIn.isRemote){
entityLiving.curePotionEffects(new ItemStack(Items.MILK_BUCKET));
}
return super.onItemUseFinish(stack,worldIn,entityLiving);
}

复制代码

如果需要移除某一特定药水效果，可以使用removeEffect()方法

5.让物品在合成的时候损耗耐久

整了一个通宵才整出来这东西，实际实现没那么难，但是我踩坑走了不少弯路

首先，要创建一个拥有耐久条的物品

public carrot_jam() {
super(new Item.Properties().group(ModGroup.foodGroup).maxDamage(7));
}

复制代码

这里要注意，一旦物品拥有了耐久属性，它就自动变成不可叠加的了，如果强行添加maxStackSize()会导致游戏崩溃
接下来是重点，重写hasContainerItem()和getContainerItem()方法

@Override
public boolean hasContainerItem(ItemStack itemStack) {
return true;
}
@Override
public ItemStack getContainerItem(ItemStack itemStack) {
if(itemStack.getDamage() < itemStack.getMaxDamage()){
ItemStack item = itemStack.copy();
item.setDamage(item.getDamage() + 1);
return item;
}
return new ItemStack(Items.GLASS_BOTTLE);
}

复制代码

重点讲一下getContainer里面的代码
首先，一定要设置当物品耐久为0的时候会发生的事情，否则物品的耐久会一路下溢到负数不消失，我这里是检测当物品耐久小于0的时候，返回一个玻璃瓶，如果你想让它消失的话可以考虑return air
setDamage()并不是"设置物品耐久值"而是"损害物品耐久值"，比如setDamage(2)，执行后就会扣除物品耐久到(最大耐久值-2)点耐久
对itemStack操作并直接return itemStack并不会产生任何实质的效果(具体原因不明)，必须要使用copy()方法
重写完这两个方法后，再写一个合成表，就能实现让物品在合成的时候损耗耐久了

这里要额外提一下容易踩的两个坑:
1.onCreated / onItemUseFinish
说到合成损害物品耐久，就很容易联想到上面两个Item类里面的方法，然而实际情况是，onCreated是物品被合成时才会触发的方法，onItemUseFinish也和物品合成操作关系不大，这两个方法都不太适用于"让物品在合成的时候损耗耐久"这个要求
2.damageItem
这个是Itemstack类下提供的方法，通过提供(损耗耐久值,执行实体,损耗后执行的事件)的方法来达到损耗物品耐久的目的
我被这个方法困扰了很久，因为getContainerItem使用的就是Itemstack类型的参数，我有理由在getContainerItem这样子写：

itemstack.damageItem(1,player,null)

复制代码

可是如果这样写，就会出现一个问题：我如何获取player——即LivingEntity类型的实例?我无法手动的创建一个player实例
总而言之，这样写是错误的。damageItem一般适用于某些事件发生的时候，这些事件相关的方法会提供玩家实体的参数
举个例子，Item类下的hitEntity方法

public boolean hitEntity(ItemStack stack, LivingEntity target, LivingEntity attacker) {
return false;
}

复制代码

在这里使用damageItem就会非常的自然，而在不提供LivingEntity的getContainerItem中使用就会非常的别扭

6.农作物

农作物的添加过程非常繁琐，特别是绘画材质，非常累人....这里简单总结一下
农作物的添加由两部分组成：农作物方块，和农作物种子
1.农作物方块：

public class [方块名] extends CropsBlock {
private static final VoxelShape[] SHAPES = new VoxelShape[]{Block.makeCuboidShape(5.0D, 0.0D, 5.0D, 10.0D, 4.0D, 10.0D)};
//此处省略若干行Block.makeCuboidShape.....
public [方块名](){super(Properties.create(Material.PLANTS).doesNotBlockMovement().tickRandomly().zeroHardnessAndResistance().sound(SoundType.CROP));}
@Override
protected IItemProvider getSeedsItem() {
return ItemRegistry.[种子名].get();
}
public VoxelShape getShape(BlockState state, IBlockReader worldIn, BlockPos pos, ISelectionContext context) {
return SHAPES[state.get(this.getAgeProperty())];
}

复制代码

从上到下的代码作用分别为：
1.VoxelShape[] SHAPES = new VoxelShape[]{...}：定义作物每个生长阶段的模型
2.Properties：常规的方块设置，这里抄的是原版小麦作物方块的设置，特别要注意添加.tickRandomly()
3.getSeedsItem()：设置作物方块对应的种子
4.getShape()：领植物的模型随生长阶段变化而变化

可以注意到，getSeedsItem()需要我们定义农作物的种子，这里就要看第二部分
2.农作物种子：

public class green_pumpkin_seed extends BlockItem {
public green_pumpkin_seed() {
super(BlockRegistry.greenPumpkinCropblock.get(), (new Item.Properties()).group(ModGroup.foodGroup));
}
}

复制代码

农作物的种子和一般的Item没有太大不同，唯一改变的就是继承的父类变为了BlockItem，并且super()的参数有所改变
同时还需要注意的一点是，由于BlockItem的关系，农作物的方块在物品栏中的材质会自动继承为种子的材质，如果不想重复的话可以选择不把农作物方块注册到创造栏中

在写完这两个组成部分后，就要开始添加blockstate.json,model.json,和texture了，根据农作物设置的最大生长阶段(MaxAge)不同，会需要不同数量的model/texture文件。比如原版的小麦有8个生长阶段，那么就需要8个model文件和8个texture。所以不想那么累的人要注意把农作物的MaxAge调小一点（定义age大小可以自行重写CropBlock内部方法）

绘画材质是创造农作物最繁琐最累人的一段，如果你比较喜欢原版风格作物或者想偷懒的话，可以直接参考原版：绘制一个面的材质，然后以常规方块材质的形式应用到作物方块上。如果你(和我一样)比较喜欢精致的3D模型的话，就要累一些，要创建不同阶段的模型并且上色。注意最后在导出model的时候要修改颗粒效果，关于这部分内容可以看上面的 [1.绘画材质/建模的一点经验]

以上步骤都完成后，别忘记还要添加农作物的掉落，添加战利品表(loot_table)，如果不想写的太累就抄抄原版小麦的战利品表把当然，不能白抄，基本的语法和逻辑还是要懂的，这里贴出wiki的页面方便查阅各个名词的具体作用：战利品表
为了方便理解，我在小麦战利品表上加了一些注释

{
"type": "minecraft:block",
"//":"战利品池，战利品从中抽取",
"pools": [
{
"//":"抽取此战利品的次数",
"rolls": 1.0,
"entries": [
{
"//":"只有首个成功的条件可以生成,比如这里包含了wheat和seed两个物品;如果wheat判断成功(满足condition)那么就掉落一个小麦,并且不掉落种子;如果判断失败,就掉落一个种子",
"type": "minecraft:alternatives",
"children": [
{
"type": "minecraft:item",
"//":"判断条件,类似于'if'",
"conditions": [
{
"condition": "minecraft:block_state_property",
"block": "minecraft:wheat",
"properties": {
"age": "7"
}
}
],
"//":"name在执行的一瞬间就相当于掉落该物品了,也就是说只要condition执行成功就会直接掉落小麦",
"name": "minecraft:wheat"
},
{
"type": "minecraft:item",
"//":"condition失败的情况,掉落一个种子",
"name": "minecraft:wheat_seeds"
}
]
}
]
},
{
"//":"开始抽取第二个物品",
"rolls": 1.0,
"entries": [
{
"type": "minecraft:item",
"functions": [
{
"//":"使用'函数'这里提供的是时运效果的实现",
"function": "minecraft:apply_bonus",
"enchantment": "minecraft:fortune",
"formula": "minecraft:binomial_with_bonus_count",
"parameters": {
"extra": 3,
"probability": 0.5714286
}
}
],
"//":"注意这里不是没有判断条件,而是判断条件被移到了下面,实际效果和上面是一样的,也就是说这里的小麦种子只有在满足条件后才会掉落,若满足,function会对时运进行判断,若有时运则增加小麦种子掉落的数量",
"name": "minecraft:wheat_seeds"
}
],
"conditions": [
{
"condition": "minecraft:block_state_property",
"block": "minecraft:wheat",
"properties": {
"age": "7"
},
"//":"总结一下，如果小麦成熟(条件满足),则掉落一个小麦(第一段),与x个种子(第二段):若条件不满足,则掉落1个种子(第一段)"
}
]
}
],
"functions": [
{
"function": "minecraft:explosion_decay"
}
]
}

复制代码

7.修改物品在GUI中/掉落物/手持时的大小和角度

清风若白

mcbbs，有你更精彩~

3TUSK

你很可能是忘了将物品添加到事件总线了

不是「物品」，是你的 DeferredRegister<Item>。这个东西内置一个事件监听器，监听 RegistryEvent.Register<Item> 事件。
不监听这个事件，当然注册不了任何物品……

q6655156501565

。。。。。。。。。

fgfgfgfg

3TUSK 发表于 2021-4-25 10:35
不是「物品」，是你的 DeferredRegister。这个东西内置一个事件监听器，监听 RegistryEvent.Register 事件 ...

感谢纠错，请问要如何标准的描述这种错误呢，我想修正一下我的文本

Mpromise

楼主加油，有一颗想做点什么的心，但是我该从哪开始=-=

我是真的服了

俺也不懂，直接厉害厉害

fgfgfgfg

本帖最后由 fgfgfgfg 于 2021-5-5 01:04 编辑

//4.29（？）更新，修复了部分错误，添加了一些新文本，重排了一下版
//5.2 更新，添加了给食物添加复数的药水效果的实现笔记，添加了我参考的教程
//5.3更新，添加了让食物清除所有药水效果的实现笔记
//5.4更新，添加了让物品在合成的时候损耗耐久的实现笔记

复制代码

fgfgfgfg

5.10更新，添加了农作物的创建，更新了制作半透明方块的方法

幻梦师

有的时候（比如说我碰到过）
因为一些莫名其妙的原因，会导致lang文件的第一行不会被识别，即使写了正确的代码……
然后这时候就需要，在第一行加两个//
把代码放到第二行开始
我也不知道是为什么，反正可以解决

维勒

还行啊，这是一个循序渐进的过程

小六子鸭.

支持楼主啊！都是干活！爱了爱了

霍普森兰

干货啊！满满的干货！
楼主真是厉害，祝你学习开发顺利，水平节节高

SumCraft

像素画软件,steam有一款付费开源你的叫做Aseprite.挺好用

XIaoWs

BBS 有你更精彩!