🎛️인수와 속성

시작 인수와 시스템 속성에 대해 알아보세요.

시작 인수와 시스템 속성은 Plazma 실행에 에 덧붙이는 값으로, Plazma의 작동에 전반적인 영향을 줍니다.

에 따라 시작 인수시스템 속성으로 나뉘게 됩니다.


시스템 속성

시스템 속성은 -jar 앞에 입력되어 Plazma가 초기화 되기 전 JVM에서 처리되는 값입니다.

시스템 속성을 수정하면 Plazma 및 JVM의 작동 방식이 변경될 수 있으며, 게임에 큰 영향을 미칠 수 있습니다!

각 시스템 속성이 어떠한 역할을 하는지 확실히 알지 못하는 경우, 절대 사용하지 마세요!

사용 방법

시스템 속성은 java-jar 사이에 Java 명령 인수로써 입력됩니다.

예를 들어, Plazma.dummyProperty 시스템 속성을 적용하려 하는 경우, 다음과 같이 입력하면 다음 속성에 37이 입력되어 Plazma가 초기화 됩니다.

java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar (...)

-D는 해당 인수가 JVM에 내장되지 않고 Plazma에 추가된 전용 인수임을 나타내며,

속성에 아무런 값도 입력하지 않으면 값이 됩니다.

Paperweight 계열 서버 플랫폼은 각 플랫폼마다 시스템 속성을 구분하기 위하여 속성 이름에 .을 포함하고 있습니다.

Windows Powershell 등 일부 터미널에서는 이러한 인수를 허용하지 않을 수 있으므로, 인수 양 끝에 " 합니다.

전체 시스템 속성

convertLegacySigns

  • 형태: Boolean

  • 기본값: False

사용 중지된 표지판 포맷을 업데이트 합니다.

debug.entities

  • 형태: Boolean

  • 기본값: False

엔티티 정보 관련 디버그 로그를 활성화 합니다.

debug.rewriteForIDE

  • 형태: Boolean

  • 기본값: False

IDE에서 디버그 정보를 올바르게 불러올 수 있도록 NMS 리비전을 비활성화 하고, 내부 버전 정보를 자동으로 리맵합니다.

disable.watchdog

  • 형태: Boolean

  • 기본값: False

Spigot의 Watchdog 경고 시스템을 비활성화 합니다.

letMeReload

  • 형태: Boolean

  • 기본값: False

/reload 명령어의 재확인 메세지를 비활성화 합니다.

/reload 명령어는 매우 불안정하므로, /reload 사용 이후 발생하는 서버 내 모든 문제는 사용자 본인에게 있습니다.

플러그인 개발자이고 플러그인을 업데이트 해야 하는 경우, /reload 대신 핫스왑을 사용하세요.

io.papermc.paper.suppress.sout.nags

  • 형태: Boolean

  • 기본값: False

표준 입출력 체계를 사용하는 플러그인을 비활성화 합니다.

net.kyori.adventure.text.warnWhenLegacyFormattingDetected

  • 형태: Boolean

  • 기본값: False

채팅 컴포넌트에서 사용 중단된 포맷이 감지되면 경고합니다.

Paper.bypassHostCheck

  • 형태: Boolean

  • 기본값: False

플레이어가 서버에 접속할 때 서버의 패턴 일치 검증을 비활성화 합니다.

Paper.debugDynamicMissingKeys

  • 형태: Boolean

  • 기본값: False

NBT 오브젝트에서 누락된 키에 대한 디버그 로그를 활성화 합니다.

Paper.debugInvalidSkullProfiles

  • 형태: Boolean

  • 기본값: False

잘못된 프로필 정보를 가진 머리 블록의 디버그 로그를 활성화 합니다.

이는 월드 내 모든 잘못된 머리 블록을 위치와 함께 로그합니다.

Paper.disableChannelLimit

  • 형태: Boolean

  • 기본값: False

플레이어당 적용되는 128개의 플러그인 의 개수 제한을 비활성화 합니다.

Paper.disableClassPrioritization

  • 형태: Boolean

  • 기본값: False

플러그인 클래스 우선 순위 체계를 비활성화 합니다.

플러그인 셰이드에서 문제가 발생한 경우 유용합니다.

Paper.disableFlushConsolidate

  • 형태: Boolean

  • 기본값: False

Netty flush consolidation 체계를 비활성화 합니다.

Paper.excessiveTELimit

  • 형태: Integer

  • 기본값: 750

엔티티가 설정된 값보다 많으면 다중 패킷으로 분할하여 전송합니다.

Paper.filterThreshold

  • 형태: Integer

  • 기본값: 8192

서버가 한 번에 받을 수 있는 최대 패킷의 크기를 설정합니다.

Paper.ignoreJavaVersion

  • 형태: Boolean

  • 기본값: False

