blockly mode - goflishMC/fabled-temp GitHub Wiki

๐Ÿงฑ Blockly Mode (Optional)

Blockly Mode allows you to visually build skills using a drag-and-drop logic system instead of the standard form editor. This mode is ideal for complex skills that involve multiple triggers, mechanics, conditions, or nested logic.

๐ŸŽฎ Enabling Blockly Mode

  1. Click the โš™๏ธ Settings button in the bottom-right corner of the Web Editor.
  2. In the settings modal, toggle Blockly Mode to ON.
  3. Return to the Skills tab โ€” you will now see Blockly editing panels instead of standard forms.

Blockly can be toggled on or off at any time from the settings menu. Switching modes wonโ€™t delete your existing work.

๐Ÿงฑ How Blockly Works

In Blockly Mode, each skill is built by linking together visual blocks. These blocks represent:

  • Triggers โ€“ Events that start the skill (e.g., Cast, Initialize, OnKill)
  • Targets โ€“ What the skill affects (e.g., Self, Area, Location, Projectile)
  • Conditions โ€“ Logic gates that check for specific rules (e.g., "if health < 50%")
  • Mechanics โ€“ The actual effects (e.g., Damage, Heal, Teleport, Message)

These are arranged in a tree:

Trigger โ†’ Target โ†’ [Conditions] โ†’ Mechanics

Each block can contain nested logic, scaling formulas, and input fields.

๐Ÿ›  Features

  • ๐Ÿงฉ Component-Based Blocks โ€“ Every skill function is available as a modular block.
  • ๐Ÿ”„ Collapse/Expand โ€“ Double-click any block to collapse or expand it for readability.
  • ๐Ÿ” Search Toolbox โ€“ Use the search filter to quickly find mechanics or conditions.
  • ๐Ÿ”ง Preview Mode โ€“ Hover to see what each block configures.
  • โšก Live Updates โ€“ Changes are instantly reflected in the YAML export.
  • ๐Ÿง  Smart Grouping โ€“ Conditions and mechanics automatically nest based on block order.

โš ๏ธ Notes

  • Blockly skills are saved and exported just like form-based skills.
  • You do not need to convert blocks to YAML โ€” the editor handles this automatically.
  • Form-mode-only fields (e.g., name, icon, cooldown) are still configured outside the Blockly panel.

๐Ÿ” Switching Between Modes

  • You can switch back to Form Mode at any time by toggling Blockly Mode off in โš™๏ธ Settings.
  • Your Blockly structure will be retained, but not visible in Form Mode.
  • Form-mode-only mechanics cannot be edited visually.

๐Ÿ“ค Exporting

Once you're satisfied with your Blockly-built skill:

  • Click ๐Ÿ’พ Save to download the skill.
  • Or use the Backup All button to download all content to your device.
  • Place the resulting skills.yml in /plugins/Fabled/ and reload the plugin.

๐Ÿ”— Related Pages