플러그인 설정 및 게임 월드 모듈

계속하기 전에 "모드 참조" 개념에 대해 이야기해야 합니다. 이것은 자주 언급될 것입니다.

모드 참조는 본질적으로 '모드의 고유한 이름’입니다. 이 모드 참조는 클래스 이름, 파일 이름, 폴더 이름 및 여러 다른 곳에서 사용됩니다. 모드를 새티스팩토리 모드 저장소에 업로드할 때, 거기에서 모드 참조를 제공해야 합니다.

언리얼 플러그인(모드라고도 함)은 모드 참조를 이름으로 사용해야 하며, 작성하는 모든 C‍+‍+ 모듈은 모드 참조를 이름으로 하는 소스 폴더에 있어야 합니다.

모드 참조에는 언더스코어(_)를 제외한 특수 문자가 포함될 수 없으며(예: +, #, ., ß, …​), 공백도 마찬가지입니다.

모드의 최종 사용자는 모드의 표시 이름(공백 및 특수 문자를 포함할 수 있음)을 보게 되며, 모드 폴더, 로그 메시지 및 파일 경로의 경우는 예외입니다.

파스칼케이스 명명 규칙을 따르는 것을 강력히 권장합니다. 즉, 모드 참조의 각 '단어’는 대문자로 시작하고 나머지는 소문자입니다.

다음은 몇 가지 가능한 모드 이름과 제안된 모드 참조의 예입니다.

SML3.0부터 모드는 이제 언리얼 플러그인이며, 로드는 언리얼 자체에서 처리됩니다.

알파킷에는 새티스팩토리 모드를 위한 플러그인 파일을 생성하는 데 도움이 되는 마법사가 포함되어 있습니다. 알파킷 개발 패널을 아직 열지 않았다면, 여기의 지침을 따르십시오.

모드 생성 마법사를 열려면 알파킷 개발 패널에서 모드 생성 버튼을 클릭하십시오.

커뮤니티에서 생성한 모드 템플릿이 여기에 나타납니다. 블루프린트만 템플릿을 선택하십시오.

마법사는 또한 모드 이름을 입력하라는 메시지를 표시합니다. 플러그인의 이름은 반드시 모드의 모드 참조여야 합니다. 이 문서 예제에서는 DocMod 를 모드 참조로 사용하겠습니다. 자신의 모드를 시작할 때는 이와 다른 모드 참조로 새로운 플러그인을 생성해야 합니다.

선택적으로 "디스크립터 데이터" 섹션을 작성하거나 나중에 편집할 수 있도록 비워둘 수 있습니다.

"콘텐츠 디렉터리 표시"를 체크한 상태로 두고 모드 생성 을 누르십시오.

이제 플러그인을 생성했으므로, 모든 것이 호출되고 등록되는 시작점을 만들어야 합니다. 참조할 수 있는 지점이 없으면 게임은 우리의 모드 콘텐츠를 로드할 수 없습니다!

우리의 경우, 시작점은 게임 월드 모듈이지만, 이는 항상 필요한 것은 아닙니다. 게임 월드 모듈은 새로운 도면을 정의할 수 있도록 해주는 새티스팩토리 모드 로더에서 정의된 도우미입니다. 이 도면을 통해 아이템, 제작법 등을 정의할 수 있습니다.

모드의 콘텐츠 폴더 내에서, 빈 공간을 마우스 오른쪽 버튼으로 클릭하고 블루프린트 클래스 를 선택하여 기본 애셋을 생성합니다. 일반 섹션 옆의 삼각형을 눌러 닫고, 모든 클래스 섹션 옆의 삼각형을 눌러 확장합니다. 검색 상자에 GameWorldModule 을 입력하고 나타나면 선택하고 파란색 선택 버튼을 눌러 블루프린트를 생성합니다.

이름을 RootGameWorld_여기에모드참조입력 으로 지정하십시오. Root 접두사는 자체적으로 아무런 기능을 하지 않지만, 나중에 더 많은 게임 월드 모듈을 추가할 경우 식별하는 데 도움이 됩니다. 모드 참조를 포함한 이름을 부여함으로써, 충돌 로그에서 식별하기가 더 쉬워지고 에디터에서 서로 다른 모듈을 구별하는 데 도움이 됩니다.

이 모듈을 사용하여 제작법 및 기타 콘텐츠를 등록할 수 있습니다.

다음으로, 모듈을 두 번 클릭하여 블루프린트 설정을 엽니다.

SML이 자동으로 모듈을 감지하고 로드하도록 하려면, Root Module 세부 정보 필드에서 이를 루트 모듈로 표시해야 합니다.

루트 모듈에 대해 더 알고 싶다면, 모듈 시스템 페이지에서 확인할 수 있습니다.

이제 첫 번째 모드 애셋을 생성했으므로, 이를 '컴파일’하고 저장해야 합니다. 언리얼 엔진 블루프린트에서 '컴파일’은 오류를 확인하고 나중에 패키징할 파일을 준비하는 데이터 검증 단계입니다.

에디터는 다양한 지표를 통해 애셋이 저장되지 않았음을 알려줍니다:

컴파일 및 저장하는 일반적인 방법은 애셋 에디터 패널의 왼쪽 상단에 있는 '컴파일' 버튼을 클릭하는 것입니다. 또 다른 방법은 F7 키를 눌러 동일한 버튼을 누르는 것입니다.

파일을 컴파일하고 저장하지 않으면, 다음 번에 모드를 패키징하고 시도할 때 수정한 내용이 모드에 포함되지 않습니다. 이것은 문제를 해결하는 데 매우 혼란스러울 수 있습니다!

또한, 에디터가 저장하기 전에 충돌하면 모든 변경 사항을 잃게 됩니다. 컴퓨터 작업을 할 때 자주 듣는 말은 "일찍 저장하고 자주 저장하라"입니다.

이 규칙의 예외는 에디터에서 기본 게임 애셋 자리 표시자를 검사하는 경우입니다. 애셋을 열면 다른 자리 표시자가 누락된 것으로 감지되어 저장되지 않은 것으로 표시될 수 있습니다. 예를 들어, FactoryGame 애셋에서 BP_Explorer 를 열면 변경하지 않아도 저장되지 않은 것으로 표시됩니다. 이 자리 표시자 파일에 대한 변경 사항을 저장할 필요는 없습니다. 이 파일의 값을 수정한 후 실수로 저장하면, 나중에 잘못된 값을 저장하여 혼란을 초래할 수 있습니다.

모드가 예상대로 작동하는지 확인하기 위해, 게임에서 사용할 수 있도록 모드를 패키징해 보겠습니다.

패키징하기 전에 파일 > 저장할 파일 선택…​ 을 통해 저장되지 않은 파일이 있는지 빠르게 확인할 수 있습니다. 아래와 같은 대화 상자가 나타납니다. '선택 저장’을 클릭하여 이전에 놓친 파일을 저장하십시오.

아직 실제 콘텐츠를 추가하지 않았으므로, 모드는 실제로 아무것도 하지 않을 것입니다. 그러나 메인 메뉴의 로드된 모드 목록에 나타날 것입니다. 이것은 설정 과정에서 발생할 수 있는 문제를 잡을 수 있는 좋은 기회입니다. 이 문제는 나중에 발생할 수 있지만, 그 원인을 파악하기가 덜 명확할 것입니다. 지금 문제를 잡으면, 그 문제는 우리가 이 시점까지 수행한 작업으로 인해 발생했음을 알 수 있습니다. 조기에 테스트하고 자주 테스트하여 버그를 더 빨리 잡으십시오!

모드를 패키징하려면 알파킷을 실행하십시오. 사용 방법에 대한 정보는 프로젝트 설정 페이지에서 찾을 수 있습니다.

패키징 프로세스를 시작한 후, 원하는 경우 "알파킷 로그 표시" 텍스트를 클릭하여 알파킷 전용 로그 창을 열 수 있습니다. 이 정보는 UE 출력 로그에도 존재하지만, 다른 에디터 메시지와 혼합되어 있습니다.

알파킷이 완료되면 게임을 실행하십시오. 알파킷을 통해 게임을 실행하도록 설정하지 않았다면 말입니다. 모드는 아래 스크린샷에 표시된 메인 메뉴의 모드 목록에 나타나야 합니다.

이것이 올바르게 작동하더라도, 아래의 문제 해결 섹션을 반드시 읽어보십시오. 나중에 발생할 수 있는 오류를 처리하는 방법을 확인할 수 있습니다.

아래에는 이 시점에서 또는 나중에 모드 개발 중에 발생할 수 있는 오류에 대한 정보가 있습니다.

다음으로, 제작법과 도면을 생성하여 게임에서 새로운 생산 제작법을 잠금 해제하고 활용하는 방법을 알아보겠습니다.

이 단계에 대한 문서 페이지를 찾는 방법에 대한 복습이 필요하다면, 시작하기 섹션 헤더를 확인하십시오.