Java 버전 확인을 비활성화 합니다.

이렇게 하면 JVM이 존재하지 않는 코드에 접근하려 시도할 수 있습니다!

월드 등 전반적인 파일이 영구적으로 손상될 수 있으며, 게임의 전체 메커니즘이 망가지게 됩니다.

이를 사용하여 발생한 모든 문제는 본인이 책임지며, Plamza는 이에 대한 아무런 지원을 하지 않습니다.

Paper.maxCustomChannelName

  • 형태: Integer

  • 기본값: 64

플러그인 이름의 제한을 설정합니다.

Paper.maxSignLength

  • 형태: Integer

  • 기본값: 80

표지판의 한 줄에 입력 가능한 글자의 최대 길이를 설정합니다.

Paper.minPrecachedDatafixVersion

  • 형태: Integer

  • 기본값: (월드 버전) + 1

먼저 초기화할 월드 업데이트 정보의 버전을 설정합니다.

대량의 청크를 업데이트 해야 하는 경우 유용하지만, 그 외에 경우 사용되지 않습니다.

Paper.parseYamlCommentsByDefault

  • 형태: Boolean

  • 기본값: True

YAML 파일의 주석의 처리를 활성화 합니다.

Paper.playerConnection.keepAlive

  • 형태: Integer

  • 기본값: 30

플레이어에게서 입력된 값(초) 만큼 아무런 데이터도 전송 받지 못했을 때, 플레이어를 추방합니다.

일반적인 경우, 은 서버로 계속해서 를 전송하므로, 게임이 응답하지 않는 경우 게임이 충돌한 것으로 간주하고 더 이상 서버에서도 플레이어를 처리하지 않고 추방합니다.

Paper.skipServerPropertiesComments

  • 형태: Boolean

  • 기본값: False

서버 속성의 주석을 무시합니다.

Paper.debug-sync-loads

  • 형태: Boolean

  • 기본값: False

동기 청크 작성의 디버그 로그를 활성화 합니다.

Paper.enable-sync-chunk-writes

  • 형태: Boolean

  • 기본값: False

Minecraft의 을 활성화 합니다.

이는 각 청크를 저장하는 것을 순서대로 진행하므로, 굉장한 성능 저하를 유발합니다.

Paper.explicit-flush

  • 형태: Boolean

  • 기본값: False

네트워크 채널의 Explicit Flushing을 활성화 합니다.

Paper.strict-thread-checks

  • 형태: Boolean

  • 기본값: False

메인 스레드에서 발생하지 않은 오류를 항상 로그합니다.

Paper.tickList-warn-on-excessive-delay

  • 형태: Boolean

  • 기본값: False

예약된 작업이 과도한 대기 시간을 가질 경우 경고를 출력합니다.

Paperclip.patchOnly

  • 형태: Boolean

  • 기본값: False

기본 제공되는 실행 파일을 사용하는 경우, 서버를 시작하지 않고 패치만 적용합니다.

Plazma.aggressiveOptimize

  • 형태: Boolean

  • 기본값: false

  • 충돌: Plazma.disableConfigOptimization

초기 구성을 더 강하게 최적화 합니다.

활성화 하면 서버가 더욱 빨라지고 안전해지지만, 게임 플레이에 큰 영향을 줄 수 있습니다.

Plazma.disableConfigOptimization

  • 형태: Boolean

  • 기본값: false

  • 충돌: Plazma.aggressiveOptimize

초기 구성을 최적화하지 않습니다.

이는 Paper의 기본 구성을 사용하도록 합니다.

Plazma.iKnowWhatIAmDoing

  • 형태: Boolean

  • 기본값: false

Plazma가 초기화될 때 출력되는 을 억제합니다.

Plazma.useVanillaFavicon

  • 형태: Boolean

  • 기본값: false

Plazma 브랜딩을 비활성화 하고 바닐라 기본 서버 패비콘을 사용하도록 합니다.

Plazma.useVanillaConfiguration

  • 형태: Boolean

  • 기본값: false

  • 충돌: Plazma.disableConfigOptimization

해당 속성은 아직 개발중입니다.

해당 속성은 패치된 모든 취약점을 되돌립니다!

이는 서버 안전 및 성능에 크게 영향을 줄 수 있습니다.

해당 속성을 사용하여 발생하는 모든 문제는 서버 관리자에게 있습니다.

초기 구성을 Mojang에서 제공하는 기본값으로 제공합니다.

이는 Paper에서 적용한 모든 취약점 패치를 비활성화 합니다.

취약점 패치는 Paper 구성 또는 Plazma 구성에서 다시 활성화 할 수 있습니다.

Plazma.vanillaize

  • 형태: Boolean

  • 기본값: true

  • 충돌: Plazma.aggressiveOptimize

해당 속성은 아직 개발중입니다.

