ScriptAPI自定义组件教程

阅读该教程需要一定的JavaScript基础，若没有请退出，谢谢。
教程禁止水评论，若对你有用请回复一个“有用”。

教程开始。
官方教程：
TypeScript

1. import { ItemComponentConsumeEvent, world } from "@minecraft/server";
   
2. 
   
3. world.beforeEvents.worldInitialize.subscribe(initEvent => {
   
4.   initEvent.itemComponentRegistry.registerCustomComponent('example:add_night_vision_on_consume', {
   
5.     onConsume(arg: ItemComponentConsumeEvent) {
   
6.       arg.source.addEffect('minecraft:night_vision', 600);
   
7.     }
   
8.   });
   
9. });

复制代码

1.导入必要模块
JavaScript：

1. import { ItemComponentConsumeEvent, world } from "@minecraft/server";

复制代码

2.监听 worldInitialize 事件
JavaScript

1. world.beforeEvents.worldInitialize.subscribe((initEvent) => {
   
2.   // 这里将添加自定义组件的代码
   
3. });

复制代码

3.注册自定义物品组件
说明：在 worldInitialize 事件的处理函数中，我们可以使用 itemComponentRegistry 来注册自定义组件。

1. initEvent.itemComponentRegistry.registerCustomComponent('example:add_night_vision_on_consume', {
   
2.   onConsume(arg) {
   
3.     arg.source.addEffect('minecraft:night_vision', 600);
   
4.   }
   
5. });

复制代码

其他说明：arg返回的是ItemComponentConsumeEvent 类
链接：ItemComponentConsumeEvent

创建完成后在JSON中的components对象中写入以下代码

1. "minecraft:custom_components": [
   
2.     "example:add_night_vision_on_consume"
   
3. ]

复制代码

4.实现功能

1. world.beforeEvents.worldInitialize.subscribe((initEvent) => {
   
2.   initEvent.itemComponentRegistry.registerCustomComponent('example:add_night_vision_on_consume', {
   
3.     onConsume: (arg) => {
   
4.       arg.source.addEffect('minecraft:night_vision', 600);//实现夜视药水效果
   
5.     }
   
6.   });
   
7. });

复制代码

说明：
onConsume为物品被吃掉后调用
详细页ItemCustomComponent Interface

                        有用

1. 
   
2. import { world, system } from "@minecraft/server";
   
3. 
   
4. world.beforeEvents.worldInitialize.subscribe((event) => {
   
5.     event.itemComponentRegistry.registerCustomComponent("<自定义组件的标识符>", {
   
6.         onUse(E) {
   
7.             system.runJob(Tigger(E.source))
   
8.         }
   
9.     })
   
10. })
    
11. 
    
12. function* Tigger(player) {
    
13.     player.addEffect("night_vision",100,{amplifier:255,showParticles:false})
    
14.     yield;
    
15. }
    

复制代码