# AI 커넥터 실행기 — AI 없이 커넥터 쓰기

게임사가 공식으로 연 AI 커넥터를 **AI 없이** 쓰는 작은 프로그램이에요.
치는 말이 그대로 정해진 호출이 돼요. 생각하는 부분이 없어서 요금도 안 나와요.

만든 곳: aiconn.gwirae.com · 넥슨과 무관해요 · 넥슨의 서면 확인을 기다리는 중이에요.

---

## 먼저 알아 둘 것

- 이 프로그램은 **게임사가 열어 둔 일만** 불러요. 거래소, 성장 자동, 결제와 캐시샵,
  길드 운영, 아이템 버리기와 분해, 1대1 대화, 로그인 대행은 아예 안 들어 있어요.
- 활동 한 번에 **정령의 날개 5개**가 나가요. 게임사 공식 가이드에 적힌 수예요.
- 한 시간 넘게 이어지면 게임이 확인 팝업을 띄워요. 그건 게임이 하는 일이라 그대로 둬요.
- 게임이 켜져 있고, 환경 설정에서 AI 커넥터가 켜져 있어야 해요.
- 우리는 이 프로그램을 실제 게임에 붙여 끝까지 돌려 보지 않았어요. 모의 프로그램으로
  부르는 꼴만 확인했어요. 값이 다르면 게임사 문서가 맞아요.
- 우리 서버로 가는 것은 아무것도 없어요. 실행은 전부 이 PC 에서 돼요.

## 깔기

1. Node.js 를 깔아요. nodejs.org 에서 LTS 를 받으면 돼요(18 이상이면 돼요).
2. 이 폴더를 아무 데나 풀어요.
3. 게임을 켜고 메뉴(삼선)에서 환경 설정, 게임, AI 제어로 들어가 AI 커넥터(Beta)를 켜요.
4. `run.cmd` 를 두 번 눌러요.

게임을 기본 자리가 아닌 곳에 깔았으면 자리를 알려 줘요.

```
node runner.mjs --cli "D:\내폴더\MabinogiMobile_CLI.exe" ask get_current_environment
```

## 쓰는 말

```
node runner.mjs ask get_current_environment    지금 어디고 날씨가 어떤지 봐요
node runner.mjs ask get_currencies             정령의 날개가 몇 개 남았는지 봐요
node runner.mjs ask get_gatherable_items 양털  채집할 수 있는 것을 찾아봐요
node runner.mjs gather 양털 20                 스무 개 모을 때까지 채집을 맡겨요
node runner.mjs craft 굵은실 5                 다섯 번 제작을 맡겨요
node runner.mjs alter 양털실                   가공을 걸어요
node runner.mjs collect                        끝난 가공을 받아요
node runner.mjs music 즐거운나의집 류트        악기를 바꿔 연주를 맡겨요
node runner.mjs stop                           하던 걸 멈춰요
node runner.mjs chat 곧 갈게요                 확인을 친 뒤에만 보내요
node runner.mjs list                           부를 수 있는 것을 다 적어요
```

이름은 짐작하지 않아요. 채집이든 제작이든 먼저 게임에 물어서 **글자 그대로 맞는 줄**을
찾고, 못 찾으면 비슷한 이름을 적어 주고 멈춰요. 그때는 날개도 안 나가요.

날개 상한은 한 번 돌 때 30개예요. 바꾸려면 `--wings 60` 처럼 적어요.

## 막혔을 때

| 나오는 말 | 뜻 | 할 일 |
|---|---|---|
| 게임 프로그램을 못 찾았어요 | 기본 자리에 없어요 | `--cli` 로 자리를 알려 줘요 |
| cli_not_found | 그 자리에 파일이 없어요 | 경로를 다시 봐요 |
| 답이 안 왔어요 | 게임이 안 켜졌거나 커넥터가 꺼졌어요 | 게임과 토글을 봐요 |
| 글자 그대로 없어요 | 이름이 게임 표기와 달라요 | 적어 준 비슷한 이름으로 다시 쳐요 |
| 게임이 확인을 요구했어요 | 한 시간 팝업이에요 | 게임 화면에서 직접 눌러요 |

더 자세한 증상표는 aiconn.gwirae.com/diag 에 있어요.

## 만든 근거

- 허용·금지 작업, 정령의 날개 5개, 한 시간 팝업: 게임사 공식 가이드(2026-09-20 확인)
- 명령 이름과 부르는 꼴: 공개 저장소 KwangB/mabinogi-mobile-ai-agent (MIT, Copyright 2026 KwangB)
  를 **읽고** 우리가 다시 썼어요. 그 코드를 복사해 오지 않았고 다시 나눠 주지도 않아요.
  원 저장소: https://github.com/KwangB/mabinogi-mobile-ai-agent

## 내릴 수 있어요

넥슨의 서면 확인을 기다리는 중이에요. 정책이 바뀌거나 안 된다는 답이 오면 이 파일을 내려요.

---

# English

A tiny program that uses the game studio's official AI connector **without any AI**.
What you type maps straight to a fixed call, so there is no model and no bill.

- It calls only what the studio allows. Trading, auto levelling, payments, guild actions,
  discarding items, direct messages and signing in are not in this code at all.
- Each activity spends 5 Spirit Wings, the number the official guide states.
- After an hour the game shows a confirmation popup. That is the game's doing. Leave it.
- Install Node.js 18 or newer, switch the connector on in Settings, Game, AI Control,
  then double click `run.cmd`.
- Nothing is sent to us. Everything runs on your PC.
- We have not run this against a live game end to end. We verified the call shape against a
  mock program only. Where our text differs from the studio's page, the studio's page wins.
- Not affiliated with Nexon. We are waiting on written confirmation from Nexon, and we will
  take this down if the answer or the policy says no.

Command names and the call shape were learned by reading KwangB/mabinogi-mobile-ai-agent
(MIT, Copyright 2026 KwangB) and rewritten here. We do not redistribute that code.