++0. 발단.

++본인은 게임을 하면서 명상이 너무 마음에 안 들었음.

개고생해서 에헤카틀의 다키마쿠라를 얻었는데, 내 새끼가 자꾸 노숙을 해버렸기 때문임.

텐트를 경량화해서 들고 다니는 로갤러들도, 명상 돌리다가 갑자기 기절해버린 경험이 있을 것이라고 생각함.

이 시스템이 존나 악질인게, 명상을 하는 도중에 "졸음" 상태가 되어버리면 손쓸 방도가 없이 캐릭이 잠들어버림.

그리고 거지 같은 컨디션으로 일어난 걸 보고 허탈함을 느끼기를 수십번, 본인은 그냥 모딩을 해서 시스템을 직접 뜯어고치자는 발상을 하게 됨.

이 글은 본인이 해당 기능을 구현하기 위해 어떤 시행 착오를 거쳤는지, 어떻게 구현했는지를 정리한다.

프로그래밍 내용이 대부분이라 간단하게 C# 강의라도 보는 것을 추천함. 본인도 잘 모르지만 그냥 깡으로 했음.

크게 도움은 안 될 것 같지만, 엘린 모딩하는 사람도 너무 없고 이 미약한 경험이 도움이 되기를 바람.

참고로 개발 도중에 BetterSleep이라는 모드가 있단 걸 알게되어, 이 모드를 많이 참고 했음.

나도 역량이 모자란지라 지적 및 피드백 대환영임. 

+1. 개발 환경 설정.

Windows11에서 개발한다고 전제한다. MacOS에서는 그냥 포기하고 가상 머신을 돌리는 것을 추천한다. 본인은 일단 도저히 할 수가 없었음.

원활하게 모딩을 하기 위해서는 꽤 많은 준비물이 필요하다.

-0. Elin 게임 파일.

-1. 코드 편집을 위해서 Visual Studio 혹은 Rider를 사용한다.+

-2. 빌드를 위해서 최신 버전의 .net SDK가 필요하다.

-3. 엘린의 원본 소스를 확인하기 위해서 디컴파일러 dnSpy나 dotpeek이 필요하다.

-4. 엘린 내부의 유니티 요소들을 확인하고 추적하기 위해 Unity Explorer가 필요하다.

이 글에서는 내가 Visual Studio를 사용했으므로 Visual Studio를 기준으로 작성함. 

-Visual Studio

https://visualstudio.microsoft.com/ko/downloads/

먼저 Visual Studio 같은 경우에는 마이크로소프트 들어가서 다운 받으면 된다.

그리고 인스톨러를 실행하면 이런 화면이 뜰 텐데, 위와 같이 체크한다.

Unity 개발툴을 빼먹을 수도 있을텐데 괜찮다. 나중에 깔면 됨 ㅇㅇ...

- .net SDK

https://dotnet.microsoft.com/ko-kr/download/visual-studio-sdks

Visual Studio용 .NET SDK

Visual Studio용 .NET SDK 찾아보기 주 다운로드 페이지를 방문하여 Linux 및 macOS를 포함한 모든 .NET 다운로드를 확인하세요.

dotnet.microsoft.com

.net SDK도 마이크로소프트꺼다.

그냥 시원하게 최신 버전 깔아주자. 하위호환 잘 된다.

-디컴파일러

https://www.jetbrains.com/ko-kr/decompiler/

디컴파일러는 dotpeek을 사용한다. 

dnSpy를 사용해도 무방하지만, 얘는 멋대로 원본 코드를 수정하는 일이 좀 있어서 보기 불편할 때가 있었음.

-Unity Explorer

https://github.com/sinai-dev/UnityExplorer/releases/tag/4.9.0

여기서 unityexplorer.bepinex6.mono.zip 을 받아주자.

엘린이 사용하고 있는 BepInEx의 버전이 6.0.0.0이므로 6버전을 받는다.

이 녀석을 이용해서 게임 내부의 요소 값들을 확인하고 수정할 수 있다.

다운받은 파일을 Elin 게임 폴더 내부의 BepInEx/plugins 경로에 복붙한다.

이렇게 말이다. 

여기까지 했다면 이제 개발 준비는 완료가 되었다. 그 이전에 모드가 어떻게 돌아가는지에 대해서 조금 살펴보자.

2. 모딩 개요.

+

https://gall.dcinside.com/mgallery/board/view/?id=dyson_sphere_program&no=4481

DSP 모딩 가이드 - 기초 1 (23.03.18) - 다이슨스피어프로그램 마이너 갤러리

하꼬 게임이 다 그렇듯이 정보가 원체 없어서 아마 뭘 해보고 싶어도 머가리 들이박다 포기하는 사람들 있을텐데모딩에 관심 있는 사람들을 위해서 모드 작동원리 + 개발 방법에 대해서 간단히 정리하고자 함.1. 뭘 알아야

gall.dcinside.com

+한 갤러가 모드의 작동 원리에 대해서 정리한 글이다.

모딩의 핵심은 BepInEx와 Harmony이다.

BepInEx는 Elin에 붙어서 우리가 만든 코드를 실행해주는 녀석이다.

