========================================================================
FC Online Player Image Searcher v3.0 - README
========================================================================
[KOREAN / 한국어]
1. 프로그램 정보
- 프로그램명: FC 온라인 선수 이미지 검색기
- 버전: v3.0
- 개발자: 펨코 서유리
- 기반 기술: Python 3.11, PyQt6, Requests (Connection Pooling)
- 제공 기능: 선수 고유 이미지(Action Shot), 미니 페이스온, 시즌 및 **팀 컬러** 검색/다운로드
2. v3.0 업데이트 내역 (Change Log)
대규모 업데이트인 v3.0은 '팀 컬러' 검색 기능 추가와 검색 엔진의 핵심 성능을 최적화했습니다.
A. '팀 컬러(Team Color)' 검색 및 필터 기능 추가 (신규)
- [팀 컬러] 탭이 신설되었습니다. 이제 팀 이름(예: 대한민국, 레알 마드리드)으로 선수를 찾을 수 있습니다.
- 국가, 클럽, 특성(올스타, 연도별 등) 카테고리를 지원하여 원하는 팀을 쉽게 찾을 수 있습니다.
- **[중복 선택 필터]**: 하단 필터바에 '체크 가능한 팀 목록'이 추가되어, 검색 결과 내에서 특정 팀 소속 선수만 골라낼 수 있습니다. (예: 검색 결과 중 '첼시'와 '레알 마드리드'를 거친 선수만 보기)
B. 검색 엔진 성능 및 속도 최적화 (Optimization)
- Connection Pooling 기술을 도입하여 이미지 다운로드 및 검색 속도가 획기적으로 빨라졌습니다.
- 기존의 HEAD 요청 과정을 생략하고 직접 데이터를 받아오도록 개선하여 네트워크 낭비를 줄였습니다.
C. UI/UX 및 랭킹 시스템 전면 개편
- **[트리플 랭킹 시스템]**: 좌측 랭킹 패널이 현재 보고 있는 탭에 맞춰 [선수], [시즌], [팀] 랭킹을 보여주거나, [즐겨찾기] 탭에서는 3가지를 동시에 보여주도록 진화했습니다.
- **[로딩 가시성 개선]**: 로딩 스피너 중앙에 진행률(%) 숫자가 표시되어 명확한 진행 상황을 알 수 있습니다.
- 결과창 정렬 로직을 개선하여 특수 시즌(예: _24)이 목록 최상단에 예쁘게 정렬됩니다.
D. 시즌 검색 '정밀 모드' 추가
- 시즌 검색 탭에 [신규/미등록 시즌 정밀 검색] 체크박스가 추가되었습니다.
- 체크 해제(기본값): 데이터 센터 기반 초고속 검색.
- 체크 설정: 데이터에 없는 최신 시즌을 찾기 위해 모든 선수를 전수 조사(속도는 느리지만 정확함).
3. 주요 기능 및 사용 방법
[선수 검색 탭]
- 이름/ID 입력 후 돋보기 클릭 -> 해당 선수의 모든 시즌 이미지 검색.
[시즌 검색 탭]
- 일반 시즌: 3자리 코드(예: 101, 230) 입력.
- 스페셜/기본: 2자리 숫자(예: 24) 입력 시 해당 특수 시즌 검색, "기본" 입력 시 미니 페이스온 전수 조사.
- **Tip**: 신규 시즌이 검색되지 않을 경우 '정밀 검색' 체크박스를 켜고 검색하세요.
[팀 컬러 탭] (New)
- 팀 분류(국가/클럽/특성)를 선택하거나 검색창에 팀 이름을 입력하여 검색합니다.
- '헤드샷 보기' 체크 시 미니 페이스온도 함께 검색됩니다.
[통합 필터 및 저장]
- 하단 '팀 선택' 드롭다운을 눌러 원하는 팀들을 체크하면, 해당 팀 컬러를 보유한 선수만 남습니다.
- '전체 저장' 버튼으로 검색된 결과를 폴더별로 일괄 저장할 수 있습니다.
4. 파일 저장 위치 및 데이터 관리
* 경로: C:\Users\[사용자명]\AppData\Roaming\FCOnlineImageSearcher
* 포함 파일:
- teams.json: 팀 컬러 데이터 (서버 동기화)
- player/season/team_history.json: 각 항목별 검색 기록
- favorites.json: 즐겨찾기 목록
5. 주의사항 및 제보 요청 (Important Note)
- **[팀 컬러 데이터 정확성]**: 팀 컬러 데이터(teams.json)는 방대한 데이터를 처리하는 과정에서 일부 누락되거나 과거 데이터가 섞여 있을 수 있습니다.
- 특정 선수의 팀 정보가 잘못되었거나 누락된 경우, 펨코 게시글 댓글이나 쪽지로 제보해 주시면 다음 업데이트 또는 서버 데이터 수정 시 반영하겠습니다.
6. 저작권 및 면책 조항 (Disclaimer)
- 본 프로그램은 NEXON Korea Corporation이 제공하는 공식 프로그램이 아닙니다.
- 개인이 NEXON Open API를 활용하여 제작한 팬 메이드 툴입니다.
- "EA SPORTS FC ONLINE"과 관련된 모든 이미지 및 데이터의 저작권은 넥슨 및 EA에 있습니다.
- 본 프로그램을 통해 얻은 이미지는 개인적인 용도로만 사용해야 하며, 상업적 이용에 대한 책임은 사용자에게 있습니다.
========================================================================
[ENGLISH / English]
1. Program Information
- Name: FC Online Player Image Searcher
- Version: v3.0
- Developer: Pemco Seoyuri
- Tech Stack: Python 3.11, PyQt6, Requests (Connection Pooling)
- Function: Search/Download Player Action Shots, Headshots, Season, and **Team Color** images.
2. v3.0 Update Highlights
v3.0 introduces 'Team Color' search and significant performance optimizations.
A. 'Team Color' Search & Advanced Filtering (New)
- Added a dedicated [Team Color] tab. You can now search for players by team name (e.g., Korea, Real Madrid).
- Supports categories: Nation, Club, and Special (All-star, etc.).
- **[Multi-Select Filter]**: Added a checkable dropdown at the bottom filter bar. You can filter current results to show players belonging to specific teams only.
B. Engine Optimization
- Implemented Connection Pooling (HTTPAdapter) for drastically faster image downloads.
- Minimized network overhead by optimizing request methods (Direct GET).
C. UI/UX & Ranking System Overhaul
- **[Triple Ranking System]**: The left ranking panel dynamically changes between [Player], [Season], and [Team] rankings based on the active tab. The Favorites tab shows all three.
- **[Better Loading UI]**: The loading spinner now displays the exact progress percentage (%) in the center.
- Improved sorting logic to display special seasons (e.g., _24) at the top of the list.
D. Season Search 'Precision Mode'
- Added a checkbox: [Deep Scan for New/Unregistered Seasons].
- Unchecked (Default): Ultra-fast search based on Data Center meta-data.
- Checked: Brute-force scan for all players to find brand new seasons (Slower but finds everything).
3. How to Use
[Player Search]
- Enter Name or ID -> Searches all images for that player.
[Season Search]
- Standard: Enter 3-digit code (e.g., 101).
- Special/Basic: Enter 2-digit number (e.g., 24) or "기본" (Basic) for headshots.
- **Tip**: Check 'Deep Scan' if you cannot find a newly released season.
[Team Color Tab] (New)
- Select a category or type a team name to find players.
- Toggle 'Show Headshot' to include minifaces.
[Filters & Saving]
- Use the bottom 'Team Select' dropdown to filter results by multiple teams.
- Click 'Save All' to batch download images.
4. Data & Caution
* Path: C:\Users\[Username]\AppData\Roaming\FCOnlineImageSearcher
* **[Note on Team Data]**: The team color data (teams.json) may contain inaccuracies or missing info due to the large dataset. **Please report any incorrect team data**, and it will be corrected in server updates.
5. Disclaimer
- This is an unofficial, fan-made tool and is not endorsed by NEXON Korea Corporation.
- All intellectual property rights belong to NEXON and EA.
- Extracted images are for personal use only.
========================================================================
