수다위키

이 문서는 읽기 전용입니다. 원본을 볼 수는 있지만 바꿀 수는 없습니다. 문제가 있다고 생각하면 관리자에게 문의하세요.
====== 프리즘런처 (Prism Launcher) 포터블 버전 안내 ======

새벽야생 마인크래프트 서버에 접속하기 위한 프리즘런처 포터블 버전의 설치 및 실행 방법을 안내합니다. 본 런처는 수다가 새벽야생 서버 환경에 맞추어 사전 구성한 포터블 패키지로, 별도의 설치 과정 없이 압축 해제 후 즉시 사용할 수 있습니다.

  * **런처 버전**: Prism Launcher 10.0.5
  * **마인크래프트 버전**: 1.21.11 (Fabric)
  * **Java 버전**: Adoptium Eclipse Temurin 21

----

===== 1. 화면 구성 안내 =====

프리즘런처는 크게 두 가지 화면으로 구성됩니다. 각 화면의 역할과 명칭을 먼저 숙지하면 이후 설정 과정을 이해하는 데 도움이 됩니다.

==== 1.1. 런처 화면 (메인 화면) ====

프리즘런처를 실행하면 가장 먼저 표시되는 화면입니다. 마인크래프트 인스턴스의 관리, 실행, 계정 전환 등 전반적인 작업을 수행하는 주 화면입니다.

{{ ::pl_04_launcher_main.png?nolink&600 |}}

  * **상단 도구 모음**: ''인스턴스 추가(E)'', ''폴더(O)'', ''설정(N)'', ''도움말'', ''업데이트(U)'' 버튼이 위치합니다.
  * **계정 표시 영역**: 우측 상단에 현재 로그인된 Microsoft 계정 이름이 표시됩니다.
  * **인스턴스 목록**: 중앙 영역에 생성된 마인크래프트 인스턴스가 아이콘과 함께 표시됩니다. 포터블 버전에는 ''1.21.11-Release'' 인스턴스가 사전 구성되어 있습니다.
  * **우측 패널**: 선택된 인스턴스에 대한 ''실행(L)'', ''강제 종료(K)'', ''편집(E)'', ''그룹 변경(C)'', ''폴더(F)'' 등의 기능 버튼이 나열됩니다.
  * **하단 상태 표시줄**: 마인크래프트 버전 정보와 총 플레이 시간이 표시됩니다.

==== 1.2. 콘솔 창 (편집 화면) ====

인스턴스의 세부 설정 및 로그 확인을 위한 화면입니다. 런처 화면에서 인스턴스를 선택한 후 우측 패널의 **편집(E)** 버튼을 클릭하면 열립니다.

