배포용플레이어

KoyangE 플레이 설명서

해·달·별 고양이가 되어 열두 지성(쥐→돼지)을 여행하는 접속형 액션 RPG입니다. 스토어(Google Play / App Store)에는 올리지 않습니다. LAN/내부 배포용입니다.

1. 접속

• 모바일 앱 KoyangE (내부 APK) 또는 브라우저 http://192.168.0.216:9001/
• 같은 Wi‑Fi / 사내망에서 서버(192.168.0.216:9001)에 닿아야 합니다.
• 캐릭터: 해 / 달 / 별 중 하나 선택 후 입장.

2. 화면 보는 법

• 탭 이동 — 빈 땅을 탭하면 그곳으로 이동합니다. 이동 중에는 자동 사냥이 꺼집니다.
• 타겟 — 몹을 탭하면 빨간 링으로 고정됩니다. 스킬·평타는 그 대상을 칩니다(사거리 밖이면 접근 후 시전).
• 스킬 버튼 — 장착한 스킬 최대 4개. 쿨타임이 있습니다.
• 자동 — 서버에 연결된 동안만 ON/OFF. 오프라인·백그라운드 자동 농장은 없습니다.
• 미니맵 — 상단. 탭하면 전체맵(타일). 전체맵을 탭하면 그곳으로 이동합니다. 빨강=몹, 마름모=NPC, 다이아=게이트.
• 퀘스트 — 상단 1줄. 탭하면 일지. 메뉴「퀘스트 일지」도 동일.
• NPC — 가까이 탭하면 인월드 칩(대화·상점·수리/합성·경매·출항·들판/던전).
• 다른 플레이어 — 귓속말·거래·파티 초대(없으면 파티 생성, 추가 초대는 리더만). 소집 없음. 1인이면 해산. 오프라인 약 90초 후 탈퇴.
• 스킬(마법) — 캐릭 생성 시 타입 스킬(해/달/별)·하악·방어를 습득. 나 탭「스킬」또는 가방에서 맵 버튼 4칸에 배치.
• 채팅 — 하단 오른쪽. HP/MP/EXP는 왼쪽 짧게.

3. 성(캐슬) 루프

성마다 보통 네 구역이 있습니다.

1. 마을(town) — NPC·퀘스트·경매·배(보스 클리어 후).
2. 들판(field) — 일반 몹·재료 수집.
3. 던전 — 더 강한 몹·중간 목표.
4. 보스방 — 성 보스. 처치 시 배 개방 깃발.

문(게이트)에 다가가 「들어가기」로 구역을 바꿉니다. 구역이 바뀌면 짧은 분위기 문구가 뜹니다.

4. 퀘스트

• 머리 위 ! = 받을 수 있는 퀘스트, ? = 대화·보고가 필요.
• 대화 후 수락 → 목표(처치/수집/대화) → 다시 NPC에게 보고.
• 항구 환영 · 들판 정찰 · 심부름 · 던전 · 여관 소문 · 보스 사냥 등이 성마다 이어집니다.
• 드롭·보상 아이템은 토스트에 한국어 이름으로 표시됩니다.

5. 전투 · 드롭 · 성장

