xiaokun/netease-bedrock-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

同步官网文档8m_25d

Browse Source
This commit is contained in:
kwiilh
2025-08-25 18:36:29 +08:00
parent 4dc0ecf18d
commit 9e8855eeb4
5089 changed files with 8798 additions and 4799 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/10-预设/1-实体预设.md
View File

@@ -44,10 +44,10 @@ EntityPreset（实体预设）是一类绑定MC的某类实体的特殊预设，
| 属性 | 描述 |
| ------------ | ------------------------------------------------------------ |
| 生命值 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#sethealth" rel="noopenner">SetHealth</a>和<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxhealth" rel="noopenner">SetMaxHealth</a>接口，设置实体的最大和当前生命值。 |
| 速度 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setspeed" rel="noopenner">SetSpeed</a>和<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxspeed" rel="noopenner">SetMaxSpeed</a>接口，设置实体的最大和当前速度。 |
| 攻击力 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setdamage" rel="noopenner">SetDamage</a>和<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxdamage" rel="noopenner">SetMaxDamage</a>接口，设置实体的最大和当前攻击力。 |
| 岩浆里的移速 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setlavaspeed" rel="noopenner">SetLavaSpeed</a>和<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxlavaspeed" rel="noopenner">SetMaxLavaSpeed</a>接口，设置实体在岩浆里的最大和当前移速。 |
| 生命值 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#sethealth" rel="noopenner">SetHealth</a>和<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxhealth" rel="noopenner">SetMaxHealth</a>接口，设置实体的最大和当前生命值。 |
| 速度 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setspeed" rel="noopenner">SetSpeed</a>和<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxspeed" rel="noopenner">SetMaxSpeed</a>接口，设置实体的最大和当前速度。 |
| 攻击力 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setdamage" rel="noopenner">SetDamage</a>和<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxdamage" rel="noopenner">SetMaxDamage</a>接口，设置实体的最大和当前攻击力。 |
| 岩浆里的移速 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setlavaspeed" rel="noopenner">SetLavaSpeed</a>和<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxlavaspeed" rel="noopenner">SetMaxLavaSpeed</a>接口，设置实体在岩浆里的最大和当前移速。 |
> ​ 注意：此处的设置属性会先设置最大值，再设置当前值，如给自定义牛设置生命值为10，则其最大生命值为10，当前生命值也为10。
@@ -55,22 +55,22 @@ EntityPreset（实体预设）是一类绑定MC的某类实体的特殊预设，
| 属性 | 描述 |
| ---------- | ------------------------------------------------------------ |
| 重力因子 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setgravity" rel="noopenner"> SetGravity</a>接口，设置实体的初始重力因子，该值为负数。 |
| 是否可推动 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setpushable" rel="noopenner">SetPushable</a>接口，设置实体是否可被推动，默认为True。 |
| 重力因子 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setgravity" rel="noopenner"> SetGravity</a>接口，设置实体的初始重力因子，该值为负数。 |
| 是否可推动 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setpushable" rel="noopenner">SetPushable</a>接口，设置实体是否可被推动，默认为True。 |
### 氧气：设置实体氧气相关的属性值，如氧气储备值和恢复氧气时间等
| 属性 | 描述 |
| ---------------- | ------------------------------------------------------------ |
| 氧气储备值 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setcurrentairsupply" rel="noopenner">SetCurrentAirSupply</a>和<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxairsupply" rel="noopenner">SetMaxAirSupply</a>接口，同时设置实体的氧气储备值的当前值和最大值。 |
| 恢复最大氧气时间 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setrecovertotalairsupplytime" rel="noopenner">SetRecoverTotalAirSupplyTime</a>接口，设置实体恢复最大氧气量的时间，单位秒。 |
| 氧气储备值 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setcurrentairsupply" rel="noopenner">SetCurrentAirSupply</a>和<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setmaxairsupply" rel="noopenner">SetMaxAirSupply</a>接口，同时设置实体的氧气储备值的当前值和最大值。 |
| 恢复最大氧气时间 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setrecovertotalairsupplytime" rel="noopenner">SetRecoverTotalAirSupplyTime</a>接口，设置实体恢复最大氧气量的时间，单位秒。 |
### 状态与物品：设置实体的初始状态效果和物品
| 属性 | 描述 |
| ------------ | ------------------------------------------------------------ |
| 添加状态效果 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#addeffect" rel="noopenner">AddEffect</a>接口，为实体添加指定的初始的状态效果。 |
| 生物物品 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setitem" rel="noopenner">SetItem</a>接口，为实体设置初始的物品。 |
| 添加状态效果 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#addeffect" rel="noopenner">AddEffect</a>接口，为实体添加指定的初始的状态效果。 |
| 生物物品 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setitem" rel="noopenner">SetItem</a>接口，为实体设置初始的物品。 |
@@ -78,9 +78,9 @@ EntityPreset（实体预设）是一类绑定MC的某类实体的特殊预设，
| 属性 | 描述 |
| ------------ | ------------------------------------------------------------ |
| 是否免疫伤害 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setimmunedamage" rel="noopenner">SetImmuneDamage</a>接口，设置实体是否免疫伤害，该属性存档。 |
| 保留原生AI | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setblockcontrolai" rel="noopenner">SetBlockControlAi</a>接口，设置是否保留实体原生AI，屏蔽后实体无法移动，不受重力影响不会被推动。 |
| 是否持久化 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setpersistence" rel="noopenner">SetPersistence</a>接口，设置实体是否会在卸载区块和退出游戏时存档，默认为True。 |
| 是否免疫伤害 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setimmunedamage" rel="noopenner">SetImmuneDamage</a>接口，设置实体是否免疫伤害，该属性存档。 |
| 保留原生AI | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setblockcontrolai" rel="noopenner">SetBlockControlAi</a>接口，设置是否保留实体原生AI，屏蔽后实体无法移动，不受重力影响不会被推动。 |
| 是否持久化 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setpersistence" rel="noopenner">SetPersistence</a>接口，设置实体是否会在卸载区块和退出游戏时存档，默认为True。 |
@@ -88,5 +88,5 @@ EntityPreset（实体预设）是一类绑定MC的某类实体的特殊预设，
| 属性 | 描述 |
| ------------ | ------------------------------------------------------------ |
| 关闭实体渲染 | 等同于实体对象EntityObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/实体对象EntityObject.html#setnotrender" rel="noopenner">SetNotRender</a>接口，设置是否关闭实体渲染，默认为False。 |
| 关闭实体渲染 | 等同于实体对象EntityObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/实体对象EntityObject.html#setnotrender" rel="noopenner">SetNotRender</a>接口，设置是否关闭实体渲染，默认为False。 |

