> For the complete documentation index, see [llms.txt](https://ayccoes-assets.gitbook.io/ayccoes-assets/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayccoes-assets.gitbook.io/ayccoes-assets/ayc-minigames/series-1.md).

# 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2F6e3pspxXEEPduPDiahFG%2Fds.webp?alt=media&amp;token=8a397583-247c-4417-ae77-358bd71f514e" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2FVQUok7uTACjDvS2XMQLR%2Fbo.webp?alt=media&amp;token=8258312c-0c83-4041-8f36-a0fe4359fc37" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2F12wO1nxLc7XKYMbTTtK2%2Ffm.webp?alt=media&amp;token=112b871f-0ee7-42d7-8b1e-a060b6ded850" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2FVvL0iZjrIDAQnRY0m5rd%2Flor.webp?alt=media&amp;token=9660d172-9d25-47c1-a7c7-5fea784815b7" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2FoUrRJVwOvrF6nhrxy9UI%2Flt.webp?alt=media&amp;token=eb00f1e0-a51b-4f0a-bcac-f96373101241" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2FufyfQsGypgIrHBTsSpMx%2Fla.webp?alt=media&amp;token=6e70f795-1bf5-4b4c-9f3e-e987289be282" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2FrWE4DsFuVSp5ixhLggtd%2Fmp.webp?alt=media&amp;token=84ebc287-7c39-46aa-b559-2a760af1a467" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2FUhAmOZZFMzT3NxBn7wtD%2Fms.webp?alt=media&amp;token=479c8132-4cd6-4717-8f93-3ec7ed112af3" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2F1QmeRVcSUQLgcrRul2K5%2Fmg.webp?alt=media&amp;token=8a4b1e1a-1b46-4b12-bea4-d4aca79ffd6a" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2Fgigpif1eekG7aHggqMlf%2Fpb.webp?alt=media&amp;token=91e19ba4-aed8-4821-8ea0-75731f041f40" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2FzeJtnmjiNmf5Cvn24qCA%2Fson.webp?alt=media&amp;token=2bb76a28-2c0d-439e-859f-e2f910047ee3" 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="https://2118294136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK3n6uHN9cTijiM2iemtD%2Fuploads%2Fb1WPrqLfMLZk7kwVNIXK%2Fts.webp?alt=media&amp;token=ff429db8-4f24-48de-8474-965104efbeca" 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. |