소개
BepInEx는 Unity 모딩을 위한 범용 프레임 워크입니다.
BepInEx에는 툴과 라이브러리가 포함되어 있습니다.
- 게임 시작 시 커스텀 코드 (이하 플러그인)를 게임에 로드합니다.
- 원본 게임 파일을 건드리지 않고 게임 내 메서드, 클래스 및 전체 어셈블리를 패치합니다.
- 플러그인을 구성하고 콘솔 또는 파일과 같은 원하는 출력에 게임을 기록합니다.
- 플러그인 종속성을 관리합니다.
BepInEx는 현재 GitHub에서 Unity를 위한 가장 인기 있는 모딩 도구 중 하나입니다.
다운로드
이 팩의 컨텐츠
이 팩은 미리 구성되며 발하임 모딩에 사용할 수 있습니다.
특히, 기본 BepInEx 릴리스의 변경 사항은 다음과 같습니다.
- 콘솔을 활성화한 사전 구성된 BepInEx.cfg를 추가했습니다.
- 현재 버전의 게임에 대해 unstripped Unity + Mono BCL DLL을 추가했습니다.
- 게임 DLL을 덮어쓰지 않고도 unstripped DLL을 로드할 수 있도록 Doorstop 구성 및 BepInEx를 업데이트했습니다.
- Linux 컴퓨터에서 게임과 전용 서버를 모두 실행하는 데 필요한 스크립트를 추가했습니다.
설치 순서
수동으로 설치하는 경우 다음의 절차를 따르십시오.
1. 해당 모드를 다운로드하고 임의의 폴더에 압축 해제하십시오.
게임 폴더에 압축을 풀지 마십시오.
2. BepInExPack_Valheim 폴더 아래의 파일을 아래 폴더에 이동 또는 복사합니다.
[스팀 설치 경로]\steamapps\common\Valheim\
3. 올바르게 설치했는지 확인하십시오.
올바르게 완료되면 폴더는 다음과 같이 보입니다.
4. 아래의 Windows 또는 Linux game의 환경 설정 실행 지침을 따르십시오.
환경설정
Windows 경우
추가 구성을 할 필요가 없습니다. 게임을 실행하기만 하면 됩니다. 모든 것이 정확하면 콘솔 팝업이 표시됩니다.
Linux, game 경우
1. 아래 명령어를 사용하여 start_game_bepinex.sh를 실행 가능하게 만드십시오.
chmod u+x start_game_bepinex.sh
2. Steam에서 게임 속성으로 이동하여 게임의 런치 인수(arguments)를 다음과 같이 설정합니다.
./start_game_bepinex.sh %command%
고급 사용자를 위한 참고 사항: ./start_game_bepinex.sh를 스크립트의 전체 경로로 변경할 수 있습니다. 이렇게 하면이 팩을 게임 폴더 외부에 완전히 설치할 수 있습니다.
3. Steam을 통해 게임을 실행합니다.
이 순간 BepInEx가 작동하는지 명확한 표시를 볼 수 없습니다.
BepInEx.Utility의 MessageCenter와 같은 간단한 플러그인을 설치하여 테스트하는 것이 좋습니다.
Linux, server 경우
이 가이드는 여러분이 Linux 작업에 대한 충분한 지식이 있다고 가정합니다.
그렇지 않은 경우 ValheimPlus를 대신 사용하여 즉시 지원되는 서버 호스트를 사용하는 것이 좋습니다.
- chmod u+x start_server_bepinex.sh를 사용하여 start_server_bepinex.sh를 실행 가능하게 만드십시오.
- start_server_bepinex.sh를 편집하여 Valheim의 자체 시작 스크립트를 사용하는 것처럼 시작 파라미터를 변경합니다.
- start_server_bepinex.sh를 실행하여 서버를 시작하십시오.
올바르게 완료되면 터미널에 BepInEx 부트스트랩 메시지가 표시됩니다.
BepInEx 버전 및 로드 상태 확인
게임에 BepInEx가 성공적으로 로드되면, 메인 메뉴의 왼쪽 상단에 BepInEx 버전 정보가 표시됩니다.
변경 로그
5.4.800
- BepInEx 5.4.8로 업데이트
- Valheim.DisplayBepInExInfo 플러그인 추가
5.4.701
- 설치 방법 예제의 스크린 샷 업데이트
5.4.700
- BepInEx 5.4.7로 업데이트
5.4.603
- BepInEx 5.4.6을 최신 빌드로 업데이트했습니다.
- BepInEx 콘솔을 활성화 또는 비활성화하는 --enable-console true | false 커맨드 라인 옵션 추가
- config의 dllSearchPathOverride 옵션과 동일한 방식으로 작동하도록 --doorstop-dll-search-override 커맨드 라인 옵션을 추가했습니다.
5.4.602
- BepInEx 5.4.6을 최신 빌드로 업데이트했습니다.
- 기본적으로 Unity 로그를 LogOutput.log에 작성하도록 config 업데이트
- Linux에서 게임을 실행하기 위해 사전 구성된 스크립트 및 파일 추가
5.4.601
- Unity 2019.4.20 용 unstripped DLL 업데이트
5.4.600
- README 조정
- 버전 간 변경을 고려하여 버전 관리를 조정했습니다.
5.4.6
- BepInEx 5.4.6을 사용한 최초 발행