> For the complete documentation index, see [llms.txt](https://youyi580.gitbook.io/zentutorial/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://youyi580.gitbook.io/zentutorial/contenttweaker/tinkers-construct-addon/advanced-functions.md). # 高级运用 ## 更多实例 请看 [CrT 高级运用](https://ikexing.gitbook.io/crt/) ~~虽然咕咕咕了~~ ## 运用于 MaterialBuilder 对象的函数 ### ItemLocalizer 函数 导包 ```csharp import mods.tconstruct.materials.ItemLocalizer; ``` 该函数用于计算材料名称 此函数需要返回 string * [Material](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Material/) 类的 `thisMaterial` * String 类型的 `itemName` 例子 ```csharp myMat.itemLocalizer = function(thisMaterial, itemName) { return "Cool " + itemName; }; ``` 游戏中 : ![iron](https://github.com/XHL315/ZentutorialPhotos/blob/master/Photos/Cool.png) ## 运用于 TraitBuilder 对象的函数 ### CanApplyTogether 函数 导包 ```csharp import mods.tconstruct.traits.CanApplyTogetherTrait; import mods.tconstruct.traits.CanApplyTogetherEnchantment; ``` 此函数可以使特性或附魔不能同存 此函数需要返回 bool * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * String 类型的 `otherTrait` 例子1 ```csharp myTrait.canApplyTogetherTrait = function(thisTrait, otherTrait) { return otherTrait != 特性名称(也就是 identifier) }; ``` * [IEnchantmentDefinition](https://docs.blamejared.com/1.12/en/Vanilla/Enchantments/IEnchantmentDefinition/) 类的 `thisTrait` * String 类型的 `enchantmentDefinition` 例子2 ```csharp myTrait.canApplyTogetherEnchantment = function(thisTrait, enchantmentDefinition) { return enchant != 附魔名称(不要傻傻的填个 "附魔名称") }; ``` ### ExtraInfo 函数 导包 ```csharp import mods.tconstruct.traits.ExtraInfo; ``` 可以在工具装配台看到额外信息 此函数需要返回 string\[] * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `item` * [IData](https://docs.blamejared.com/1.12/en/Vanilla/Data/IData/) 类的 `tag` 例子 : ```csharp myTrait.extraInfo = function(thisTrait, item, tag){ var infos as string[] = ["Cool1", "Cool2"]; return infos; }; ``` 游戏中 : ![icon](https://github.com/XHL315/ZentutorialPhotos/blob/master/Photos/extraInfo.png) ### getMiningSpeed 函数 导包 ```csharp import mods.tconstruct.traits.MiningSpeed; ``` 破坏方块时调用 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [PlayerBreakSpeedEvent](https://docs.blamejared.com/1.12/en/Vanilla/Events/Events/PlayerBreakSpeed/) 类型的 `event` 函数写法 : ```csharp myTrait.getMiningSpeed = function(thisTrait, tool, event) { //Code }; ``` ### beforeBlockBreak 函数 导包 ```csharp import mods.tconstruct.traits.BeforeBlockBreak; ``` 方块被破坏之前调用 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [BlockBreakEvent](https://docs.blamejared.com/1.12/en/Vanilla/Events/Events/BlockBreak/) 类型的 `event` 函数写法 : ```csharp myTrait.beforeBlockBreak = function(thisTrait, tool, event) { //Code }; ``` ### afterBlockBreak 函数 导包 ```csharp import mods.tconstruct.traits.AfterBlockBreak; ``` 方块被破坏之后调用 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [IWorld](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Vanilla/Types/World/IWorld/) 类的 `world` * [IBlockState](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Vanilla/Types/Block/ICTBlockState/) 类的 `blockstate` * [IBlockPos](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Vanilla/Types/Block/IBlockPos/) 类的 `pos` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `miner` * boolean 类型的 `wasEffective` 函数写法 : ```csharp myTrait.afterBlockBreak = function(thisTrait, tool, world, blockstate, pos, miner, wasEffective) { //Code }; ``` ### onBlockHarvestDrops 函数 导包 ```csharp import mods.tconstruct.traits.BlockHarvestDrops; ``` 方块被破坏且将要生成掉落物时调用 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [BlockHarvestDropsEvent](https://docs.blamejared.com/1.12/en/Vanilla/Events/Events/BlockHarvestDrops/) 类型的 `event` 函数写法 : ```csharp myTrait.onBlockHarvestDrops = function(thisTrait, tool, event) { //Code }; ``` ### onUpdate 函数 导包 ```csharp import mods.tconstruct.traits.Update; ``` 此函数每 Tick 都会调用 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [IWorld](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Vanilla/Types/World/IWorld/) 类的 `world` * [IEntity](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntity/) 类的 `entity` (实际使用时这个对象可能是为 [IPlayer](https://docs.blamejared.com/1.12/en/Vanilla/Players/IPlayer/), [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/), 只是被自动转型为 [IEntity](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntity/), 可以 instanceof 判断之后就向下强转) * int 类型的 `itemSlot` * boolean 类型的 `isSelected` 函数写法 : ```csharp myTrait.onUpdate = function(thisTrait, tool, world, entity, itemSlot, isSelected) { //Code }; ``` ### afterHit 函数 导包 ```csharp import mods.tconstruct.traits.AfterHit; ``` 实体受到伤害后调用 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `attacker` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `target` * float 类型的 `damageDealt` * boolean 类型的 `wasCritical` * boolean 类型的 `wasHit` 函数写法 : ```csharp mytrait.afterHit = function(trait, tool, attacker, target, damageDealt, wasCritical, wasHit) { //Code }; ``` ### onHit 函数 导包 ```csharp import mods.tconstruct.traits.OnHit; ``` 即将对实体造成伤害之前调用, 在此函数调用时所有的伤害都计算完毕 (简单来说就是最后一步) 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `attacker` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `target` * float 类型的 `damage` * boolean 类型的 `isCritical` 函数写法 : ```csharp myTrait.onHit = function(thisTrait, tool, attacker, target, damage, isCritical) { //Code }; ``` ### onBlock 函数 导包 ```csharp import mods.tconstruct.traits.OnBlock; ``` 玩家阻挡攻击时调用, 否则调用 [onPlayerHurt](/zentutorial/contenttweaker/tinkers-construct-addon/advanced-functions.md#onplayerhurt-han-shu) 函数 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [IPlayer](https://docs.blamejared.com/1.12/en/Vanilla/Players/IPlayer/) 类的 `attacker` * [EntityLivingHurtEvent](https://docs.blamejared.com/1.12/en/Vanilla/Events/Events/EntityLivingHurt/) 类型的 `event` 函数写法 : ```csharp myTrait.onBlock = function(thisTrait, tool, attacker, event) { //Code }; ``` ### onPlayerHurt 函数 导包 ```csharp import mods.tconstruct.traits.OnPlayerHurt; ``` 玩家未阻挡攻击时调用, 否则调用 [onBlock](/zentutorial/contenttweaker/tinkers-construct-addon/advanced-functions.md#onblock-han-shu) 函数 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [IPlayer](https://docs.blamejared.com/1.12/en/Vanilla/Players/IPlayer/) 类的 `player` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `attacker` * [EntityLivingHurtEvent](https://docs.blamejared.com/1.12/en/Vanilla/Events/Events/EntityLivingHurt/) 类型的 `event` 函数写法 : ```csharp myTrait.onPlayerHurt = function(thisTrait, tool, player, attacker, event) { //Code }; ``` ### calcCrit 函数 导包 ```csharp import mods.tconstruct.traits.IsCriticalHit; ``` 对实体造成伤害之前调用以确定此次攻击是否暴击，返回值为 `false` 并不会取消已经是暴击的伤害 此函数需要返回一个 bool * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `attacker` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `target` 函数写法 : ```csharp myTrait.calcCrit = function(thisTrait, tool, attacker, target) { //Code return true; //或 false }; ``` ### calcDamage 函数 导包 ```csharp import mods.tconstruct.traits.Damage; ``` 攻击一个实体时调用，但在造成伤害和计算暴击加成之前调用, 此函数用于计算暴击伤害的加成 此函数需要返回一个 float 以确定伤害加成 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `attacker` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `target` * float 类型的 `originalDamage` * float 类型的 `currentDamage` * boolean 类型的 `isCritical` 函数写法 : ```csharp myTrait.calcDamage = function(thisTrait, tool, attacker, target, originalDamage, currentDamage, isCritical) { //Code return currentDamage; //或者修改后的值 }; ``` ### calcKnockBack 函数 导包 ```csharp import mods.tconstruct.traits.KnockBack; ``` 攻击实体后调用, 以修改实体受到的击退 此函数需要返回一个 float 以确定击退距离 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `attacker` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `target` * float 类型的 `damage` * float 类型的 `knockback` * float 类型的 `newKnockback` * boolean 类型的 `isCritical` 函数写法 : ```csharp myTrait.calcKnockBack = function(thisTrait, tool, attacker, target, damage, knockback, newKnockback, isCritical) { //Code return newKnockback; //或者修改后的值 }; ``` ### onToolDamage 函数 导包 ```csharp import mods.tconstruct.traits.OnToolDamage; ``` 工具降低耐久度之前调用 此函数需要返回一个 int 以确定工具耐久 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * int 类型的 `damage` * int 类型的 `newDamage` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `entity` 函数写法 : ```csharp myTrait.onToolDamage = function(thisTrait, tool, damage, newDamage, entity) { //Code return newDamage; //或者修改后的值 }; ``` ### calcToolHeal 函数 导包 ```csharp import mods.tconstruct.traits.OnToolHeal; ``` 工具提高耐久度之前调用 此函数需要返回一个 int 以确定工具耐久 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * int 类型的 `damage` * int 类型的 `newDamage` * [IEntityLivingBase](https://docs.blamejared.com/1.12/en/Vanilla/Entities/IEntityLivingBase/) 类的 `entity` 函数写法 : ```csharp myTrait.calcToolHeal = function(thisTrait, tool, damage, newDamage, entity) { //Code return newDamage; //或者修改后的值 }; ``` ### onToolRepair 函数 导包 ```csharp import mods.tconstruct.traits.OnToolRepair; ``` 使用材料修复工具前调用, 请勿与 [calcToolHeal](/zentutorial/contenttweaker/tinkers-construct-addon/advanced-functions.md#calctoolheal-han-shu) 函数混淆, 如果不止一次修复这个物品，此函数将被调用多次 此函数不需要返回值 * [Trait](https://docs.blamejared.com/1.12/en/Mods/ContentTweaker/Tinkers_Construct/Trait/) 类的 `thisTrait` * [IItemStack](https://docs.blamejared.com/1.12/en/Vanilla/Items/IItemStack/) 类的 `tool` * int 类型的 `amount` 函数写法 : ```csharp myTrait.onToolRepair = function(thisTrait, tool, amount) { //Code }; ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://youyi580.gitbook.io/zentutorial/contenttweaker/tinkers-construct-addon/advanced-functions.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.