Trigger

• Code location: /adjunct/basic_trigger.js

• Trigger component is used to place a triggerable component, which only runs in game mode.

Data Structure

• The data structure of Trigger is defined as follows:

      [
          [2, 2, 3],                //0.trigger size
          [12, 4, 1.5],             //1.trigger position in block
          [0, 0, 0],                //2.trigger rotation
          1,                        //3.wether stop
          0,                        //4.trigger event, [in,out,hold,touch]
          [                         //5.task when triggered
              [
                  [[1,3],1,0]             //`condition`, can be empty, run anyway
                  [[2,0x00a2,3],[0]],     //`task_todo`, adjunct.wall.hide, [index]
                  [[1,1,2],[1,33]]        //`task_abord`, system.ui.toast()
                  [[2,0x00a1,1],[]],      //`task_recover`, adjunct.wall
              ],
          ], 
          0,                        //6.contract              
          1                         //7.run one time
      ]

• When the data has no version information, the default version is "2025".

Types

• Trigger will support various types of geometric shapes to implement complex trigger states.

Geometry	Detail	Support
box	3D box trigger	✅
ball	Spherical obstruction trigger	❌
cylinder	Column barrier trigger	❌

Task Structure

• Trigger uses conditional judgment to determine whether to execute, and uses a large number of predefined methods for processing. It is a complex system that needs to be handled carefully.

Definition

• The definitions adopted by Trigger need to be published on the chain.

      {
          "RAW_TRIGGER_SHAPE_OPTION":     3,      //["box","ball","more"]
          "RAW_TRIGGER_OPTION":           4,      //["in","out","hold"]
          "RAW_ACTION_GROUP":             5,      //
          "RAW_CONTRACT_ID_ON_CHAIN":     6,
          "RAW_RUN_ONCE":                 7,
          "RAW_ONLY_GAME_MODE":           8,
  
          //action array [ "condition", "todo_task", "abord_task", "recover_task" ]
          "ACTION_INDEX_CONDITION":   0,
          "ACTION_INDEX_TODO":        1,
          "ACTION_INDEX_ABORD":       2,
          "ACTION_INDEX_RECOVER":     3,
          //condition array [ "selection_array", "operator", "value" ]
          "CONDITION_INDEX_SELECTION":    0,
          "CONDITION_INDEX_OPERATOR":     1,
          "CONDITION_INDEX_VALUE":        2,
          //task array    [ "selection", ]
  
          //section array,
          "SELECTION_INDEX_TYPE":     0,
          "SELECTION_TYPE_OPETION_SYSTEM":    1,
          "SELECTION_TYPE_OPETION_ADJUNCT":   2,
          "SELECTION_TYPE_OPETION_PLAYER":    3,
          "SELECTION_TYPE_OPETION_BAG":       4,
  
          //system selection
          "SELECTION_SYSTEM_SUB":     1,
          "SYSTEM_SUB_OPTION_UI":     1,
          "SYSTEM_SUB_OPTION_TIME":   2,
          "SYSTEM_SUB_OPTION_WEATHER":3,
          "SYSTEM_SUB_OPTION_SKY":    4,
  
          "SYSTEM_UI_OPTION_DIALOG": 1,
          "SYSTEM_UI_OPTION_TOAST":  2,
  
          //adjunct selection
          "SELECTION_ADJUNCT_SHORT":  1,
          "SELECTION_ADJUNCT_INDEX":  2,
  
          //player selection
          //["position","rotation","body","block","capacity","blood","magic"]
          "SELECTION_PLAYER_ATTIBUTION":  1,
          "PLAYER_ATTIBUTION_OPTION_POSITION":    0,
          "PLAYER_ATTIBUTION_OPTION_ROTATION":    1,
          "PLAYER_ATTIBUTION_OPTION_BODY":        2,
          "PLAYER_ATTIBUTION_OPTION_BLOCK":       3,
          "PLAYER_ATTIBUTION_OPTION_CAPACITY":    4,
          "PLAYER_ATTIBUTION_OPTION_BLOOD":       5,
          "PLAYER_ATTIBUTION_OPTION_MAGIC":       6,
  
          //task definition
          "TASK_SYSTEM_UI_":      1,
  
          //bag selection
          "SELECTION_BAG_OBJECT":             1,
          "SELECTION_BAG_OBJECT_AMOUNT":      2,
  
          //adjuction task action
          "ACTION_ADJUNCT_SHOW":      1,
          "ACTION_ADJUNCT_HIDE":      2,
          "ACTION_ADJUNCT_UPDATE":    3,
  
          "ADJUNCT_UPDATE_OPTION_INC":   1,
          "ADJUNCT_UPDATE_OPTION_DEC":   1,
  
          "EVENT_OPTION_IN":          1,
          "EVENT_OPTION_OUT":         2,
          "EVENT_OPTION_HOLD":        3,
          "SHAPE_OPTION_BOX":         1,
          "SHAPE_OPTION_BALL":        2,
          "OPERATOR_!=":              0,
          "OPERATOR_==":              1,
          "OPERATOR_>":               2,
          "OPERATOR_<":               3,
          "OPERATOR_>=":              4,
          "OPERATOR_<=":              5,
      }