跳转到内容

Begin

节点介绍

Begin节点是EZMenu中最开始的节点,菜单逻辑从这里开始。Begin节点只有一个输出,用于连接到主菜单。

输入

输出

  • Start - 连接到主菜单。

节点属性

Begin节点拥有很多属性,这些属性将决定菜单的运行方式,在Begin节点中,我们可以设置项目的名称、描述、版本、作者等信息。这些信息将有助于您更好地管理您的项目。

  • Title - 这是这个节点的名字,可以自定义,这个属性是每个节点都有的,并且都可以自定义,你可以用来标识这个节点的功能。以下将不再对这个属性进行介绍。
  • ProjectName - 这是这个项目的名字,可以自定义,在导出项目时,默认的项目名字是这个属性的值。生成的脚本文件也会以这个属性的值命名。并且会在生成的脚本文件中显示这个属性的值。
  • ProjectDescription - 这是这个节点的描述,可以自定义,用于帮助你记录项目的相关信息。建议填写这个属性,以便在以后项目中更好地管理项目。
  • ProjectVersion - 这是这个项目的版本号,可以自定义,用于标识项目的版本。在您更新脚本时,可以通过这个属性来标识版本号。
  • ProjectAuthor - 这是这个项目的作者,可以自定义,用于标识项目的作者。若您想与他人分享项目,可以通过这个属性来标识作者。

以上是项目属性,接下来是决定菜单打开条件的属性,你可以根据自己的需求来设置。这可能有点复杂,我会在下面详细介绍这些属性,并提供一些示例场景的设置。

  • RequiredTouch - 点击模型是否打开菜单。若为true,点击模型会打开菜单,若为false,点击模型不会打开菜单。
  • RequiredSit - 是否坐上去才能打开菜单。若为true,需要坐上后才能打开菜单,若为false,则不需要坐上去也可打开菜单。当这项为true时,需要设置以下属性:
    • SitText - 设置模型上的坐上文本,可用于提示玩家坐上。
    • SitTargetOffset - 坐上后的位置偏移量,这个不能为<0,0,0>,否则会导致坐上后无法触发Sit事件。
    • ShowMenuOnSit - 坐上后是否自动打开菜单。若为true,则坐上后自动显示菜单,否则不会自动显示菜单。
  • RequiredAttach - 是否穿戴后才能打开菜单,对于一些需要穿戴才能使用的模型,可以设置这个属性为true。如果为false,表示不需要穿戴也能打开菜单。当这项为true时,可以设置:
    • ShowMenuOnAttach - 穿戴后是否自动打开菜单。若为true,穿戴后自动打开菜单,否则不会自动打开菜单。
  • EnabledWhileSitting - 坐上模型后菜单是否可用。若为true,坐上后菜单可用,若为false,则坐上后菜单将不可用。
  • RememberLastMenu - 是否记住上次打开的菜单。若为true,则记住上次打开的菜单,当下次打开菜单时,会自动打开上次打开的菜单,若为false,则不会记住上次打开的菜单,每次打开菜单时都会打开主菜单。
  • MenuExpireTime - 设置菜单的过期时间,单位为秒。当菜单打开后,经过这个时间后,菜单会自动过期。若设置为0,则菜单永不过期。
  • EnableDebugMode - 是否启用调试模式。启用调试模式后,会在公屏输出一些调试信息,这对于定制化开发和调试的人有用,若你不关心这些信息,可以将这个属性设置为false
  • Signature - 这是产品的签名信息,若你的产品需要发送给他人使用,可以通过脚本[EZMenu]setup来获取签名信息,并将签名信息填写到这个属性中。再使用[EZMenu]master脚本替换掉[EZMenu]setup脚本。 [EZMenu]setup脚本只能在你制作材质贴图过程中使用,它不需要签名,但是这个脚本不可以发送给其他人。只有使用[EZMenu]master替换掉[EZMenu]setup后才可以将您的产品发送给他人。

relationship

示例场景

示例场景一: 无需坐上去,无需穿戴,点击打开菜单

RequiredTouch: true
RequiredSit: false
RequiredAttach: false
EnabledWhileSitting: true

示例场景二: 需要坐上去,无需穿戴,点击打开菜单

RequiredTouch: true
RequiredSit: true
RequiredAttach: false
EnabledWhileSitting: true

示例场景三: 需要穿戴,无需坐上去,点击打开菜单

RequiredTouch: true
RequiredSit: false
RequiredAttach: true

示例场景四: 不需要穿戴,不需要坐上去,点击打开菜单,但坐上后菜单不可用

RequiredTouch: true
RequiredSit: false
RequiredAttach: false
EnabledWhileSitting: false

错误设置示例

错误示例一:全部设置为false,没有打开菜单的方式

RequiredTouch: false
RequiredSit: false
ShowMenuOnSit: false
RequiredAttach: false
ShowMenuOnAttach: false

错误示例一:需要坐上去,坐上后不可使用菜单 (逻辑矛盾)

RequiredTouch: true
RequiredSit: true
EnabledWhileSitting: false
EZMenu

© 2025 EZMenu. All Rights Reserved.

Power by LiteGraph.js | Electron | Astro Starlight