Getting Started

Directory Setup

Set up your project folder structure and core files

Let's set up your project structure.

Choose a Project Name

Pick a simple name for your routines folder. For this guide, we'll use example:

scripts/synq/routines/example/

Keep it simple no spaces or special characters. This folder will hold all your rotation files.

Create Your Project Structure

Step 1: Navigate to your SYNQ folder (located in your unlocker directory/scripts)
Step 2: Create the project directory:

scripts/synq/routines/example/

This becomes your project root where all your rotation files will live.

Create Your Core Config File

Create example.lua in your project folder. This file registers your rotation actors with SYNQ:

local Unlocker, synq, example = ...

example.hunter = {
  bm = synq.Actor:New({ spec = 1, class = "hunter" }),
  mm = synq.Actor:New({ spec = 2, class = "hunter" }),
  sv = synq.Actor:New({ spec = 3, class = "hunter" }),
}

Important: Any rotation files you create must be registered here, otherwise SYNQ won't load them.

Verify SYNQ is Working

Test that SYNQ is loaded correctly. In game chat, run:

/dump synq.hello

If you see a message, SYNQ is loaded and ready. If not, double-check that SYNQ is properly installed in your unlocker folder.


Next: Create your rotation actor in Routine Actor & File Layout.