{{ ::pl_05_launcher_edit.png?nolink&600 |{{:프리즘런처:pl_05_launcher_edit.png?direct&300|편집 버튼 위치}}

콘솔 창은 좌측에 다음과 같은 탭 메뉴를 가지고 있습니다.

{{ ::pl_06_console_overview.png?nolink&600 |{{:프리즘런처:pl_06_console_overview.png?direct&600|}}

  * **마인크래프트 로그**: 게임 실행 시 출력되는 로그 메시지를 실시간으로 확인할 수 있습니다.
  * **버전**: 인스턴스에 적용된 마인크래프트 및 모드 로더 버전 정보를 표시합니다.
  * **모드**: 설치된 모드 목록을 확인하고 활성화/비활성화 및 업데이트를 관리합니다.
  * **리소스 팩 / 셰이더 팩**: 텍스처 및 셰이더 관련 팩을 관리합니다.
  * **세계**: 저장된 월드 데이터를 관리합니다.
  * **서버**: 서버 목록을 관리합니다.
  * **설정**: 인스턴스별 게임 창 크기, 콘솔 표시 옵션, Java 경로 및 메모리 할당 등을 설정합니다.

콘솔 창 하단에는 **실행(L)**, **강제 종료(K)**, **닫기** 버튼이 위치합니다.

----

===== 2. 다운로드 및 압축 해제 =====

수다가 배포한 프리즘런처 포터블 파일을 다운로드한 후 원하는 위치에 압축을 해제합니다.

{{ ::pl_01_zip_folder.png?nolink&600 |{{:프리즘런처:pl_01_zip_folder.png?direct&600|}}

  - 배포된 **''PrismLauncher-10.0.5-1.21.11.zip''** 파일을 다운로드합니다.
  - 원하는 경로에 압축을 해제합니다. (예: ''D:\수다SUDA\dev\'')
  - 압축 해제된 **''PrismLauncher-10.0.5-1.21.11''** 폴더 내부의 **''prismlauncher.exe''**를 실행합니다.

<WRAP important>
포터블 버전이므로 별도의 설치 과정이 필요 없습니다. 압축 해제 후 exe 파일을 바로 실행하면 됩니다.
</WRAP>

----

===== 3. 최초 실행 및 Microsoft 계정 로그인 =====

프리즘런처를 처음 실행하면 Microsoft 계정 로그인 화면이 표시됩니다.

{{ ::pl_03_ms_account.png?nolink&600 |{{:프리즘런처:pl_03_ms_account.png?direct&400|}}

  - **''Microsoft 계정 추가''** 버튼을 클릭합니다.
  - 웹 브라우저가 열리면 마인크래프트를 구매한 Microsoft 계정으로 로그인합니다.
  - 인증이 완료되면 **''마침(F)''** 버튼을 클릭하여 설정을 완료합니다.

로그인이 완료되면 런처 메인 화면이 표시되며, 우측 상단에 로그인된 계정 이름이 나타납니다.

----

===== 4. Java 설정 확인 =====

포터블 버전에는 Java가 사전 포함되어 있으나, 최초 실행 시 Java 경로가 올바르게 설정되어 있는지 확인이 필요할 수 있습니다.

==== 4.1. Java 설정 화면 진입 ====

  - 런처 메인 화면에서 **''1.21.11-Release''** 인스턴스를 선택합니다.
  - 우측 패널의 **편집(E)** 버튼을 클릭하여 콘솔 창을 엽니다.
  - 좌측 탭 메뉴에서 **설정**을 클릭합니다.
  - 상단의 **Java** 탭을 선택합니다.

{{ ::pl_08_console_settings_java.png?nolink&600 |{{:프리즘런처:pl_08_console_settings_java.png?direct&600|}}

==== 4.2. Java 경로 확인 ====

**Java 실행 파일(E)** 항목에 Java 경로가 표시됩니다. 포터블 버전의 경우 런처 폴더 내부에 포함된 Java 경로가 설정되어 있어야 합니다.

정상적인 경로 예시:

''(...)/PrismLauncher-10.0.5-1.21.11/java/eclipse_temurin_jre21.0.10-7/bin/javaw.exe''

{{ ::pl_13_java_path_updated.png?nolink&600 |{{:프리즘런처:pl_13_java_path_updated.png?direct&600|}}

==== 4.3. Java가 설정되어 있지 않은 경우 ====

만약 Java 경로가 비어 있거나 올바르지 않은 경우, 아래 절차에 따라 Java를 다운로드하고 설정합니다.

  - Java 설정 화면에서 **''Java 다운로더 열기(D)''** 버튼을 클릭합니다.
  - Java 설치 창이 열리면 좌측에서 **Adoptium**을 선택하고, **Java 21** 목록에서 최신 버전을 선택한 후 **''다운로드''** 버튼을 클릭합니다.

{{ ::pl_10_java_install.png?nolink&600 |{{:프리즘런처:pl_10_java_install.png?direct&600|}}

  - 다운로드가 완료되면 Java 버전 선택 창이 표시됩니다. 포터블 런처 폴더 내부 경로(''PrismLauncher-10.0.5-1.21.11/java/...'')에 해당하는 항목을 선택하고 **''확인''**을 클릭합니다.

{{ ::pl_12_java_version_select.png?nolink&600 |{{:프리즘런처:pl_12_java_version_select.png?direct&600|}}

==== 4.4. 메모리 설정 ====

Java 탭 하단의 **메모리(Y)** 항목에서 마인크래프트에 할당할 메모리 용량을 설정할 수 있습니다.

  * **최소 메모리 사용량(-Xms)**: 4096 MiB (권장)
  * **최대 메모리 사용량(-Xmx)**: 4096 MiB (권장)

<WRAP tip>
포터블 버전에는 최소/최대 메모리가 4096 MiB(4GB)로 사전 설정되어 있습니다. PC 사양에 따라 조절할 수 있으나, 모드 구동을 위해 최소 4GB 이상을 권장합니다.
</WRAP>

----

===== 5. 게임 실행 =====

모든 설정이 완료되면 마인크래프트를 실행할 수 있습니다.

  - 런처 메인 화면에서 **''1.21.11-Release''** 인스턴스를 **더블 클릭**하거나, 우측 패널의 **실행(L)** 버튼을 클릭합니다.
  - 최초 실행 시 Mojang 서버에서 게임 에셋 파일을 다운로드합니다. 인터넷 환경에 따라 수 분이 소요될 수 있습니다.

{{ ::pl_14_asset_download.png?nolink&600 |{{:프리즘런처:pl_14_asset_download.png?direct&400|}}

  - 다운로드가 완료되면 마인크래프트가 자동으로 실행됩니다.
  - 게임이 실행되는 동안 런처 화면에는 계정 이름 옆에 **''(계정 이용 중)''**이 표시됩니다.

{{ ::pl_15_game_running.png?nolink&600 |{{:프리즘런처:pl_15_game_running.png?direct&600|}}

콘솔 창의 **마인크래프트 로그** 탭에서 게임의 실행 상태와 모드 로딩 과정을 실시간으로 확인할 수 있습니다.

{{ ::pl_16_console_log.png?nolink&600 |{{:프리즘런처:pl_16_console_log.png?direct&600|}}

----

===== 6. 모드 관리 =====

포터블 버전에는 새벽야생 서버에 필요한 모드가 사전 설치되어 있습니다. 모드 목록 확인 및 업데이트 방법은 다음과 같습니다.

==== 6.1. 설치된 모드 확인 ====

콘솔 창 좌측 탭 메뉴에서 **모드**를 클릭하면 현재 설치된 모드 목록이 표시됩니다.

{{ ::pl_17_mod_list.png?nolink&600 |{{:프리즘런처:pl_17_mod_list.png?direct&600|}}

각 모드의 이름, 버전, 제작일 등의 정보를 확인할 수 있습니다.

==== 6.2. 모드 업데이트 ====

모드의 새 버전이 출시된 경우, 콘솔 창의 모드 탭 우측 상단에 있는 **''모드 업데이트''** 버튼을 클릭하여 업데이트할 수 있습니다.

{{ ::pl_19_mod_update_dialog.png?nolink&600 |{{:프리즘런처:pl_19_mod_update_dialog.png?direct&600|}}

업데이트 가능한 모드가 있으면 변경 사항 목록이 표시됩니다. 내용을 확인한 후 **''확인''** 버튼을 클릭하면 자동으로 업데이트가 진행됩니다.

<WRAP important>
모드를 임의로 추가하거나 삭제하면 서버 접속에 문제가 발생할 수 있습니다. 모드 변경이 필요한 경우 수다에게 문의하여 주시기 바랍니다.
</WRAP>

----

===== 7. 새벽야생 서버 접속 =====

마인크래프트가 정상적으로 실행되면 다음 절차에 따라 새벽야생 서버에 접속합니다.

  - 마인크래프트 메인 메뉴에서 **멀티플레이**를 선택합니다.
  - 서버 목록에 새벽야생 서버가 사전 등록되어 있습니다. 해당 서버를 선택하고 **접속**을 클릭합니다.

<WRAP tip>
서버가 목록에 없는 경우 **서버 추가**를 선택하여 서버 주소를 직접 입력할 수 있습니다. 서버 주소는 수다에게 문의하여 주시기 바랍니다.
</WRAP>

----

===== 8. 문제 해결 =====

^  증상  ^  해결 방법  ^
| 런처 실행 시 Java 오류 발생 | 콘솔 창 > 설정 > Java 탭에서 Java 경로가 올바른지 확인합니다. 경로가 비어 있으면 **4.3절**의 절차에 따라 Java를 다운로드합니다. |
| 게임 실행 후 즉시 종료 | 메모리 설정이 4096 MiB 이상인지 확인합니다. PC의 RAM이 8GB 미만인 경우 최대 메모리를 2048~3072 MiB로 조절합니다. |
| 서버 접속 불가 | 마인크래프트 버전이 1.21.11인지 확인합니다. 모드를 임의로 변경하지 않았는지 확인합니다. |
| 로그인 오류 | 런처 상단의 계정 이름을 클릭하여 계정을 재인증합니다. |

문제가 지속되는 경우 콘솔 창의 **마인크래프트 로그** 내용을 복사하여 수다에게 전달하면 원인 파악에 도움이 됩니다.