本篇教程由作者设定使用 CC BY-NC 协议。

这是一篇关于ContentTweaker(以下统称CoT)的教程，部分资料来源于youyihj大佬的youyi的CrTwiki。

您需要安装以下mod以启动CoT。

CraftTweaker(前置)，ContentTweaker(本体)，JustEnoughItem(JEI，CrT前置)，B.A.S.E(前置，1.16.5无需安装)。

第一步：启动游戏

作用是为了加载CrT模组，使.minecraft/scripts出现。

第二步：基本操作

在scripts文件夹内新建一个后缀名为 名字随便.zs (虽说名字随便，但推荐使用Item，Block，Fluid名称来分类文件)，也可以放在你新建的一个CoT子文件夹。

第三步：开始魔改(物品)

使用你喜欢的文本编辑器(这里推荐VSCode)打开你刚刚创建的.zs文件，开头请输入

#loader contenttweaker(意为这个脚本由CoT来加载)

import mods.contenttweaker.VanillaFactory;(导入一个原版加工厂包)

import mods.contenttweaker.Item;(此为导入自定义物品的包)


val cotItem as Item = VanillaFactory.createItem("cot_item");(注册一个物品,带有下划线为名称，可以自定义)

cotItem.register();(表示注册本物品)

当然，物品不可能只有这些标签の(标签资料为youyihj大佬的gitbook内提供)，所有标签的格式都为

物品名称.标签名称 = 值；

名称

类型默认值描述
beaconPayment
boolfalse是否可以放进信标里
creativeTab
ICreativeTabmisc创造标签
设置物品所在创造标签，记得/ct creativetab指令
glowingboolfalse是否有附魔光芒
maxDamage
int-1设置物品耐久，小于0则为普通物品，大于0将会被当作工具

maxStackSize

int64
设置物品最大堆叠数
rarity

EnumRarity

COMMON
设置物品稀有度，会影响物品显示名称的颜色，可以使用(“COMMON”, “UNCOMMON”, “RARE”, “EPIC”)以下某一个
toolClassstringnull设置这是什么工具(pickaxe镐,axe斧等等)貌似sword剑不能
toolLevel
int-1设置工具挖掘等级

一个简单的示例脚本。

#priority 1

#loader contenttweaker

import mods.contenttweaker.VanillaFactory;

import mods.contenttweaker.Item;


val cotItem as Item = VanillaFactory.createItem("cot_item");

cotItem.rarity = "epic";

cotItem.creativeTab = <creativetab:misc>;

cotItem.beaconPayment = true;

cotItem.maxStackSize = 999；

cotItem.register();

写完后保存+关闭，重启游戏，此时就会在你选择的创造标签页中看见物品。什么？你说没有材质？名字也是乱码？别着急，看下一步。

第四步：制作材质和本地化。

材质请放在resources/contenttweaker/textures/items内，文件名称为 物品名称.png 也就是双引号内的名称。

本地化请打开resources/contentweaker/lang 找到你的en_us.lang文件，复制，将复制来的改名为zh_cn.lang。

打开zh_cn.lang 输入本地化的key：item.contenttweaker.物品ID.name=中文名称，保存后退出。

如果你想添加英文名称，打开en_us.lang 输入：item.contenttweaker.物品名称.name=英文名称。

如果你有说其他奇怪语言的朋友，按照上面的操作来一遍就行了。


感谢你收看本教程，我会马上更新的。