zhongwei/gh-dev-gom-claude-code-marketplace-plugins-unity-editor-toolkit

Fork 0

Files

Zhongwei Li 1da7b24c8e Initial commit

2025-11-29 18:19:28 +08:00

7.0 KiB

Raw Permalink Blame History

Unity Editor Toolkit - Unity 패키지

Claude Code 통합을 위한 WebSocket 기반 Unity Editor 실시간 제어.

설치

권장: Unity Package Manager

Unity Editor 열기
Window → Package Manager
+ 클릭 → Add package from git URL
입력: https://github.com/Dev-GOM/claude-code-marketplace.git?path=/plugins/unity-editor-toolkit/skills/assets/unity-package
Add 클릭

대안: Assets 폴더

커스터마이징이 필요한 경우, 이 폴더를 Assets/UnityEditorToolkit/에 복사하세요.

참고: UPM은 Packages/ 폴더에 설치되며(읽기 전용), Assets는 직접 수정이 가능합니다.

빠른 시작

1. Server Window 열기

Unity 메뉴: Tools > Unity Editor Toolkit > Server Window
Editor에 새 창이 나타납니다

2. 플러그인 스크립트 경로 설정

Plugin Scripts Path: 사용자 홈 폴더에서 자동 감지 (~/.claude/plugins/...)
감지되지 않으면 "Browse"를 클릭하여 수동 선택
경로는 다음을 가리켜야 함: unity-editor-toolkit/skills/scripts

3. CLI 설치 (일회성 설정)

"Install CLI" 버튼 클릭
WebSocket 서버와 TypeScript CLI 빌드
설치 완료 대기 (1-2분 소요 가능)
Console에 표시: "✓ CLI installation completed"

4. 서버 자동 시작

Unity Editor가 열리면 서버가 자동으로 시작됩니다
포트: 9500-9600 범위에서 자동 할당 (수동 설정 불필요)
상태 파일: {ProjectRoot}/.unity-websocket/server-status.json
CLI가 이 파일에서 올바른 포트를 자동으로 감지

5. Claude Code에서 연결

Claude Code에 Unity Editor Toolkit 플러그인 설치:

# 마켓플레이스 추가
/plugin marketplace add https://github.com/Dev-GOM/claude-code-marketplace.git

# 플러그인 설치
/plugin install unity-editor-toolkit@dev-gom-plugins

CLI 명령어 사용:

# GameObject 찾기
cd <unity-project-root> node .unity-websocket/uw go find "Player"

# 위치 설정
cd <unity-project-root> node .unity-websocket/uw tf set-position "Player" "0,5,10"

# 씬 로드
cd <unity-project-root> node .unity-websocket/uw scene load "GameScene"

# 콘솔 로그 가져오기
cd <unity-project-root> node .unity-websocket/uw console logs

요구사항

Unity 버전

Unity 2020.3 이상
Unity 6+ (2023.x+) 완전 호환

의존성

websocket-sharp 라이브러리 (아래 의존성 섹션 참조)

Test Framework (테스트 실행용)

Unity 2019.2+: 모든 프로젝트에 자동 포함
Unity 6+ (2023.x+): Core Package (Editor 버전 고정) + 새 기능

의존성

websocket-sharp

이 패키지는 WebSocket 통신을 위해 websocket-sharp가 필요합니다.

설치:

websocket-sharp 다운로드: https://github.com/sta/websocket-sharp/releases
websocket-sharp.dll 압축 해제
Packages/com.devgom.unity-editor-toolkit/ThirdParty/websocket-sharp/에 복사
Unity가 자동으로 DLL을 임포트

대안:

NuGet for Unity를 통해 추가:

NuGet for Unity 설치: https://github.com/GlitchEnzo/NuGetForUnity
NuGet 창 열기
"websocket-sharp" 검색
설치

지원 명령어

GameObject (5개 명령어)

GameObject.Find - 이름으로 GameObject 찾기
GameObject.Create - 새 GameObject 생성
GameObject.Destroy - GameObject 파괴
GameObject.SetActive - 활성 상태 설정

Transform (6개 명령어)

Transform.GetPosition - 월드 위치 가져오기
Transform.SetPosition - 월드 위치 설정
Transform.GetRotation - 회전 가져오기 (오일러 각도)
Transform.SetRotation - 회전 설정
Transform.GetScale - 로컬 스케일 가져오기
Transform.SetScale - 로컬 스케일 설정

Scene (3개 명령어)

Scene.GetCurrent - 활성 씬 정보 가져오기
Scene.GetAll - 로드된 모든 씬 가져오기
Scene.Load - 씬 로드 (단일 또는 추가)

Console (2개 명령어)

Console.GetLogs - 필터링된 콘솔 로그 가져오기
Console.Clear - 콘솔 지우기

Hierarchy (1개 명령어)

Hierarchy.Get - GameObject 계층 구조 트리 가져오기

API 예제

GameObject 찾기

요청:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "GameObject.Find",
  "params": { "name": "Player" }
}

응답:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "name": "Player",
    "instanceId": 12345,
    "path": "/Player",
    "active": true,
    "tag": "Player",
    "layer": 0
  }
}

위치 설정