• 몹을 탭해 타겟한 뒤 스킬·평타. 피격 시 잠깐 경직(히트스턴)될 수 있습니다.
• 처치 시 아이템이 바닥에 드롭됩니다. 가까이 가면 자동으로 줍거나, 드롭을 탭해도 줍습니다(킬러 15초 우선 · 이후 누구나 · 90초 후 사라짐). 미니맵 노란 점이 드롭입니다. EXP·퀘스트 킬 진행은 즉시 반영됩니다.
• 쓰러지면 마을로 귀환합니다. 골드 약 10%(최대 500)와 가방 아이템 1개가 사망 지점에 떨어집니다(장착 장비는 안전 · 15초 본인 우선). 앱 메뉴 → 수리로 장착 장비 내구도·HP를 회복한 뒤 다시 나서세요.
• 물약 — 빨간 약초(HP+30)·파란 약초(MP+20). 들판/던전 드롭 · 신규 캐릭 지급. HUD 좌하단 퀵버튼 또는 가방「사용」(1초 쿨).
• 채팅 — 하단 입력으로 같은 존 일반 채팅. /w 이름 내용 또는 /귓 이름 내용으로 귓속말. 최근 줄을 탭하면 해당 이름으로 귓 창이 열립니다.
• 주점 상점 — 각 성 주점주인 근처에서「상점」. 빨간/파란 약초 15골 · 귀환 주문서 50골 · 순간이동 주문서 80골. 귀환서는 현재 성 마을로, 텔은 해금된 성 마을을 골라 이동(가방「사용」또는 HUD「텔」).
• 플레이어 거래 — 메뉴「거래 신청」(같은 존 · 이름/ID). 상대 수락 후「거래창」에서 골드·미장착 아이템을 올리고 양쪽 잠금→확인. 장착 중 아이템은 거래 불가.
• 무게 — 가방 아이템마다 무게가 있습니다(한도 100). 몹을 처치하면 아이템은 바닥에 드롭됩니다(잠깐 보인 뒤 자동 줍기). 한도를 넘는 아이템은 줍지 않고 바닥에 남으며 토스트로 안내합니다. 가방「처분」으로 상점가에 팔아 무게를 줄이세요(「경매」와 별개).
• 무기 타입 — 검(사거리·위력)/단검(빠름·짧음)/활(원거리 투사체). 대장장이「상점」에서 참나무 검·뼈 단검·갈대 활 구매. 가방·장비에 타입 표시 · HUD「귀환」퀵버튼.
• 내구도 — 장착 장비는 전투로 닳습니다(타격 시 무기 · 피격 시 방어구). 0이 되면 파손되어 능력치가 빠집니다. 낮은 내구/파손 시 HUD 보라 칩. 메뉴「수리」로 장착 장비 전부 복구(수수료 = 기본+소모 내구×2) · HP도 함께 회복.
• PK · 성향 — 마을 밖에서 HUD「PK OFF」를 눌러 ON. 양쪽 모두 ON인 근거리 플레이어만 공격할 수 있습니다(파티원·AFK 보호). 대상이 없을 때 다시 누르면 OFF. PK 처치 시 성향 -1000·카오 이름은 빨간색, 몹 처치마다 성향 +1(최대 0).
• 공성(쥐성) — 쥐성 마을·들판에서 HUD「공성」선포 → 10분 창. 그 사이 보스방에서 맵 보스를 처치(또는「일격 도전」)한 사람이 주인(장식). 선포 쿨 30분 · 세금/혈맹 없음. 보스 클리어 플래그·배 해금은 그대로.
• 레벨·HP·EXP는 화면 좌하단 HUD에서 확인. 필요 EXP는 floor(base × level^power)(기본 base 80 · power 1.75 · max 50). 관리자「성장/EXP」에서 조정.
• 가방 — 「장착중」표시는 현재 장비에 끼운 아이템입니다. 장비 탭「해제」로 벗습니다.
• 가방 강화 — 같은 아이템이 2개 이상이면「강화」로 +1(재료 1개 소모, 실패 없음). 「강화 가능」이 보이면 바로 가능합니다. 메뉴「합성」은 중복을 한 번에 합칩니다.
• 호랑이~돼지 성도 들판·던전에 추가 몹이 있습니다. 보스 클리어 시 성마다 고유 레어 장비가 드롭됩니다.
• 경매 — 가방「팔기」에서 판매가 입력 후 등록, 경매 탭「새로고침」후 구매. 수수료 없이 골드만 사용. 장착 중인 아이템은 먼저「해제」하세요.

5b. 파티 · 기타

• 파티 — 메뉴「파티 초대」에 상대 이름 또는 ID 입력. 「파티 소집」은 멤버를 리더 존으로. 「주사위 룻」은 가방 아이템을 걸거나 골드 덩이(서버 지급)를 굴립니다. 「파티 해산」으로 종료. 미니맵에서 같은 파티는 초록에 가깝게 표시됩니다.
• 스테이크 — 예전 오프라인 농장용 잔여 API가 있을 수 있으나, 앱에서는 안내하지 않습니다. 자동 사냥은 접속+Auto ON만 유효합니다.

6. 보스 → 배 → 다음 성

1. 보스 처치 시 승리 대사와 함께 배가 열립니다.
2. 마을로 돌아가면 배 버튼이 잠깐 반짝입니다. 라벨에 다음 성 이름(예: 배 · 소성)이 보입니다.
3. 출항하면 다음 성 마을에 도착 대사가 나옵니다.
4. 순서: 쥐 → 소 → 호랑이 → 토끼 → 용 → 뱀 → 말 → 양 → 원숭이 → 닭 → 개 → 돼지.
5. 해성(돼지)까지 클리어하면 열두 성 완주입니다.

7. 공정 플레이 (중요)

• 자동 사냥은 접속(WebSocket) + 자동 ON일 때만.
• 앱을 끄거나 백그라운드로 나가면 자동 사냥이 멈춥니다.
• 개인 사주 스탯으로 전투가 유리해지지 않습니다. (세계관만 공유)
• Google Play / App Store 배포 금지.

8. 문제 해결

• 자동이 안 켜짐 — 서버 연결 상태 확인. 「서버 연결 후 자동 사냥 가능」 토스트.
• 배가 잠김 — 현재 성 보스를 아직 안 잡았거나, 마을이 아닙니다.
• 몹/맵이 안 보임 — API 주소·와이파이·서버(216:9001) 확인.
• 퀘스트가 안 됨 — NPC에게 더 가까이, !/? 마커 확인 후 대화.

9. 관리자·테스터용 링크

• 브라우저 플레이: /
• 이 설명서: /guide.html (로그인 없이 공유 가능)
• 스튜디오(관리): /admin.html (허용 Google 계정)