ZeroBrane Studio Setup

ZeroBrane Studio / Vectric Setup A guide on how to obtain and setting up ZeroBrane Studio on your PC to work with Vectric (Aspire/VCarve Pro).

Download Software

Download ZeroBrane Studio from the ZeroBrane Studio website | Download Page

Install the ZeroBrane Studio on your PC.

Read Documentation

Review the documentation page | Here

Review the short and simple overview | Here

The MUST READ section is the Debugging: | Here

Copy a File

This action is a Copy Only so DO NOT MOVE:

Copy the mobdebug.lua file 'From:; C:\ .... \ZeroBrains\lualibs\mobdebug\mobdebug.lua:

If you are running Aspire, copy To C:\Program Files\Aspire V??\Lua\

If you are running VCarve Pro, copy To C:\Program Files\VCarve Pro V??\Lua\

Install Seed Gadget

Download [| Gadget Seed File]

Open Aspire/VCarve Pro, using the Gadgets pull-down menu, select Install New Gadget and select the SeedGadget_006.vgadget.

Set Gadget Project

Open the ZeroBrane Studio, and locate and open the SeedGadget_006.lua file in your Gadget directory: (for example: C:\Users\Public\Documents\Vectric Files\Gadgets\VCarve Pro V??\)

Set your Project location, navigate to the pull down menu, Project then Project Directory and select Set From Current File

Edit Seed Gadget

To enable the ZeroBrane Studio for debugging, you will need edit line 18

From: -- require("mobdebug").start()

To: require("mobdebug").start().

Save your SeedGadget_006 gadget

Notes:

1. Not all gadgets use the require "strict" operator
2. The require "strict" AND require("strict") are the same operation
3. Some gadgets, will through an error when used require "strict" operator with require("mobdebug").start(). If this accrues, commit out the strict line of code.
4. Order of operation is important (see below):

Starting The Debugger

To start the Debugger Server, navigate the pull down menu, Project the and select Start Debugger Server

Debugging The Code

Open Aspire/VCarve Pro and run the SeedGadget_006 gadget.

Switch/toggle from Aspire/VCarve Pro, back to ZeroBrane Studio and begin using F10 key to step into the code.

Observe the green triangle indicating what line is about to be executed.

You will need to be able to Switch/toggle back and from Aspire/VCarve Pro and ZeroBrane Studio when one application needs interaction (next step, dialogue selection, etc.)

Please refer to the MUST READ section above, to toggle on/off breakpoints, watchlist, bookmarks and a host of other powerful debugging tools within the ZeroBrane Studio.