# Series 1

Series 1 features 12 unique, highly customizable mini-games. Explore each one below, and learn how to start them using the exported functions.

### 1. Directional Sequence

Press the sequence of directions shown from left to right.

<figure><img src="/files/mh2tS013IedL9YyBCbH1" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartDirectionalSequence(length, time, stages, guide, startType)
```

**Parameters:**

| Name     | Type | Default    | Description             |
| -------- | ---- | ---------- | ----------------------- |
| `length` | int  | random 2–5 | Length of the sequence. |

***

### 2. Button Order

Repeat the sequence of button presses shown.

<figure><img src="/files/p9I3WDGRfUmAG8RsFWEG" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartButtonOrder(buttonAmount, sequenceLength, buttonsSpeed, time, stages, guide, startType)
```

**Parameters:**

| Parameter        | Type | Default | Description                              |
| ---------------- | ---- | ------- | ---------------------------------------- |
| `buttonAmount`   | int  | 4–10    | Number of buttons.                       |
| `sequenceLength` | int  | 3–6     | Length of the button sequence.           |
| `buttonsSpeed`   | int  | 1–3     | Speed at which buttons preview is shown. |

***

### 3. Frequency Match

Adjust your wave to match the target wave by changing its height and period.

<figure><img src="/files/MVOFbxz3cYValoOU66tj" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartFrequencyMatch(time, stages, guide, startType)
```

***

### 4. Left or Right

Press the correct direction in a sequence.

<figure><img src="/files/O7cpMSKIDWzsiFUvUq9i" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartLeftOrRight(length, time, stages, guide, startType)
```

**Parameters:**

| Parameter | Type | Default | Description             |
| --------- | ---- | ------- | ----------------------- |
| `length`  | int  | 5–15    | Length of the sequence. |

***

### 5. Letter Track

Press the highlighted letters as they pass under the frame.

<figure><img src="/files/AgZ1B7gNG4TsbLU1lIQ9" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartLetterTrack(highlightAmount, highlightRatio, time, trackSpeed, stages, guide, startType)
```

**Parameters:**

| Parameter         | Type | Default | Description                                  |
| ----------------- | ---- | ------- | -------------------------------------------- |
| `highlightAmount` | int  | 2–6     | Number of letters highlighted on the track.  |
| `highlightRatio`  | int  | 1–3     | Ratio of all letters to highlighted letters. |
| `trackSpeed`      | int  | 1–3     | Speed at which the letters move.             |

***

### 6. Line Alignment

Press space when the pin is positioned between the lines.

<figure><img src="/files/eK5LB7zt0wsaF2b1hPWL" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartLineAlignment(cuts, difficulty, time, speed, stages, guide, startType)
```

**Parameters:**

| Parameter    | Type | Default | Description                                            |
| ------------ | ---- | ------- | ------------------------------------------------------ |
| `cuts`       | int  | 2–6     | Number of cuts.                                        |
| `difficulty` | int  | 1–5     | Difficulty level of the alignment. (affects threshold) |
| `speed`      | int  | 1–3     | Movement speed of the pin.                             |

***

### 7. Matching Pairs

Match all pairs by selecting two identical shapes at a time.

<figure><img src="/files/tAWQ9KbZ7IeuD2zSJrMG" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartMatchingPairs(pairs, time, colored, stages, guide, startType)
```

**Parameters:**

| Parameter | Type | Default | Description                        |
| --------- | ---- | ------- | ---------------------------------- |
| `pairs`   | int  | 4–10    | Number of pairs to match.          |
| `colored` | bool | false   | Whether the pairs are color-coded. |

***

### 8. Matching Switches

Match all switches to the system’s green switches.

<figure><img src="/files/QUaShuaME85RBVLVJ4Zk" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartMatchingSwitches(switchesAmount, time, speed, stages, guide, startType)
```

**Parameters:**

| Parameter        | Type | Default | Description                         |
| ---------------- | ---- | ------- | ----------------------------------- |
| `switchesAmount` | int  | 10–20   | Number of switches in the minigame. |
| `speed`          | int  | 1–3     | Movement speed of the switches.     |

***

### 9. Memory Game

Hover to reveal the letters, memorize them, then press the top sequence in order from left to right.

<figure><img src="/files/76XeILO5mFBXldsxFNj2" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartMemoryGame(shownLetters, sequenceLength, time, prepTime, showLettersAtPrep, stages, guide, startType)
```

**Parameters:**

| Parameter           | Type     | Default   | Description                                    |
| ------------------- | -------- | --------- | ---------------------------------------------- |
| `shownLetters`      | int      | 5–12      | Number of letters shown initially to memorize. |
| `sequenceLength`    | int      | 2–5       | Length of the sequence to press.               |
| `prepTime`          | int (ms) | 3000–6000 | Time given to preview letters.                 |
| `showLettersAtPrep` | bool     | true      | Whether the sequence is shown during preview.  |

***

### 10. Password Brute

Crack the password by testing digit combinations. Green digits are correct and well placed; yellow digits are correct but misplaced.

<figure><img src="/files/yw93MH3op3XSVYKEZvvm" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartPasswordBrute(tries, passwordLength, repetitive, time, stages, guide, startType)
```

**Parameters:**

| Parameter        | Type | Default | Description                                 |
| ---------------- | ---- | ------- | ------------------------------------------- |
| `tries`          | int  | 3–8     | Number of password attempts allowed.        |
| `passwordLength` | int  | 3–6     | Length of the password.                     |
| `repetitive`     | bool | false   | Whether numbers can repeat in the password. |

***

### 11. Seen or New

Choose whether you have seen the icon before or if it is new\..

<figure><img src="/files/rQ3cZZDlFyxIOfchLD7M" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartSeenOrNew(amount, colored, time, repetitionPossibility, stages, guide, startType)
```

**Parameters:**

| Parameter               | Type  | Default | Description                        |
| ----------------------- | ----- | ------- | ---------------------------------- |
| `amount`                | int   | 5–12    | Number of icons displayed.         |
| `colored`               | bool  | true    | Whether the icons are color-coded. |
| `repetitionPossibility` | float | random  | Chance that the next icon is seen. |

***

### 12. Typing Sequence

Press the sequence of letters shown from left to right.

<figure><img src="/files/gI15Nv8DH3kmKmYK2qqW" alt=""><figcaption></figcaption></figure>

```lua
local success = exports['ayc-minigames']:StartTypingSequence(length, time, stages, guide, startType)
```

**Parameters:**

| Parameter | Type | Default | Description                        |
| --------- | ---- | ------- | ---------------------------------- |
| `length`  | int  | 2–5     | Number of letters in the sequence. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ayccoes-assets.gitbook.io/ayccoes-assets/ayc-minigames/series-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.