🖱 Click Types & Action Chains
Every slot can have up to 5 different action chains based on how the player clicks it.
The Five Click Types
| Tab | Trigger | Common Use |
|---|---|---|
| LEFT | Left mouse button | Primary action (buy, teleport, equip) |
| RIGHT | Right mouse button | Secondary action (sell, info) |
| MID | Middle/scroll wheel click | Bulk action (buy 16, preview) |
| S-L | Shift + Left click | Stack action, fast tier |
| S-R | Shift + Right click | Bulk sell, alternate option |
How Action Chains Execute
Actions run top to bottom, in order. If any [require], [take], or [cooldown] fails, the chain stops immediately and remaining actions are skipped.
Example chain on a "Buy Diamond" button:
[require] %vault_eco_balance% >= 500 &cYou need $500![require] %player_empty_slots% >= 1 &cInventory full![console] eco take %player% 500[give] DIAMOND 1[sound] ENTITY_EXPERIENCE_ORB_PICKUP[message] &aPurchased!
If the player has $400, step 1 fails and they get the deny message. Steps 2–6 never run.
Reordering Actions
Each action card has a drag handle in the header. Click and drag to reorder. The order is critical — always put gatekeeper actions ([require], [take], [cooldown]) before reward actions.
Copy & Paste Actions
Each action card has a copy icon (⎘). Click to copy that single action to clipboard. Then click the paste icon (⇣) on any other slot's tab to paste it. Massive time-saver for repeated logic across slots.
The 50-Action Loop Limit
To prevent server crashes from bad menu design, action chains are limited to 50 sequential actions per click. If you somehow chain 50+ actions, the runtime aborts and logs a warning. This is generous — most chains are 5–10 actions.
Spam Protection
NxMenu has built-in protection:
- 150ms click debounce — Prevents accidental double-clicks from running the chain twice.
- 50ms menu open spam guard — Prevents rapid-fire menu opening.
- Chain processing lock — A new chain can't start while a previous one is still mid-execution.