블로그로 돌아가기

더 안전한 API 키 재생성과 서버 측 AI 번역: 이번 주 horizOn

게시일 2026년 11월 12일
더 안전한 API 키 재생성과 서버 측 AI 번역: 이번 주 horizOn AI의 도움으로 생성됨

핵심 요약

API 키 재생성 시 이제 모든 프로젝트 데이터가 유지되고, 뉴스 번역이 서버를 통해 처리되며, horizOn에서 플레이어 ID로 클라우드 세이브를 찾을 수 있습니다.

이번 주는 SDK 릴리스가 없었습니다. Unity는 1.12, Godot은 1.11, Unreal은 1.10.5, Simple Server는 1.6, MCP Server는 1.9 버전을 유지하므로 엔진에 재설치할 것이 없습니다. 모든 작업은 호스팅 서버와 대시보드에서 이루어졌으며, 필요할 때까지는 거의 생각하지 않는 부분들입니다. API 키 교체, 특정 플레이어의 세이브 찾기, AI를 활용한 게임 내 뉴스 번역 등이 개선되었습니다.

11월 5일부터 11월 11일 사이의 변경 사항입니다.

Server 1.75.11: 프로젝트를 잃지 않고 API 키 재생성

horizOn의 모든 게임은 API 키로 백엔드와 통신합니다. 조만간 키를 교체해야 할 일이 생길 것입니다. 키가 공개 저장소, 스크린샷 또는 테스터와 공유한 빌드에 포함되었을 수 있습니다. 명확한 해결책은 대시보드에서 재생성을 누르는 것입니다.

Server 1.75.11과 Dashboard 1.114.6부터 재생성은 시크릿만 교체합니다. 키는 자신의 정체성을 유지하고, 프로젝트에 속한 모든 것이 그대로 연결됩니다. 플레이어와 세션, 클라우드 세이브, 리더보드, 원격 설정, 뉴스, 로컬라이제이션, 기프트 코드, 크래시 리포트, 피드백, 그리고 친구, 그룹, 채팅, 매치 뒤의 멀티플레이어 데이터가 모두 유지됩니다. 이번 릴리스 이전에는 재생성이 새 키 레코드를 만들었고, 프로젝트 데이터는 이전 키에 남아있었습니다. 대시보드는 이제 재생성 시 플레이어와 프로젝트 데이터가 유지된다고 명확히 표시합니다.

안전하게 키를 교체하는 방법

  1. 대시보드에서 재생성합니다. 이전 값은 작동을 멈추므로 새 값을 즉시 복사하여 안전한 곳에 저장하세요.
  2. 다음 빌드에 새 키를 포함하여 배포합니다. 이전 값을 사용하는 클라이언트는 거부되므로 릴리스와 함께 전환을 계획하세요.
  3. 버전 관리에서 키를 제외합니다. 커밋된 씬이나 스크립트가 아닌 빌드 파이프라인이 주입하는 설정 파일에 키를 넣으세요. 교체는 이제 쉬워졌지만, 교체가 필요 없는 것이 여전히 더 좋습니다.

Server 1.75.12: AI 뉴스 번역이 서버를 통해 실행

horizOn은 게임 내에서 뉴스를 게시하고 원하는 AI 제공자로 각 항목을 번역할 수 있게 해줍니다. 지금까지 대시보드는 브라우저에서 직접 해당 제공자를 호출했습니다.

Server 1.75.12와 Dashboard 1.114.7부터 OpenAI와 Gemini를 사용한 번역은 horizOn 서버를 거쳐 진행됩니다. 대시보드가 번역 요청을 보내면 서버가 뉴스 설정에 저장한 API 키로 전달합니다. 해당 키는 암호화되어 저장되며 대시보드는 마스킹된 버전만 볼 수 있습니다. 제공자 키가 더 이상 브라우저를 거칠 필요가 없습니다.

두 번째로 조용하지만 유익한 점이 있습니다. 제공자가 키를 거부하는 경우, 예를 들어 만료되었거나 크레딧이 소진된 경우, 해당 번역에 대한 오류 메시지를 받습니다. 다른 사람의 401 응답 때문에 대시보드에서 로그아웃되는 일이 더 이상 없습니다.