32
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/10-预设/2-玩家预设.md
View File

@@ -49,20 +49,20 @@ PlayerPreset（玩家预设）是一类特殊的实体预设，玩家预设与
| 属性 | 描述 |
| ------------ | ------------------------------------------------------------ |
| 增加玩家等级 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#addlevel" rel="noopenner">AddLevel</a>接口，修改玩家等级，可为负数。|
| 增加玩家等级 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#addlevel" rel="noopenner">AddLevel</a>接口，修改玩家等级，可为负数。|
### 饥饿与健康：设置玩家的饥饿度和健康值相关属性
| 属性 | 描述 |
| ------------ | ------------------------------------------------------------ |
| 健康临界值 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#sethealthlevel" rel="noopenner">SetHealthLevel</a>接口，设置设置玩家健康临界值，当饥饿值大于等于健康临界值时会自动恢复血量，开启饥饿值且开启自然恢复时有效，原版默认值为18 |
| 饥饿度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#sethunger" rel="noopenner">SetHunger</a>接口，设置玩家饥饿度 |
| 饥饿临界值 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setstarvelevel" rel="noopenner">SetStarveLevel</a>接口，设置玩家饥饿临界值，当饥饿值小于饥饿临界值时会自动扣除血量，开启饥饿值且开启饥饿掉血时有效。原版默认值为1 |
| 开启饥饿掉血 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setnaturalstarve" rel="noopenner">SetNaturalStarve</a>接口，设置是否开启玩家饥饿掉血，当饥饿值小于饥饿临界值时会自动扣除血量，开启饥饿值且开启饥饿掉血时有效.原版默认开启 |
| 饥饿掉血速度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setstarvetick" rel="noopenner">SetStarveTick</a>接口，设置玩家饥饿掉血速度，当饥饿值小于饥饿临界值时会自动扣除血量，开启饥饿值且开启饥饿掉血时有效 |
| 开启自然恢复 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setnaturalregen" rel="noopenner">SetNaturalRegen</a>接口，设置是否开启玩家自然恢复 |
| 自然恢复速度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#sethealthtick" rel="noopenner">SetHealthTick</a>接口，设置玩家自然恢复速度 |
| 最大消耗度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setmaxexhaustionvalue" rel="noopenner">SetMaxExhaustionValue</a>接口，设置玩家最大消耗度(maxExhaustion) |
| 健康临界值 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#sethealthlevel" rel="noopenner">SetHealthLevel</a>接口，设置设置玩家健康临界值，当饥饿值大于等于健康临界值时会自动恢复血量，开启饥饿值且开启自然恢复时有效，原版默认值为18 |
| 饥饿度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#sethunger" rel="noopenner">SetHunger</a>接口，设置玩家饥饿度 |
| 饥饿临界值 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setstarvelevel" rel="noopenner">SetStarveLevel</a>接口，设置玩家饥饿临界值，当饥饿值小于饥饿临界值时会自动扣除血量，开启饥饿值且开启饥饿掉血时有效。原版默认值为1 |
| 开启饥饿掉血 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setnaturalstarve" rel="noopenner">SetNaturalStarve</a>接口，设置是否开启玩家饥饿掉血，当饥饿值小于饥饿临界值时会自动扣除血量，开启饥饿值且开启饥饿掉血时有效.原版默认开启 |
| 饥饿掉血速度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setstarvetick" rel="noopenner">SetStarveTick</a>接口，设置玩家饥饿掉血速度，当饥饿值小于饥饿临界值时会自动扣除血量，开启饥饿值且开启饥饿掉血时有效 |
| 开启自然恢复 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setnaturalregen" rel="noopenner">SetNaturalRegen</a>接口，设置是否开启玩家自然恢复 |
| 自然恢复速度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#sethealthtick" rel="noopenner">SetHealthTick</a>接口，设置玩家自然恢复速度 |
| 最大消耗度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setmaxexhaustionvalue" rel="noopenner">SetMaxExhaustionValue</a>接口，设置玩家最大消耗度(maxExhaustion) |
@@ -70,17 +70,17 @@ PlayerPreset（玩家预设）是一类特殊的实体预设，玩家预设与
| 属性 | 描述 |
| ------------ | ------------------------------------------------------------ |
| 最大台阶高度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setstepheight" rel="noopenner">SetStepHeight</a>接口，设置玩家前进非跳跃状态下能上的最大台阶高度, 默认值为0.5625，1的话表示能上一个台阶。 |
| 玩家飞行状态 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#changeflystate" rel="noopenner">ChangeFlyState</a>接口，勾选则给予飞行能力并进入飞行状态，不勾选则进入非飞行状态。 |
| 是否可跳跃 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setjumpable" rel="noopenner">SetJumpable</a>接口，设置玩家是否可跳跃 |
| 是否可移动 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setmovable" rel="noopenner">SetMovable</a>接口，设置玩家是否可移动 |
| 最大台阶高度 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setstepheight" rel="noopenner">SetStepHeight</a>接口，设置玩家前进非跳跃状态下能上的最大台阶高度, 默认值为0.5625，1的话表示能上一个台阶。 |
| 玩家飞行状态 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#changeflystate" rel="noopenner">ChangeFlyState</a>接口，勾选则给予飞行能力并进入飞行状态，不勾选则进入非飞行状态。 |
| 是否可跳跃 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setjumpable" rel="noopenner">SetJumpable</a>接口，设置玩家是否可跳跃 |
| 是否可移动 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setmovable" rel="noopenner">SetMovable</a>接口，设置玩家是否可移动 |
### 行为设置：设置玩家行为逻辑相关的属性
| 属性 | 描述 |
| -------------- | ------------------------------------------------------------ |
| 死亡不掉落物品 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#enablekeepinventory" rel="noopenner">EnableKeepInventory</a>接口，设置玩家死亡不掉落物品 |
| 拾取物品范围 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setpickuparea" rel="noopenner">SetPickUpArea</a>接口，设置玩家的拾取物品范围 |
| 死亡不掉落物品 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#enablekeepinventory" rel="noopenner">EnableKeepInventory</a>接口，设置玩家死亡不掉落物品 |
| 拾取物品范围 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setpickuparea" rel="noopenner">SetPickUpArea</a>接口，设置玩家的拾取物品范围 |
@@ -88,4 +88,4 @@ PlayerPreset（玩家预设）是一类特殊的实体预设，玩家预设与
| 属性 | 描述 |
| -------------- | ------------------------------------------------------------ |
| 原版自定义皮肤 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setskin" rel="noopenner">SetSkin</a>接口，更换玩家原版模型的自定义皮肤，会覆盖原有皮肤，但会被骨骼模型覆盖。 |
| 原版自定义皮肤 | 等同于玩家对象PlayerObject下的<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/玩家对象PlayerObject.html#setskin" rel="noopenner">SetSkin</a>接口，更换玩家原版模型的自定义皮肤，会覆盖原有皮肤，但会被骨骼模型覆盖。 |

