Steam appmanifest 파일이란? 위치와 안전한 복구 방법

Steam appmanifest 파일이란?

appmanifest는 Valve KeyValues 형식의 텍스트 문서이며 확장자는 .acf입니다. Steam은 로컬에서 관리하는 앱마다 하나를 만듭니다. 파일명은 appmanifest_<AppID>.acf이고 AppID 730은 appmanifest_730.acf를 사용합니다.

이 파일은 게임 본체, depot 매니페스트, 라이선스 또는 세이브 백업이 아닙니다. AppID와 설치 폴더를 연결하고 설치, 업데이트, 준비 상태를 기록하는 로컬 메타데이터입니다.

한 앱은 여러 depot을 사용할 수 있지만 라이브러리 설치 단위로는 보통 하나의 appmanifest 기록을 갖습니다. depot 매니페스트는 콘텐츠 버전을 설명하고 appmanifest는 앱 전체 설치 상태를 묶습니다.

appmanifest_730.acf
appmanifest_570.acf
appmanifest_<AppID>.acf

Steam appmanifest 파일 위치

Windows 기본 설치에서는 C:\Program Files (x86)\Steam\steamapps에 있는 경우가 많습니다. 보조 라이브러리는 D:\SteamLibrary\steamapps와 같은 경로를 씁니다. ACF는 steamapps 바로 아래, 게임 폴더는 보통 steamapps/common 아래에 있습니다.

처음 발견한 Steam 폴더만 확인하지 마세요. Steam 저장 공간 설정 또는 libraryfolders.vdf에서 실제 common 폴더가 있는 라이브러리를 찾고 같은 steamapps의 ACF를 확인합니다.

Linux와 Steam Deck은 기본 설치, Flatpak, 호환 환경에 따라 경로가 달라지지만 라이브러리, steamapps, ACF, common의 관계는 같습니다.

C:\Program Files (x86)\Steam\steamapps\appmanifest_730.acf
D:\SteamLibrary\steamapps\appmanifest_730.acf
D:\SteamLibrary\steamapps\common\Counter-Strike Global Offensive

AppManifest ACF의 중요한 필드

내용은 읽을 수 있지만 모든 값을 추측해서는 안 됩니다. 먼저 appid, name, installdir을 확인합니다. AppID는 정확한 스토어 항목이어야 하고 installdir은 steamapps/common의 실제 폴더명과 일치해야 합니다.

StateFlags는 숫자 상태 필드입니다. 설치 상태에서 4를 자주 볼 수 있지만 depot과 빌드 정보를 복구하지는 못합니다. buildid와 InstalledDepots는 업데이트 후 바뀌며 LastUpdated와 SizeOnDisk는 로컬 상태이지 최신 공개 버전의 보증이 아닙니다.

Steam은 실행, 검증, 업데이트 후 파일을 다시 쓸 수 있습니다. 생성 파일은 인식 시작용 보조 자료이고, 인식 후에는 클라이언트가 기록을 갱신하도록 둡니다.

"appid"       "730"
"name"        "Counter-Strike 2"
"installdir"  "Counter-Strike Global Offensive"
"StateFlags"  "4"

appmanifest 누락·오래됨·불일치 증상

대표 증상은 게임 폴더가 있는데 Steam이 설치 버튼을 표시하는 것입니다. 같은 라이브러리를 선택해 설치를 시작하면 기존 데이터를 찾아 검증으로 전환하기도 합니다. common만 복사하고 ACF를 옮기지 않으면 라이브러리가 비어 보일 수 있습니다.

오래된 파일은 대용량 업데이트, 긴 검증, 드라이브 이동 후 인식 실패를 유발할 수 있습니다. 하지만 디스크 공간, 권한, 캐시, 미등록 라이브러리, 손상 파일도 비슷한 증상을 만듭니다.

불일치 기록은 그럴듯해 보여 더 위험합니다. 파일명, appid, installdir, 실제 폴더, 스토어 URL을 비교하세요.

누락된 AppManifest의 안전한 복구 절차

Steam이 라이브러리를 바꾸기 전에 파일과 현재 상태를 보존할 수 있도록 되돌릴 수 있는 순서로 진행합니다. 활성 다운로드와 업데이트를 먼저 일시 중지하세요.

가장 좋은 복구는 Steam이 기존 파일을 찾아 검증하도록 하는 것입니다. AppID, 폴더, 등록된 라이브러리와 로컬 데이터를 확인한 뒤에도 탐색이 시작되지 않을 때만 ACF 생성을 고려합니다.

1. Steam 완전 종료

   다운로드를 멈추고 Steam > 종료를 사용해 라이브러리 쓰기를 중단합니다.

2. 현재 상태 백업

   기존 ACF를 복사하고 전체 경로, 폴더 크기, AppID, 드라이브를 기록합니다.

3. 정확한 AppID 확인

   본편, DLC, 데모, 도구, 사운드트랙, 테스트 앱을 구분합니다.

4. 라이브러리 등록 확인

   저장 공간 설정에서 Steam이 올바른 루트를 인식하는지 확인합니다.

5. 같은 위치에서 탐색 시작

   같은 앱과 라이브러리에서 설치를 선택해 기존 파일 검증으로 전환되는지 확인합니다.

6. 마지막 단계에서만 생성

   Steam이 꺼진 상태에서 정확한 AppID와 installdir로 최소 ACF를 만들고 다시 시작해 검증합니다.

7. 잘못된 경로라면 중단

   백업을 복원하고 AppID, 라이브러리, 설치 폴더를 다시 확인합니다.

AppManifest Generator를 사용할 때

파일의 정체와 위치를 이미 확인한 상태에서 누락된 로컬 기록의 시작 파일이 필요할 때 사용합니다. 올바른 파일명, AppID, 이름, installdir, 임시 크기와 상태를 가진 읽기 쉬운 파일을 만들 수 있습니다.

현재 depot 매니페스트, buildid, 소유권, 라이선스 또는 완전한 설치를 생성하지 마세요. 생성 ACF는 접근 권한을 주지 않으며 공식 또는 최신 매니페스트가 아닙니다.

이 사이트의 도구는 브라우저에서 평문 .acf를 만듭니다. 저장 전 검토하세요. 번호는 AppID Finder, 매니페스트/Lua 패키지는 Steam Manifest Downloader를 사용합니다.

피해야 할 AppManifest 복구 실수

파일명이 맞는다는 이유로 출처 불명의 ACF를 사용하지 마세요. 다른 폴더, 빌드, 언어, 베타, 앱을 가리킬 수 있습니다. 텍스트이므로 사용 전에 확인하세요.

전체 재다운로드를 받아들이기 전 common을 삭제하지 마세요. appmanifest도 일괄 삭제하지 마세요. 각 파일은 서로 다른 앱을 나타냅니다.

Steam 실행 중에는 편집하지 마세요. 생성 파일을 공식, 최신, 안전, 완전한 파일이라고 표현하지 마세요. 권한, 콘텐츠와 최종 검증은 계정과 Steam이 결정합니다.

appmanifest 복구는 세이브 복구가 아닙니다. 세이브는 userdata, 문서, AppData, 게임 폴더 또는 Steam Cloud에 있을 수 있습니다.

Steam appmanifest 자주 묻는 질문