Skip to content

PC FISH Automation 0.5.0

Choose a tag to compare

@misosiruda misosiruda released this 10 Nov 11:38
daa809a

시즌 물고기는 가장 높은 희귀도의 어종부터 5성을 먼저 확보하고, 부족한 4·3·2·1성을 채운다. 모든 시즌 어종의 수집을 끝내면 최상위 어종의 5성을 반복 제작한다. 비시즌에는 모든 일반 어종의 재료를 별 등급별로 비축한다.

다운로드

파일 용도
PCFish-Automation-v0.5.0-win-x64.zip Windows x64용 모드 DLL, Python 계획기, 설정 예시, 설치 스크립트, 소스와 문서
SHA256SUMS.txt ZIP SHA-256 검증값

ZIP 크기: 384,752바이트. GitHub가 자동 제공하는 Source code ZIP/TAR에는 빌드된 모드 DLL이 없다.

설치·업데이트

지원 환경은 Windows x64 / PC FISH 1.6.2 / Steam build 26315872다. Python 3.12 이상, Google Chrome, PowerShell 7과 BepInEx 6.0.0-be.793+dbc82f0 / Unity.IL2CPP-win-x64를 별도로 준비한다. 배포 DLL 사용 시 .NET SDK는 필요 없다.

  • 처음 설치: ZIP을 계속 사용할 폴더에 풀고 Python 환경과 로더를 준비한 뒤 python_path·project_root를 실제 위치에 맞춘다. 게임을 종료하고 scripts/Install-Mod.ps1로 설치한다.
  • 기존 사용자: 진행 중인 요청이 정리된 것을 확인하고 게임을 정상 종료한다. 기존 프로젝트·DLL·설정을 백업하고 새 ZIP을 기존 폴더에 덮어 푼다. DLL과 Python 소스를 함께 업데이트하고 게임을 재시작한다. 서로 다른 정책 버전이 섞이면 시즌 작업을 보류한다.
  • 새 설치는 Protected 자동 실행이 기본이다. 기존 설정은 덮어쓰지 않으며, 기존 season_goal=collection에도 5성 우선 수집과 전 어종 완료 후 반복 제작이 적용된다.
  • Pause는 진행 중인 교배의 지연 재고 확인도 멈출 수 있다. 요청이 남아 있으면 결과 확인 후 종료하는 방법을 따른다. 미확정 요청 기록을 삭제하거나 같은 요청을 다시 보내지 않는다.

설치 명령과 경로 설정, 제거·복원 순서는 0.5.0 설치 안내를 따른다.

주요 변경

  • 5성 확보 우선: 해파리 2성 한 마리만 있어도 3 → 4 → 5성 제작에 사용한다. 5성이 완성되면 보존하고 부족한 4·3·2·1성을 채운 뒤 다음 희귀도의 어종으로 이동한다.
  • 재료 부족 시 목표 유지: 현재 목표를 위한 부족 재료 확보에 교배·합성을 집중한다. 후순위 어종의 수집 재료도 일반 합성에서 보호한다.
  • 비시즌 비축: 다음 시즌 레시피는 사전에 알 수 없는 것으로 취급한다. 모든 일반 어종의 1~5성을 각각 15·12·9·6·3마리 비축하며, 보유량·필요량·부족량을 어종·별 등급별로 계산한다. 이 수량은 레시피 간 일반 재료 어종이 겹치지 않는다는 계획 전제다.
  • 일반 합성 제한: 필요한 재료 확보에 도움이 되는 교배 0회 개체를 기본으로 사용한다. 각 어종·별 등급 재고가 비축 기준의 3배에 도달하면 보호 밖 초과분을 허용하되, 같은 희귀도·같은 별 등급으로 묶고 0회 개체부터 소비한다. 필요한 재료와 교배 부모를 남긴다.
  • 계획과 실행 검사 일치: 게임에서 전체 어종 목록·비축·부모 보호·합성 후보를 계산하고 Python 판단 및 소비 직전 네이티브 검사에 연결한다. Economic은 시즌 정책을 끈 상태의 교배 후 합성 탐색을 유지하면서 합성 시점의 0회 조건을 확인한다.

사용자 잠금·수동 예약·시세 보호와 결과 불명 요청의 재전송 방지는 유지한다. 자동 판매·구매·출품은 제공하지 않는다. 상세 수량과 제작 순서는 시즌·비축 정책, 설정은 자동화 안내에 있다.

검증과 범위

  • Python 전체 195개 테스트 통과, C# 실행 보호 816개 검사 통과. 리뷰 수정 후 Python 전체와 계약 비교를 재실행했고, 변경되지 않은 C# 검사 결과는 입력 해시를 확인해 재사용했다.
  • 실제 게임 interop 참조로 병합 커밋의 Release 빌드: 경고 0개·오류 0개.
  • 현재 재고를 포함한 10개 상황에서 네이티브 계획 → Python 판단 → 네이티브 실행 검사 113건 일치. 비시즌과 수집 완료 후 반복은 오프라인 상황으로 검사했다.
  • 격리된 환경에서 설치 거부 조건, 첫 설치, 업데이트, 설정 보존과 기록 범위 내 제거 확인.
  • ZIP 111개 파일의 매니페스트 해시·소스 커밋·DLL 일치와 게임 파일·개인 기록 제외 확인. 압축 해제본을 새 Python 가상환경에 설치하고 네 가지 계획기 예제와 의존성 검사 통과.
  • 실제 게임의 기존 0.4.32를 정상 종료하고 0.5.0으로 업데이트했다. 재시작 전후 물고기 58마리의 종류·등급·남은 교배 횟수·잠금 상태 일치, 서버 재고 재확인, 새 계획기 연결, 해파리 5성 집중과 어종·별 등급별 비축 185행 적용을 확인했다. 기존 자동화 설정도 복원했다.
  • 새 정책으로 자동 선택한 첫 교배의 결과가 서버 재고에 반영된 것을 확인했다. 교배 결과는 일반 1성이었으며, 목표 재료 획득을 보장한다는 의미는 아니다. 실제 시즌 제작과 과잉 재고 합성은 이번 짧은 실사용 확인에서 관찰하지 않았다.

Protected는 희귀도 예측만 사용하며 정확한 어종·별 등급 확률을 가정하지 않는다. Economic의 정확한 재료 기대값에는 검증된 공동 결과 모델이 필요하다. 실제 시즌 5성 완성이나 전 어종 수집 완료까지의 장기 진행을 검증한 것은 아니다. 코드 서명은 제공하지 않으며, 게임 업데이트로 검증한 게임 DLL 해시가 달라지면 새 호환 버전이 필요하다.

소스 커밋: daa809a874e3ce107dc8cd0f460e9c8f11801d54 · PR #4

문제가 있으면 GitHub Issues에 버전·오류 메시지·재현 순서를 남긴다. 업데이트 전 백업한 소스·DLL·설정으로 되돌릴 수 있지만, 서버에 반영된 게임 진행은 코드 복원으로 취소되지 않는다.