20
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/10-预设/6-文字面板预设.md
View File

@@ -14,7 +14,7 @@ time: 5分钟
TextBoardPreset（文字面板预设）是一类绑定**文字面板**的特殊预设，目的是能够快速创建、编辑和使用文字面板。
> 对于文字面板的概念，开发者可以参阅为[文字面板的定义](../../../../20-玩法开发/10-基本概念/1-我的世界基础概念.md#文字面板)以及<a href="../../../../../mcdocs/3-PresetAPI/预设对象/预设/文字面板对象TextboardObject.html" rel="noopenner"> 文字面板预设相关接口 </a>
> 对于文字面板的概念，开发者可以参阅为[文字面板的定义](../../../../20-玩法开发/10-基本概念/1-我的世界基础概念.md#文字面板)以及<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/预设/文字面板对象TextboardObject.html" rel="noopenner"> 文字面板预设相关接口 </a>
## 创建与添加
我们分别提供了内置文字面板预设和可供创建的普通文字面板预设。
@@ -35,7 +35,7 @@ TextBoardPreset（文字面板预设）是一类绑定**文字面板**的特殊
![面板属性](./images/textboardattr.png)
| 属性 | 说明 |
| :--- | :--- |
| 文本内容| 文字面板上所显示的文字内容，支持[样式代码](https://minecraft-zh.gamepedia.com/%E6%A0%B7%E5%BC%8F%E4%BB%A3%E7%A0%81)|
| 文本内容| 文字面板上所显示的文字内容，支持[样式代码](https://zh.minecraft.wiki/w/%E6%A0%B7%E5%BC%8F%E4%BB%A3%E7%A0%81)|
|始终面向相机| 默认开启，勾选后文字面板会随着相机移动而改变朝向，始终保持正面朝向相机 |
| 深度测试 | 默认开启，勾选后文字面板会按照正常的前后顺序进行遮挡或显示 |
| 文本颜色 | 文字面板上文本内容的颜色 |
@@ -55,31 +55,31 @@ TextBoardPreset（文字面板预设）是一类绑定**文字面板**的特殊
功能需求：
1. 在世界坐标（0，65，0）放置一个文字面板，内容为“你好，我的世界”
2. 为一个牛的实体预设挂接一个文字面板，显示内容“我是一头牛”。
实现步骤：
1. 首先对于第一个功能，我们直接在关卡编辑器将预设库中内置的文字面板预设拖动到场景舞台中，并修改其坐标为（0，65，0），如下图所示
![拖动内置预设](./images/textboard_1.gif)
2. 对于第二个功能，我们先分别创建一个使用了牛的模板的实体预设
![创建实体预设](./images/textboard_2.gif)
3. 再创建一个文字面板预设，并将其挂接到实体预设下
![挂接](./images/textboard_3.gif)
4. 调整位置和属性（位置、旋转、缩放可直接使用拖柄调整）
![调整属性](./images/textboard_4.gif)
5. 在关卡编辑器内将该实体预设拖动到场景舞台上
![拖动到场景](./images/textboard_5.gif)
@@ -87,6 +87,6 @@ TextBoardPreset（文字面板预设）是一类绑定**文字面板**的特殊
![最终效果](./images/textboard-6.png)
7. 如果我们进一步调整预设的面板属性，并充分利用[样式代码](https://minecraft-zh.gamepedia.com/%E6%A0%B7%E5%BC%8F%E4%BB%A3%E7%A0%81)，就能创造出更丰富的效果。
7. 如果我们进一步调整预设的面板属性，并充分利用[样式代码](https://zh.minecraft.wiki/w/%E6%A0%B7%E5%BC%8F%E4%BB%A3%E7%A0%81)，就能创造出更丰富的效果。
![高级效果](./images/textboard-7.png)

2
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/11-内置零件/00-触发器零件.md
View File

@@ -24,4 +24,4 @@ TriggerPart（触发器零件）包含一个长方体的区域，可以使用触
![parts003](./images/parts003.gif)
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcdocs/3-PresetAPI/预设对象/零件/触发器零件TriggerPart.html" rel="noopenner"> 触发器零件的API接口文档 </a>
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/触发器零件TriggerPart.html" rel="noopenner"> 触发器零件的API接口文档 </a>

2
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/11-内置零件/01-玩家基础属性零件.md
View File

@@ -20,4 +20,4 @@ PlayerBasicPart（玩家基础属性零件）是一种只能挂接到玩家预
![image-20210708150107248](./images/image-20210708150107248.png)
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcdocs/3-PresetAPI/预设对象/零件/玩家基础属性零件PlayerBasicPart.html" rel="noopenner"> 玩家基础属性零件的API接口文档 </a>
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/玩家基础属性零件PlayerBasicPart.html" rel="noopenner"> 玩家基础属性零件的API接口文档 </a>

2
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/11-内置零件/02-世界属性零件.md
View File

@@ -15,4 +15,4 @@ time: 20分钟
![parts005](./images/parts005.png)
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcdocs/3-PresetAPI/预设对象/零件/世界属性零件WorldPart.html" rel="noopenner"> 世界属性零件的API接口文档 </a>
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/世界属性零件WorldPart.html" rel="noopenner"> 世界属性零件的API接口文档 </a>

8
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/11-内置零件/03-相机轨迹CameraTrackPart.md
View File

@@ -21,7 +21,7 @@ time: 20分钟
1. 预览路径：用于控制是否开启预览路径，预览路径就是用线条和箭头在预设场景中显示相机动画的轨迹路线，即上面示意图中的部分。
2. 播放：勾选则在预设场景中播放当前相机轨迹动画。
3. 轨迹：即相机轨迹动画中的每个轨迹点的信息，可以理解为关键帧动画中的某一帧，代表相机在某个时间点须将自身的位置旋转等信息变换到这个轨迹点所代表的状态上。相机轨迹零件的作用就是让玩家能够自由编辑相机的轨迹点信息，从而构成相机动画。可以通过轨迹右侧的"+"按钮新增轨迹点，每个轨迹点的属性如下：
>偏移：该轨迹点相对于整个相机轨迹零件的位置偏移量
@@ -35,7 +35,7 @@ time: 20分钟
>时间：上一个轨迹点到当前轨迹点所需时间，越长，相机变换的速度越缓慢
4. 轨迹点操作方式：
![parts009](./images/parts009.png)
1. 轨迹点顶部按钮，可以快捷执行删除轨迹点、上移轨迹点、下移轨迹点、上方新建轨迹点四种操作。
@@ -44,9 +44,9 @@ time: 20分钟
>记录当前摄像头信息：将预设场景界面的摄像头信息记录在当前轨迹点，当前支持记录位置和旋转两种信息。
>
>定位：在预设场景展示该轨迹点的坐标，并提供坐标轴供玩家进行可视化操作来调整轨迹点的位置信息。
充分熟悉上述操作方式后，我们能够更快速和便捷地进行相机轨迹动画的创作，并随时进行路径的预览和播放，如下图所示
![cameratrack](./images/cameratrack.gif)
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcdocs/3-PresetAPI/预设对象/零件/相机轨迹CameraTrackPart.html" rel="noopenner"> 相机轨迹零件的API接口文档 </a>
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/相机轨迹CameraTrackPart.html" rel="noopenner"> 相机轨迹零件的API接口文档 </a>

4
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/11-内置零件/04-实体零件.md
View File

@@ -14,7 +14,7 @@ time: 20分钟
![custommonster](./images/custommonster.png)
- 自动创建：是否在零件初始化时，自动创建关联实体ID，如果不勾选，则需要手动调用零件的API创建关联实体ID，可以参考<a href="../../../../../mcdocs/3-PresetAPI/预设对象/零件/实体零件EntityBasePart.html" rel="noopenner"> 实体零件API接口文档 </a>。
- 自动创建：是否在零件初始化时，自动创建关联实体ID，如果不勾选，则需要手动调用零件的API创建关联实体ID，可以参考<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/实体零件EntityBasePart.html" rel="noopenner"> 实体零件API接口文档 </a>。
- 实体类型：实体零件所绑定的实体类型，这里支持原版实体和未绑定预设的实体配置。
>注意：实体类型不支持实体预设
@@ -37,4 +37,4 @@ time: 20分钟
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcdocs/3-PresetAPI/预设对象/零件/实体零件EntityBasePart.html" rel="noopenner"> 实体零件的API接口文档 </a>
>如果需要在游戏中使用脚本调用此零件，可以参考<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/实体零件EntityBasePart.html" rel="noopenner"> 实体零件的API接口文档 </a>

10
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/11-内置零件/05-导航路径零件.md
View File

@@ -12,9 +12,9 @@ time: 20分钟
这里着重讲一下巡逻路径属性，巡逻路径的本质就是一组有顺序的位置坐标数据。巡逻路径有两个属性：
1. 预览路径：用于控制是否开启预览路径，预览路径就是用线段和箭头将所有巡逻点连接起来，让玩家在编辑路径时能够直观地看到每个点之间的位置和顺序关系。
2. 路径：即巡逻路径上的每个巡逻点的信息，通过右侧的"➕"按钮可以新建巡逻点，巡逻点下包含该点的位置坐标。
2. 路径：即巡逻路径上的每个巡逻点的信息，通过右侧的"➕"按钮可以新建巡逻点，巡逻点下包含该点的位置坐标。
3. 路径操作方式：每个巡逻点上方的菜单（下图中A框）可以进行巡逻点的删除、上移、下移和上方新建四种快捷操作。右侧的记录摄像机位置（下图中B框）和定位按钮（下图中C框）可以让你更为便捷地进行路径点的可视化选取和移动。
![parts011](./images/parts011.png)
@@ -25,9 +25,9 @@ time: 20分钟
这里举一个运用导航路径零件的例子：在塔防游戏中，我们希望怪物出生后按照一定的路径进行移动巡逻，比如从起始点开始，走向第二个巡逻点，再走向第三个巡逻点，以此类推，形成一条巡逻路径。那么如何快速进行路径的可视化编辑呢？
为了达到这个效果，我们可以在编辑器内使用导航路径零件，提前构造好巡逻路径点，然后在脚本中使用本零件的接口(<a href="../../../../../mcdocs/3-PresetAPI/预设对象/零件/导航路径零件NavPointsPart.html" rel="noopenner"> GetNavigationPoints </a>)快速获得所有巡逻点的数据，再调用寻路接口(<a href="../../../../../mcdocs/1-ModAPI/接口/实体/行为.html" rel="noopenner"> SetMoveSetting </a>)让怪物依次在各个点之间移动，以此达到怪物移动巡逻的效果。
为了达到这个效果，我们可以在编辑器内使用导航路径零件，提前构造好巡逻路径点，然后在脚本中使用本零件的接口(<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/导航路径零件NavPointsPart.html" rel="noopenner"> GetNavigationPoints </a>)快速获得所有巡逻点的数据，再调用寻路接口(<a href="../../../../../mcdocs/1-ModAPI/接口/实体/行为.html" rel="noopenner"> SetMoveSetting </a>)让怪物依次在各个点之间移动，以此达到怪物移动巡逻的效果。
>这里只是一个简单使用案例，导航路径零件主要帮助开发者可视化编辑路径/位置数据，具体使用还需要开发者根据实际需要灵活运用哦~
关于导航路径零件的接口，可以参考<a href="../../../../../mcdocs/3-PresetAPI/预设对象/零件/导航路径零件NavPointsPart.html" rel="noopenner"> 导航路径零件的API接口文档 </a>
关于导航路径零件的接口，可以参考<a href="../../../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/导航路径零件NavPointsPart.html" rel="noopenner"> 导航路径零件的API接口文档 </a>

2
mcguide/20-玩法开发/14-预设玩法编程/0-理解预设系统/11-内置零件/07-天空盒零件.md
View File

@@ -20,7 +20,7 @@ time: 20分钟
![图片](./images/skybox.png)
2. 创建一个预设并将零件挂接到预设下，调整对应属性
![图片](./images/skybox11.png)