초기 구성을 바닐라에 가깝게 설정합니다.

이는 기본적으로 서버 성능 및 안전에 영향을 주지 않을 정도로만 적용되며, Plazma.disableConfigOptimization 속성을 사용할 경우 바닐라 기본값을 사용하도록 구성합니다.

사용 중단된 속성

아래 시스템 속성은 사용이 중단된 속성입니다.

timings.bypassMax

  • 형태: Boolean

  • 기본값: false

  • 사용 중단됨: Timings가 Plazma에서 전면 제거된 후 부터

Aikar의 Timings API에 전송될 수 있는 값의 최대를 초과해도 되는지 결정합니다.

이렇게 하더라도 API에서 예외 처리되지 않으면 레이트 제한이 적용됩니다.


시작 인수

시작 인수는 -jar *.jar 뒤에 입력되어 Plazma가 초기화되며 함께 처리되는 값입니다.

사용 방법

시스템 속성은 -jar *.jar 뒤에 프로그램 명령 인수로써 입력됩니다.

예를 들어, nogui 시작 인수를 적용하려 하는 경우, 다음과 같이 입력하면 Plazma가 초기화 중에 nogui 인수를 처리하게 됩니다.

java -Xms4G (...) -DPlazma.dummyProperty=37 -jar plazma.jar nogui (...)

전체 시작 인수

bukkit-settings

  • 별칭: b

  • 기본값: bukkit.yml

Bukkit 구성 파일의 이름 및 위치를 설정합니다.

command-settings

  • 별칭: c

  • 기본값: commands.yml

Bukkit 명령어 구성 파일의 이름 및 위치를 설정합니다.

config

  • 별칭: c

  • 기본값: server.properties

서버 속성 파일의 이름 및 위치를 설정합니다.

demo

데모 월드로 서버를 시작합니다.

eraseCache

월드 업그레이드 후 남은 캐시 파일을 제거합니다.

forceUpgrade

버전을 무시하고 월드를 강제로 합니다.

help

  • 별칭: ?

Plazma의 전체 시작 인수와 설명을 출력합니다.

initSettings

구성 파일만 생성하고 서버를 종료합니다.

jfrProfile

JFR 프로필링을 활성화 합니다.

max-players

  • 별칭: s, size

  • 기본값: (서버 속성)

허용되는 최대 수를 설정합니다.

nogui

그래픽 인터페이스 패널을 비활성화 합니다.

nojline

JLine을 비활성화 하고 바닐라 콘솔을 사용합니다.

online-mode

  • 별칭: o

  • 기본값: (서버 속성)

Mojang 인증 서버로 플레이어를 검증할지 선택합니다.

Velocity 등 프록시를 사용하는 것이 아닌 경우 EULA 위반으로 제재될 수 있습니다.

paper-settings

  • 별칭: paper

  • 기본값: paper.yml

이 인수는 1.19.4 이후 사용이 중지되었습니다

사용 중지된 PaperSpigot 구성 파일의 위치를 설정합니다.

이는 기존 구성을 새 구성 파일로 이전하기 위해 사용되며, 그 이후에는 사용되지 않습니다.

paper-settings-directory

  • 별칭: paper-dir

  • 기본값: config

Paper 구성 파일이 위치하는 폴더의 이름 및 위치를 설정합니다.

plazma-settings-directory

  • 별칭: plazma-dir

Plazma 구성 파일이 위치하는 폴더의 이름 및 위치를 설정합니다.

plugins

  • 별칭: p

  • 기본값: plugins

플러그인 폴더의 위치를 설정합니다.

pufferfish-settings

  • 별칭: pufferfish

  • 기본값: pufferfish.yml

Pufferfish 구성 파일의 이름 및 위치를 설정합니다.

purpur-settings

  • 별칭: purpur

  • 기본값: purpur.yml

Purpur 구성 파일의 이름 및 위치를 설정합니다.

safeMode

(안전 모드) 완전한 바닐라 상태로 서버를 시작합니다.

server-ip

  • 별칭: h, host

  • 기본값: (서버 속성)

서버의 호스트 이름 또는 주소를 설정합니다.

server-port

  • 별칭: p, port

  • 기본값: (서버 속성)

서버의 포트를 설정합니다.

server-name

  • 기본값: A Plazma Server

서버의 이름을 설정합니다.

spigot-settings

  • 별칭: S

  • 기본값: spigot.yml

Spigot 구성 파일의 이름 및 위치를 설정합니다.

version

  • 별칭: v

Plazma 버전을 출력합니다.

world-dir

  • 별칭: W, universe, world-container

  • 기본값: (서버 폴더)

월드 파일이 저장되는 위치를 설정합니다.

world-name

  • 별칭: w, world

  • 기본값: (서버 속성)

월드 파일의 이름을 설정합니다.


Last updated