Valheim Mod Manager

발하임 모드 매니저

개요

Thunderstore.io에서 Valheim용 모드를 관리하는 간단한 명령줄 애플리케이션입니다.

• 테스트를 위해 로컬에 설치된 모드를 관리합니다.
• 플레이어를 위한 ZIP 내보내기 제공
• 게시 시 모드를 서버에 자동으로 배포합니다.

Valheim 모드 관리자 데모 비디오

요구사항

(핍 포함)

pip3 install packaging python-magic paramiko

(네이티브 패키지 포함)

sudo apt install python3-packaging python3-magic python3-paramiko

Python3 및 [packaging, python-magic, paramiko] 패키지. Python 3.11을 사용하여 Ubuntu 22.04 및 Debian 12에서 테스트되었습니다.

구성

config.yml.DEFAULT config.yml 에 복사하고 필요에 따라 조정합니다.

디버그

디버그 출력에 대해 디버그 플래그를 true 로 설정합니다.

게임디르

로컬 Valheim 설치 위치로 설정

수출 접두어

내보낼 파일 이름을 설정합니다. 서버 이름이나 의미 있는 이름을 추가하는 데 유용합니다.

수출 디렉토리

번들 모드를 내보내고 정보를 변경하는 디렉터리입니다. 사용자를 위한 자동 배포를 위해 Nextcloud에서 관리하는 디렉터리로 자유롭게 설정하세요!

업데이트일

"업데이트된" 패키지의 일수를 설정합니다. '14'로 설정하면 "업데이트된" 패키지 내보내기에서 지난 14일 동안 업데이트된 모든 플러그인이 내보내집니다.

sftp_호스트

내보내는 동안 "서버" 플러그인을 자동으로 배포하려면 IP 또는 호스트 이름으로 설정하세요. 비어 있으면 이 논리를 건너뜁니다.

sftp_user

SSH를 통해 연결할 사용자 이름(키 기반 인증만 해당)

sftp_경로

발하임이 설치된 전용 서버의 경로(자동 배포용)

override_server

서버 배포를 강제하기 위한 쉼표로 구분된 플러그인 목록 일반적으로 "서버" 태그가 표시된 모드만 배포되지만 때로는 모드 개발자가 이를 포함하지 않는 경우도 있습니다.

사용

./cli.py 실행하여 대화형 스크립트를 실행합니다.

Valheim Mod Manager

1: List Mods Installed
2: Install New Mod
3: Check For Updates
4: Uninstall Mod
5: Revert Modifications
6: Export/Package Mods
Q: Quit Application

Enter 1-6:

이 스크립트를 사용하기 위한 일반적인 작업 흐름: 스크립트를 실행하여 현재 게임 모드를 관리자에 로드합니다. 모드가 어떤 작성자를 사용해야 하는지 선택해야 할 수도 있습니다(일부 모드는 다른 작성자가 게시하지만 이름은 동일함).

1. 설치된 모드 목록

설치된 모드 목록을 나열하는 것은 자명합니다. 여기에는 현재 설치한 모드와 버전이 나열됩니다.

2. 새로 설치

모드 이름이나 Thunderstore URL을 검색하여 새 모드를 설치할 수 있습니다. 설치할 버전에 대한 옵션이 표시됩니다(기본값은 최신 버전). 종속성은 자동으로 처리됩니다.

3. 업데이트 확인

로드한 후에는 Check For Updates 통해 로컬 모드를 업데이트할 수 있습니다. 이를 통해 설치된 모든 모드를 신속하게 업데이트할 수 있습니다.

4. 모드 제거

Mod 제거는 Uninstall Mod 통해 수행되지만 사용자 내보내기 패키지의 경우 업데이트 시 해당 모드를 수동으로 제거해야 하므로 제거되는 모드를 사용자에게 알리는 것이 중요합니다. (ZIP 파일은 안타깝게도 "이 디렉터리 삭제" 옵션을 지원하지 않습니다.)

모드가 설치, 제거 또는 업데이트되면 로컬 게임 클라이언트가 자동으로 업데이트됩니다. 이를 통해 배포 전에 모드를 테스트할 수 있습니다. (이것이 중요합니다! 일부 모드는 게임/캐릭터를 손상시킬 수 있습니다!) 오작동하는 모드의 경우 Revert Modifications 통해 되돌릴 수 있습니다. 이렇게 하면 모드가 원래 배포 상태로 롤백됩니다(완전히 제거되거나 특정 버전으로 재설정됨).

마지막으로 Export/Package Mods 사용자를 위한 다양한 파일을 생성합니다. 전체 내보내기에는 모든 모드와 BepInEx, 지난(기본적으로) 14일 동안 업데이트된 모드만 포함된 업데이트 zip, 모든 변경 사항을 포함하여 게시할 수 있는 CHANGELOG, 현재 설치된 모든 모드와 해당 모드가 포함된 MODS 파일이 포함됩니다. 버전.

서버 모드

Server-side 플래그로 태그가 지정된 모드의 경우 개인 서버에 배포하기 위해 .cache/server 에도 복사됩니다.

sftp_ 옵션이 구성되면 라이브러리는 새 번들을 출시할 때 이러한 모드를 게임 서버에 자동으로 업로드합니다.

수동 배포의 경우 준비가 되면 이러한 파일을 게임 서버에 복사하기만 하면 됩니다.

기술 노트

이 애플리케이션은 파일 캐싱을 많이 사용합니다. Thunderstore.io의 전체 패키지 목록은 기본적으로 한 시간에 한 번만 다운로드되며 모드 패키지는 .cache/packages 에 저장되므로 동일한 패키지를 반복적으로 설치할 때 사이트에서 다시 다운로드할 필요가 없습니다.