🖱️ onClickDown & onClickUp

What are they?

onClickDown and onClickUp are API functions that allow assigning mouse callbacks to an object or UI element in the scene.

• onClickDown: triggered when the user clicks (mouse down) inside the object.
• onClickUp: triggered when the user releases the click (mouse up) inside the object.

📖 Syntax

onClickDown(target, callback);

onClickUp(target, callback);

• target → Object or object name to assign the event to.
• callback → Function executed when the event occurs. Receives the object as a parameter.

✅ Basic example

Suppose you have a UI button called StartButton:

onClickDown("StartButton", obj => {
  obj.color = "#888"; // change color on press
});

onClickUp("StartButton", obj => {
  console.log("Button clicked!");
  obj.color = "#0f0"; // change color on release
});

👉 This makes the button change color while pressed and perform the action when released.

✅ Another example with world objects

An enemy that reacts to mouse clicks:

onClickUp("Enemy1", obj => {
  obj.hp -= 10;
  console.log(obj.name + " takes damage on click");
});

📌 Notes