🎛️Arguments and Properties

Learn about startup arguments and system properties.

The start arguments and system properties are values appended to the used in Plazma execution, which have a overall impact on the operation of Plazma.

According to the start argument and system properties divided by the position added to the command (#user-content-fn-2).

---

System properties

System properties inputted before -jar are processed in the JVM before Plazma initialization.

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

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

Usage

System properties are inputted as Java command arguments between java and -jar.

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

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

-D indicates that the argument is an exclusive argument added to Plazma, not embedded in the JVM,

If no value is entered for the property, the value is fixed to .

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

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

Complete System Properties

convertLegacySigns

• Type: Boolean

• Default: False

Updates deprecated sign formats.

debug.entities

• Type: Boolean

• Default: False

Enables debug logs related to entity information.

debug.rewriteForIDE

• Type: Boolean

• Default: False

Disables NMS revision in IDE to correctly load debug information, and automatically remaps internal version information.

disable.watchdog

• Type: Boolean

• Default: False

Disables Spigot's Watchdog warning system.

letMeReload

• Type: Boolean

• Default: False

Disables confirmation message for the /reload command.

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

If you are a plugin developer and need to update a plugin, use hotswapping instead of /reload.

io.papermc.paper.suppress.sout.nags

• Type: Boolean

• Default: False

Disables plugins using standard input/output system.

net.kyori.adventure.text.warnWhenLegacyFormattingDetected

• Type: Boolean

• Default: False

Warns when deprecated formatting is detected in chat components.

Paper.bypassHostCheck

• Type: Boolean

• Default: False

Disables server pattern matching verification when players connect to the server.

Paper.debugDynamicMissingKeys

• Type: Boolean

• Default: False

Enables debug logs for missing keys in NBT objects.

Paper.debugInvalidSkullProfiles

• Type: Boolean

• Default: False

Enables debug logs for skull blocks with invalid profile information.

Logs all invalid skull blocks in the world with their locations.

Paper.disableChannelLimit

• Type: Boolean

• Default: False

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

Paper.disableClassPrioritization

• Type: Boolean

• Default: False

Disables plugin class prioritization system.

Useful when issues arise in plugin shading.

Paper.disableFlushConsolidate

• Type: Boolean

• Default: False

Disables Netty flush consolidation system.

Paper.excessiveTELimit

• 형태: Integer

• Default: 750

Splits entities into multiple packets if they exceed the set value.

Paper.filterThreshold

• 형태: Integer

• Default: 8192

Sets the maximum packet size the server can receive at once.

Paper.ignoreJavaVersion

• Type: Boolean

• Default: False

Disables Java version verification.

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

Files and overall game mechanics can be permanently damaged, causing the game to break.

Any issues caused by this are the user's responsibility, and Plamza does not provide any support for it.

Paper.maxCustomChannelName

• 형태: Integer

• Default: 64

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

Paper.maxSignLength

• 형태: Integer

• Default: 80

Sets the maximum length of characters that can be entered on one line of a sign.

Paper.minPrecachedDatafixVersion

• 형태: Integer

• Default: (world version) + 1

Sets the version of initial world update information to be initialized.

Useful when updating a large number of chunks, but otherwise not used.

Paper.parseYamlCommentsByDefault

• Type: Boolean

• Default: True

Enables processing of comments in YAML files.

Paper.playerConnection.keepAlive

• 형태: Integer

• Default: 30

Kicks players if no data is received from them for the entered value (in seconds).

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

Paper.skipServerPropertiesComments

• Type: Boolean

• Default: False

Ignores comments in server properties.

Paper.debug-sync-loads

• Type: Boolean

• Default: False

Enables debug logs for synchronous chunk loading.

Paper.enable-sync-chunk-writes

• Type: Boolean

• Default: False

Enables Minecraft's .

This proceeds to save each chunk in order, causing significant performance degradation.

Paper.explicit-flush

• Type: Boolean

• Default: False

Enables Explicit Flushing for network channels.

Paper.strict-thread-checks

• Type: Boolean

• Default: False

Always logs errors not occurring on the main thread.

Paper.tickList-warn-on-excessive-delay

• Type: Boolean

• Default: False

Outputs a warning if scheduled tasks have excessive wait time.

Paperclip.patchOnly

• Type: Boolean

• Default: False

When using the default provided executable, only applies patches without starting the server.

Plazma.aggressiveOptimize

• Type: Boolean

• Default: false

• Conflict: Plazma.disableConfigOptimization

Optimizes the initial configuration more strongly.

Enabling this makes the server faster and safer, but it can have a significant impact on gameplay.

Plazma.disableConfigOptimization

• Type: Boolean

• Default: false

• Conflict: Plazma.aggressiveOptimize

Does not optimize the initial configuration.

This uses the default configuration of Paper.

Plazma.iKnowWhatIAmDoing

• Type: Boolean

• Default: false

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

Plazma.useVanillaFavicon

• Type: Boolean

• Default: false

Disables Plazma branding and uses the vanilla default server favicon.

Plazma.useVanillaConfiguration

• Type: Boolean

• Default: false

• Conflict: Plazma.disableConfigOptimization

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

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

This can significantly impact server safety and performance.

Any issues resulting from using this attribute are the responsibility of the server administrator.

Provides the default values provided by Mojang for the initial configuration.

This disables all vulnerability patches applied by Paper.

Vulnerability patches can be re-enabled in Paper configuration or Plazma configuration.

Plazma.vanillaize

• Type: Boolean

• Default: true

• Conflict: Plazma.aggressiveOptimize

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

Sets the initial configuration closer to vanilla.

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

Obsolete attribute

The following system attribute is obsolete.

timings.bypassMax

• Type: Boolean

• Default: false

• Deprecated: Since Timings was completely removed from Plazma

Determines whether exceeding the maximum value that can be sent to Aikar's Timings API is allowed.

Even if done so, rate limiting will be applied if not handled in the API.

---

Start Argument

The start argument is entered after -jar *.jar to initialize Plazma and is processed together.

Usage

System attributes are entered as program command arguments after -jar *.jar.

For example, if you want to apply the nogui start argument, enter as follows to have Plazma process the nogui argument during initialization.

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

Full Start Argument

bukkit-settings

• Alias: b

• Default: bukkit.yml

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

command-settings

• Alias: c

• Default: commands.yml

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

config

• Alias: c

• Default: server.properties

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

demo

Starts the server in demo world.

eraseCache

Removes remaining cache files after world upgrade.

forceUpgrade

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

help

• Alias: ?

Outputs all start arguments and descriptions of Plazma.

initSettings

Creates configuration files only and shuts down the server.

jfrProfile

Enables JFR profiling.

max-players

• Alias: s, size

• Default: (server properties)

허용되는 최대 플레이어 수를 설정합니다.

nogui

Disables the graphical interface panel.

nojline

Disables JLine and uses vanilla console.

online-mode

• Alias: o

• Default: (server properties)

Selects whether to verify players with Mojang authentication server.

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

paper-settings

• Alias: paper

• Default: paper.yml

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

Sets the location of the deprecated PaperSpigot configuration file.

Used to transfer existing configurations to a new configuration file, and is no longer used afterwards.

paper-settings-directory

• Alias: paper-dir

• Default: config

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

plazma-settings-directory

• Alias: plazma-dir

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

plugins

• Alias: p

• Default: plugins

Sets the location of the plugins folder.

pufferfish-settings

• Alias: pufferfish

• Default: pufferfish.yml

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

purpur-settings

• Alias: purpur

• Default: purpur.yml

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

safeMode

Starts the server in a completely vanilla state (safe mode).

server-ip

• Alias: h, host

• Default: (server properties)

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

server-port

• Alias: p, port

• Default: (server properties)

Sets the port of the server.

server-name

• Default: A Plazma Server

Sets the name of the server.

spigot-settings

• Alias: S

• Default: spigot.yml

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

version

• Alias: v

Outputs the Plazma version.

world-dir

• Alias: W, universe, world-container

• Default: (server folder)

Sets the location where world files are stored.

world-name

• Alias: w, world

• Default: (server properties)

Sets the name of the world file.

---