Harmony는 게임 코드를 직접적으로 수정하는데 사용하는 라이브러리이다. BepInEx에서 자체적으로 HarmonyX라고 개조해서 사용하고 있다. 그래도 큰 차이는 없다.

요약하자면

0. 게임 코드를 뜯어서 구조를 파악한다.

1. C# 에서 Harmony 라이브러리를 이용해서 코드를 작성한 뒤 빌드한다. (dll이 나옴.)

2. 그걸 BepInEx가 실행시킨다.

라는 원리이다.

2.1. Harmony

모딩을 위해서 필수적인 녀석이다. Harmony를 사용할 때, Patch한다는 표현을 사용한다.

이 때 Patch의 유형은 크게 Prefix, Postfix, Transpiler로 나뉜다.

Prefix는 메소드 실행시 앞부분을 가로채고, Postfix는 뒷부분을 가로채서 제 입맛대로 바꿔줄 수 있다.

Transpiler는 C# 코드가 실행 전에 IL 코드란 녀석으로 바뀌는데, IL 코드를 수정하는 식으로 작동한다. 얘는 코드의 대부분을 수정하는 것이 가능하다.

이렇게 보면 엥 Transpiler가 짱이 아닌가요? 싶지만, 빡고수가 아니면 안 쓰는 게 정신 건강에 이롭다. 그 이유는 나중에 직접 몸으로 느껴보자.

아무튼 우리는 메소드를 앞 뒤로 패치할 수 있음을 알게 되었다.

이걸 어케 쓸 수 있을지 이제부터 알아보자.

3. 게임 요소 찾기.

엘린을 키고, Unity Explorer가 잘 작동하는지 확인해보자. 위와 같이 뭔가가 뜬다면 성공이다.

우리의 목표는 이것이다.

"명상 시 수면을 발생시키는 코드를 찾고 수정하기."

드가자~

+일단 Unity Explorer를 키고, Inspector를 들어간다.

그러면 위와 같이 드롭다운이 있는데, UI를 클릭한 뒤, 명상 아이콘을 클릭해보자.

+

위와 같은 모습을 볼 수 있을 것이다. 클릭한 부분이 이렇게 많은 유니티 요소들이 존재한다.

우리가 원하는 건 오른클릭을 했을 때에 실행되는 명상 기능이다. 이 중에서 어떤 것이 명상 기능을 실행시키는 것과 관련이 있을까?

일단 Viewport를 클릭해보자.

그러면 위와 같은 창이 뜬다. 

보아하니 위쪽은 현재 게임 오브젝트 Viewport의 위치 속성 같다. 그리고 ActiveSelf 같은 버튼이 있다.

Children은 이 오브젝트가 지닌 하위 오브젝트들 처럼 보인다. 토글 버튼을 눌러보면 화면 상에서 뭔가가 나타나거나, 사라지는 것을 발견할 수 있다.

이걸 이용해서 명상 버튼의 오브젝트를 찾아보자.

ActiveSelf를 체크 해제한다.

+

그랬더니 내 어빌리티가 전부 사라졌다.

그렇다. Viewport는 어빌리티 창의 안쪽에서 아이콘들을 담고 있는 오브젝트인 것이다.

Unity는 게임 오브젝트들이 계층적으로 관계를 맺고 있다. 그렇다면 Viewport 안에 명상 버튼을 의미하는 오브젝트가 존재한다는 뜻이다.

그 다음 Children에 있는 토글 버튼 들을 체크 해제하면서 어떤 녀석이 사라지는지 한 번 확인해보자.

눌렀을 때에 명상 버튼이 사라진다면, 그 오브젝트의 하위에 명상 버튼이 있다는 뜻이니, 천천히 용의자를 좁혀보자.

+

그런 식으로 용의자를 좁히다 보면, 위와 같은 오브젝트를 발견할 수 있다.

하위요소가 더 없어서 이젠 더 타고 들어갈 수가 없다. 거기에 ButtonAbility라는 컴포넌트를 지니고 있다.

유니티 공식 문서는 "컴포넌트(Components) 는 게임에서 오브젝트와 동작에 관한 기본 구성 요소라 할 수 있습니다."라고 설명한다.

그 오브젝트의 기능이 컴포넌트에 담겨있다는 뜻이다. 그렇다면 ButtonAbility라는 컴포넌트가 어케 돼있는지 확인해보자.

+굉장히 많은 값들을 포함하고 있는 것을 알 수 있다.

하지만 버튼은 일반적으로 OnClick 이벤트를 포함하는 게 국룰이다.

그러면 그 이벤트를 찾으면 되겠지?

찾았다. Action이라는 객체가 할당되어있다. 저 객체는 무엇일까 살펴보기 위해서 Inspect를 눌러본다.

뭔가 많다. Delegate로 인해서 코드가 실행되는 것 같은데, 이 이상은 파고 들기가 어렵다.

다시 ButtonAbility로 돌아와서 재미있는 메소드를 발견했다.

ButtonAbility.Use(); 메소드를 Evaluate 해보면 명상이 시작된다!

이렇게 우리는 명상이 실행되는 메소드인 ButtonAbility.Use();를 찾아냈다.

그렇다면 이제 코드를 볼 시간이다.

(* 코드 관련해서는 말이 너무 길어지기 때문에 다음 편에서...)