문서

    Unreal Editor 플러그인

    Unreal Engine 팀을 위한 클라우드 CI/CD. 에디터를 벗어나지 않고 빌드를 트리거하고, 로그를 실시간으로 확인하고, 아티팩트를 내려받고, AI 기반 오류 수정 도움까지 받으세요.

    요구 사항

    • Unreal Engine 5.7
    • 호스트 플랫폼: Windows 64비트 또는 macOS(Apple Silicon 또는 Intel)
    • SpeedrunCI 계정 — app.speedrun.ci에서 무료로 가입하세요
    • 소스 컨트롤 연결(Git, Perforce, Plastic SCM) — SpeedrunCI 대시보드에서 한 번만 구성하면 됩니다
    • 파이프라인 1개 이상 — 플러그인이 빌드를 트리거하려면 SpeedrunCI 대시보드에 파이프라인이 최소 하나 구성되어 있어야 합니다

    플러그인은 에디터 쪽에서 빌드를 트리거하고 모니터링하는 역할을 하며, 실제 빌드는 SpeedrunCI가 호스팅하는 인프라에서 실행됩니다. 직접 백엔드를 호스팅하거나 운영할 필요는 없지만 계정은 필요합니다.

    설치

    1. Epic Games 런처에서 Fab Marketplace를 통해 플러그인을 설치하세요(Library → Engine Versions → Installed Plugins).
    2. UE 5.7 프로젝트를 여세요. 누락된 모듈을 다시 빌드할지 묻는 창이 나타나면 Yes를 클릭합니다.
    3. Edit → Plugins를 열고 "SpeedrunCI"를 검색해 활성화되어 있는지 확인한 뒤, 재시작 안내가 나오면 에디터를 다시 시작하세요.

    첫 로그인

    1. SpeedrunCI 패널을 엽니다. Ctrl+Shift+K(Windows) 또는 Cmd+Shift+K(Mac)를 누르거나, Tools → Miscellaneous → SpeedrunCI로 이동하세요.
    2. 온보딩 마법사가 나타납니다. Browser Sign-In을 클릭하세요.
    3. 기본 브라우저가 app.speedrun.ci/auth/editor-plugin 페이지로 열립니다. 그곳에서 로그인하세요.
    4. 브라우저가 로컬 콜백으로 다시 리디렉션되고, 마법사가 Project Selection 단계로 자동으로 넘어갑니다.
    5. 조직, 프로젝트, 기본 파이프라인을 선택한 뒤 Finish Setup을 클릭하세요.

    에디터 토큰은 운영체제의 보안 자격 증명 저장소(macOS 키체인 또는 Windows 자격 증명 관리자)에 보관되며, 지원 플랫폼에서는 디스크에 평문으로 저장되지 않습니다.

    macOS 참고: 로그인 중에 에디터가 19847–19857 범위의 포트로 로컬 콜백 서버를 잠시 엽니다. macOS가 들어오는 네트워크 연결을 허용할지 물으면 허용을 클릭하세요. 이 서버는 로그인이 완료되는 즉시 종료됩니다.

    플러그인으로 할 수 있는 일

    • 빌드 트리거 — 툴바의 Play 버튼 옆 버튼이나 패널에서 빌드를 시작합니다. 현재 브랜치에서 팀의 기본 파이프라인을 실행합니다.
    • 로그 스트림을 실시간으로 확인합니다. 심각도(오류, 경고)가 강조 표시되며, file:line 참조는 클릭할 수 있습니다.
    • AI 추천 — 빌드가 실패하면 AI가 생성한 원인 설명과 수정 제안을 확인할 수 있습니다. diff를 검토한 뒤 클릭 한 번으로 로컬에 적용하세요.
    • 아티팩트를 다운로드할 때 8개 청크를 병렬로 내려받아 쿡된 PAK, IPA, APK, Xbox .xvc, PS5 .pkg 등을 빠르게 가져옵니다.
    • 프리플라이트 검사가 빌드를 트리거하기 전에 저장되지 않은 에셋, 커밋되지 않은 변경 사항, 블루프린트 컴파일 오류를 찾아 알려 줍니다.
    • 빌드 연속 기록과 가벼운 게임화 요소가 CI를 계속 그린 상태로 유지하도록 도와줍니다.
    • 로컬 셰이더 컴파일 부스트(Windows 전용)는 편집 작업을 하는 동안 ShaderCompileWorker와 UnrealLightmass 프로세스의 우선순위를 보통보다 높게 올려 주므로, 셰이더 쿡과 라이팅 빌드가 더 빨리 끝납니다.

    구성

    Edit → Project Settings를 열고, 왼쪽 탐색 메뉴의 Plugins 아래에서 SpeedrunCI를 선택하세요:

    • API 기본 URL (기본값 https://app.speedrun.ci, 셀프 호스팅 배포에서만 변경)
    • 기본 조직, 프로젝트, 파이프라인
    • 아티팩트 다운로드 경로
    • 사운드, 빌드 연속 기록, 셰이더 부스트, 알림에 대한 환경 설정

    AI 추천 기능은 SpeedrunCI 대시보드의 Organization Settings → AI Providers에서 조직 단위로 비활성화할 수 있습니다.

    개인정보 보호 및 보안

    • 에디터 토큰은 macOS 키체인 또는 Windows 자격 증명 관리자에 저장되며, 지원 플랫폼에서는 디스크에 평문으로 저장되지 않습니다.
    • 모든 API 트래픽은 HTTPS로 app.speedrun.ci에 전송됩니다.
    • 플러그인은 소스 코드, 프로젝트 에셋, 월드 파일을 전송하지 않습니다. 소스 코드는 SpeedrunCI 대시보드에서 별도로 설정하는 소스 컨트롤 연결을 통해 빌드 인프라에 전달됩니다.
    • 플러그인은 오직 브라우저 기반 로그인 과정 동안에만 19847–19857 범위의 포트(TCP, 루프백 전용)에 로컬 HTTP 서버를 열고, 완료되면 곧바로 종료합니다.
    • 플러그인이 무엇을 전송하고 저장하는지에 대한 자세한 내용은 전체 개인정보 처리방침을 참조하세요.

    문제 해결

    툴바 버튼이 나타나지 않을 때

    Edit → Plugins에서 SpeedrunCI가 활성화되어 있는지 확인하고 에디터를 한 번 다시 시작하세요. 플러그인이 활성화되어 있는데도 버튼이 나타나지 않으면 Output Log를 "SpeedrunCI"로 필터링해 오류를 확인하세요.

    브라우저 로그인 후 다시 돌아오지 않을 때

    운영체제 방화벽이 로컬 콜백을 차단하고 있을 가능성이 큽니다. macOS에서는 System Settings → Network → Firewall을 열고 Unreal Editor의 들어오는 연결을 허용하세요. Windows에서는 Windows Defender 방화벽에서 Unreal Editor를 허용하세요.

    "AI Recommendations not yet available"(AI 추천을 아직 사용할 수 없음)

    해당 빌드에 대한 AI 요약이 파이프라인에서 아직 생성되지 않았습니다. AI 요약은 빌드가 끝난 뒤 백엔드에서 생성되므로, SpeedrunCI 대시보드에서 해당 빌드를 확인해 보세요. 플러그인은 다음 새로 고침 때 요약을 가져옵니다.

    온보딩 중 "No projects found"(프로젝트를 찾을 수 없음)이 표시될 때

    계정이 어느 조직에도 속해 있지 않거나, 아직 프로젝트가 만들어지지 않았습니다. app.speedrun.ci에서 조직과 프로젝트를 최소 하나씩 만든 뒤 플러그인 패널을 다시 여세요.

    로그아웃 / 재인증

    플러그인의 Settings 패널에서 Sign Out을 클릭하세요. 키체인 항목과 로컬 자격 증명 파일이 함께 삭제됩니다. 다음에 툴바를 클릭하면 브라우저를 통해 다시 로그인하라는 안내가 표시됩니다.

    그 밖의 문제

    Output Log를 열고 SpeedrunCI로 필터링해 보세요. 플러그인은 로그를 넉넉히 남깁니다. 대개 첫 번째 경고나 오류가 원인을 가리킵니다. 그래도 해결되지 않으면 관련 로그 발췌본을 support@speedrun.ci 주소로 보내 주세요.

    링크 및 지원

    © 2026 Navi Interactive Inc. 모든 권리 보유.