로컬 모델도 작동합니다

번역을 자신의 컴퓨터에서 유지하려면 Dashboard 1.114.7이 이제 localhost에서 Ollama와 LM Studio를 허용합니다. 이 두 가지는 여전히 브라우저에서 직접 실행됩니다. 서버는 책상 위의 컴퓨터에 접근할 수 없기 때문입니다. 두 가지 설정으로 작동합니다.

  • Ollama는 환경 변수 OLLAMA_ORIGINS=https://horizon.pm가 필요합니다.
  • LM Studio는 CORS 스위치를 켜야 합니다.

LAN의 다른 컴퓨터와 같은 로컬 네트워크의 주소는 차단된 상태로 유지됩니다. 설정 양식의 도움말 텍스트가 두 설정을 모두 설명합니다.

Server 1.75.10: ID로 플레이어의 클라우드 세이브 찾기

지원 요청은 종종 한 문장으로 시작됩니다. "제 세이브가 사라졌어요." 이에 답하려면 정확히 해당 플레이어의 세이브를 봐야 합니다.

Server 1.75.10은 대시보드의 클라우드 세이브 목록을 플레이어 ID로 필터링할 수 있게 합니다. 이전에는 목록이 검색을 무시하고 키의 최신 20개 세이브만 보여주었는데, 게임에 플레이어가 몇 명 이상 있으면 쓸모없었습니다. Dashboard 1.114.5는 한 걸음 더 나아갑니다. 플레이어 레코드를 열고 클라우드 세이브로 가는 링크를 따라가면 검색이 이미 해당 플레이어의 ID로 채워져 있습니다.

빠른 지원 루틴

  1. 문제를 보고한 플레이어의 레코드를 엽니다.
  2. 클라우드 세이브로 가는 링크를 따라갑니다.
  3. 변경하기 전에 최신 세이브를 확인합니다.

이렇게 하면 지원 티켓이 데이터베이스 탐색에서 두 번의 클릭으로 확인하는 작업으로 바뀝니다.

추가 배포 사항

몇 가지 작은 변경 사항이 이번 주를 마무리합니다.

  • 리더보드 리셋. 리셋 대화 상자의 보관 박스가 이제 기본적으로 선택 해제된 상태로 시작됩니다. 보관 없이 리셋하면 이전 시즌이 삭제되므로 과거 순위 기록을 유지하려면 체크하세요. 관리자 API는 여전히 기본적으로 보관합니다.
  • 플랜 카드. 로그인한 상태에서 홈과 가격 페이지의 플랜 카드는 계정 설정으로 이동하며 이미 가입한 플랜을 표시합니다.
  • 모바일에서 horizon.pm. 공개 웹사이트가 모바일에서 더 적은 작업을 수행하고, 히어로 섹션이 페이지 로드 중에 더 이상 점프하지 않으며, 페이지의 제목, 설명, 이미지 대체 텍스트가 더 깔끔해졌습니다.

변경되지 않은 사항

범위를 명확히 하자면 Unity SDK 1.12, Godot SDK 1.11, Unreal SDK 1.10.5, Simple Server 1.6, MCP Server 1.9는 변경되지 않았습니다. 지난 두 주를 놓쳤다면 Unreal 개선과 가벼워진 Cloud Save에 대한 요약과 인벤토리, 채팅, 턴 기반 매치가 포함된 대규모 기능 주간을 읽어보세요.

Discord에서 더 빠르게 업데이트 받기

이 글은 한 주를 요약합니다. 릴리스가 배포되는 즉시 소식을 듣고 싶다면 horizOn Discord 서버에 가입하세요. 새 버전이 실시간으로 올라오며, 종종 이 주간 요약보다 며칠 먼저 공개됩니다. 질문하거나 다음에 필요한 것을 알려주기에 가장 빠른 곳입니다.

AI로 뉴스를 번역하거나 로컬 모델을 실행한다면 새로운 흐름을 시도해보고 어떻게 작동하는지 알려주세요. Discord에서 답장하거나 GitHub에서 이슈를 열어주세요. 전체 변경 사항 목록은 horizOn 체인지로그에서 확인하실 수 있습니다.